카카오 모먼트 Open API 변동 문의 - 전남광주통합특별시 관련

mz.targetpick · 7월 22, 2026, 5:04오전

안녕하세요.

'전남광주통합특별시’신설에 따른 모먼트 타겟팅 및 Open API 변동 사항 안내

위 공지사항 관련하여 궁금한 내용이 있어 문의 남깁니다.

광고그룹 행정구역 타겟팅 설정 시

(구)·(신) 행정구역을 모두 선택하여 타겟팅 설정이 필요

하다고 기제되어 있는데 기존에 광주광역시만 선택하여 이미 생성된 광고그룹 같은 경우,

광고그룹 조회 API 호출 시 응답이 ‘전남광주통합특별시’인 ‘R’도 같이 응답을 주시는것인지 아니면 기존 ‘광주광역시’ 인 ‘E’ 코드만 응답되는 것인지 문의드립니다.

보고서(리포트 데이터) API를 호출하는 경우에도, 디멘전 LOCATION 값을 넘기는 경우에 (구)E와 (신)R의 성과 데이터가 동일한 값으로 응답하는 걸까요?

광고그룹 생성/수정시 변경 포인트에 대한 내용 중

위 이미지에서 설명주신것 처럼 locationType을 ALL로 설정한 경우 ‘R’ 포함이 필요하다고 되어있는데,

AERA인 경우에만 상세 지역 데이터를 전달할 수 있었던 기존 API 내용과 다르게

ALL로 요청하는 경우에도 별도의 하위 데이터인 locations에 “R”을 포함시켜야 하는 것인지 문의드립니다.

추가로 (구)(신) 행정구역코드를 모두 포함되어야 한다고 기제되어있는데,

기존 광주광역시 코드인 E로 시작되는 코드와 신규로 생성될 R로 시작하는 코드 정보를 28일 이전에 미리 알수가 없어, 코드가 시군구/동읍면 레벨에서 어떻게 매칭되는지 확인할 수 없습니다.
요청에 같은 지역을 의미하는 코드를 어떻게 포함할 수 있는지 모르겠습니다.

예) 광주광역시 광산구 송정2동 타겟팅 선택시

구 : E13003602
신 : R……………

API 변경일이 28일로 빠르게 업데이트 되는 만큼
가능한 빠른 확인 및 답변 부탁드립니다.

panini · 7월 23, 2026, 5:54오전

@mz.targetpick

안녕하세요.
카카오 관리자입니다.
문의주신 내용관련 답변드립니다.

1번

1)광고그룹 조회 API
[답변] 7월 28일 이전에 생성된 국내 전체 타겟팅 설정된 광고그룹의 경우, 광고그룹 조회 API 호출 시 전남광주통합특별시’인 ‘R’ 은 포함되어 응답되지 않습니다. 기존 ‘광주광역시’ 인 ‘E’ 코드만 응답에 포함되어있습니다. 다만 해당 광고그룹을 다시 수정하여 저장할 경우 신규 ‘R’코드를 포함하여야만 국내전체 타겟으로 저장이 가능합니다.

2) 보고서(리포트 데이터) API
[답변] (구)E와 (신)R의 성과 데이터는 동일한 값으로 응답되지 않습니다. 하나의 유저는 E/L/R 중 단일 지역코드로만 분류되어 각 코드의 성과가 서로 겹치지 않으므로, 중복 집계는 발생하지 않습니다. 과도기 동안에는 E, L, R 세 개 코드가 모두 존재할 수 있으며, 시간이 지남에 따라 신규 지역(R) 비중이 늘고 기존 코드(E/L) 비중은 점차 감소합니다. 구 행정구역 코드 삭제 예정 시점인 2027년 1월 이후에는 R 코드만 존재하게 됩니다.

2.광고그룹 생성/수정 API관련
[답변] 말씀주신 기존 문서에 오류가 있었습니다. 7월 28일 문서가 수정 업데이트될 예정입니다.
locationType : 국내전체(ALL) 선택 시 locations(시/도) 전체 코드값(A,B…)과 알수없음(U)을 요청에 포함해야 하는것이 정상동작입니다.

3.신규 행정코드 제공 시점 관련
[답변] 신규 행정코드를 확인할 수 있는 문서는 7월 24일 금요일 선업데이트 예정인것으로 안내드립니다. 24일 URL 경로로 확인부탁드립니다.

감사합니다.

mz.targetpick · 7월 23, 2026, 7:22오전

답변 감사합니다.
내용 확인하였으며, 추가문의사항 전달드립니다.

1번

1)광고그룹 조회 API
[답변] 7월 28일 이전에 생성된 국내 전체 타겟팅 설정된 광고그룹의 경우, 광고그룹 조회 API 호출 시 전남광주통합특별시’인 ‘R’ 은 포함되어 응답되지 않습니다. 기존 ‘광주광역시’ 인 ‘E’ 코드만 응답에 포함되어있습니다. 다만 해당 광고그룹을 다시 수정하여 저장할 경우 신규 ‘R’코드를 포함하여야만 국내전체 타겟으로 저장이 가능합니다.

[질문] 7월 28일 이전에 생성된 광고 그룹 중 ‘국내 전체 타겟팅 설정’ 된 광고 그룹이 아니라, ‘광주광역시(E)’ 혹은 '전라남도(L)'만 설정하였던 대상들도 API 변경후에 동일하게 '전남광주통합특별시’인 ‘R’ 코드를 응답하지 않는것이 맞는지,

E+L 코드 타겟팅 설정을 한 광고그룹 전체 대상들은 28일 API가 변경되는 시점에 R코드를 포함하여 수동으로 수정을 해야하는 것인지 궁금합니다.

또한 28일 이전에 광주광역시(E)만 타겟팅으로 설정하여 생성된 광고 그룹은, 28일 이후에 별도로 수동 수정을 진행하지 않는 한 전남광주통합특별시(R)에 대한 성과는 집계가 안되는 것이 맞을까요?

2) 보고서(리포트 데이터) API
[답변] (구)E와 (신)R의 성과 데이터는 동일한 값으로 응답되지 않습니다. 하나의 유저는 E/L/R 중 단일 지역코드로만 분류되어 각 코드의 성과가 서로 겹치지 않으므로, 중복 집계는 발생하지 않습니다. 과도기 동안에는 E, L, R 세 개 코드가 모두 존재할 수 있으며, 시간이 지남에 따라 신규 지역(R) 비중이 늘고 기존 코드(E/L) 비중은 점차 감소합니다. 구 행정구역 코드 삭제 예정 시점인 2027년 1월 이후에는 R 코드만 존재하게 됩니다.

[질문] 과도기 동안에 E, L, R 세 개 코드가 모두 존재할 수 있다고 말씀하셨는데, 28일 API 변경이 이루어지고 난 후 세개 코드가 모두 타겟팅 설정되어 있는 광고 그룹의 경우 동일한 날짜의 성과 데이터 조회 시 광주광역시(E) + 전라남도(L)의 성과데이터 합이 전남광주통합특별시(R) 성과와 동일한 값을 의미하게 될까요?

2.광고그룹 생성/수정 API관련
[답변] 말씀주신 기존 문서에 오류가 있었습니다. 7월 28일 문서가 수정 업데이트될 예정입니다.
locationType : 국내전체(ALL) 선택 시 locations(시/도) 전체 코드값(A,B…)과 알수없음(U)을 요청에 포함해야 하는것이 정상동작입니다.

[질문] 질문 없습니다. 확인 감사합니다.

3.신규 행정코드 제공 시점 관련
[답변] 신규 행정코드를 확인할 수 있는 문서는 7월 24일 금요일 선업데이트 예정인것으로 안내드립니다. 24일 URL 경로로 확인부탁드립니다.

[질문]

위 공지사항에 작성해주신 내용에 따르면 (구)/(신) 행정구역코드를 모두 요청에 포함되어야 한다고 되어있습니다.
그럼 예로 ‘광주광역시 광산구 송정2동’ 타겟팅을 원하는 경우에

구 : E13003602
신 : R……………

으로 시작하는 두 코드를 모두 같이 포함하여야만 정확한 타겟팅 설정이 되는것이 맞는걸까요?
혹 (구)나 (신) 하나만 선택하여 타겟팅 하는 경우 영향범위가 어떻게 되는지 궁금합니다.

[기타] 전남광주통합특별시’신설에 따른 모먼트 타겟팅 및 Open API 변동 사항 안내 공지사항 내에 행정코드 제공 날짜가 7월 28일에 업데이트 된다고 표기되어 있어서 수정 부탁드립니다.

panini · 7월 24, 2026, 4:57오전

@mz.targetpick

안녕하세요.
카카오 관리자입니다.
추가 문의주신 내용에 대해 답변 드립니다.

1. 광고그룹 조회 API
[질문] 7월 28일 이전에 생성된 광고 그룹 중 ‘국내 전체 타겟팅 설정’ 된 광고 그룹이 아니라, ‘광주광역시(E)’ 혹은 '전라남도(L)'만 설정하였던 대상들도 API 변경후에 동일하게 '전남광주통합특별시’인 ‘R’ 코드를 응답하지 않는것이 맞는지,
E+L 코드 타겟팅 설정을 한 광고그룹 전체 대상들은 28일 API가 변경되는 시점에 R코드를 포함하여 수동으로 수정을 해야하는 것인지 궁금합니다.

[답변] 7월 28일 이전 광주광역시(E), 또는 전라남도(L)를 타겟팅 설정하여 생성한 광고그룹의 경우, 광고그룹 조회 시 신규 코드인 R을 포함하여 응답하지 않습니다. 신규 전남광주통합특별시(R)을 추가로 타겟팅 설정에 포함하고자 한다면, 28일 API 업데이트 이후 (R)코드를 포함하여 광고그룹을 수정요청을 진행해주세요.

[질문] 또한 28일 이전에 광주광역시(E)만 타겟팅으로 설정하여 생성된 광고 그룹은, 28일 이후에 별도로 수동 수정을 진행하지 않는 한 전남광주통합특별시(R)에 대한 성과는 집계가 안되는 것이 맞을까요?

[답변] 광주광역시(E)만 타겟팅으로 설정하여 생성된 광고 그룹은 유저 추정 지역 정보가 광주광역시(E)인 유저들에게만 노출되어, 해당 성과만 집계됩니다.

2. 보고서 API
[질문] 과도기 동안에 E, L, R 세 개 코드가 모두 존재할 수 있다고 말씀하셨는데, 28일 API 변경이 이루어지고 난 후 세개 코드가 모두 타겟팅 설정되어 있는 광고 그룹의 경우 동일한 날짜의 성과 데이터 조회 시 광주광역시(E) + 전라남도(L)의 성과데이터 합이 전남광주통합특별시(R) 성과와 동일한 값을 의미하게 될까요?

[답변] 아니요, (구)E와 (구)L의 성과 합이 (신)R의 성과와 동일하지는 않습니다. E, L, R은 서로 중복되지 않는 별개의 지역코드이며, 하나의 유저는 세 코드 중 하나로만 분류됩니다. R은 E와 L을 합산한 값(상위 지역)이 아니라, 해당 지역에서 신규 코드(R)로 추정된 유저들만의 성과입니다.
따라서 동일 날짜·동일 광고그룹 기준으로는 해당 지역 전체 성과 = E + L + R 의 관계가 성립하며, E + L = R 로 해석되지는 않습니다. 과도기에는 R 추정 비중이 늘면서 E/L 성과는 감소하고 R 성과는 증가하며, 2027년 1월 구코드 삭제 이후에는 해당 지역 성과가 R로만 집계됩니다.

3. 타겟팅 설정 관련
[질문] 위 공지사항에 작성해주신 내용에 따르면 (구)/(신) 행정구역코드를 모두 요청에 포함되어야 한다고 되어있습니다.
그럼 예로 ‘광주광역시 광산구 송정2동’ 타겟팅을 원하는 경우에

구 : E13003602
신 : R……………
으로 시작하는 두 코드를 모두 같이 포함하여야만 정확한 타겟팅 설정이 되는것이 맞는걸까요?
혹 (구)나 (신) 하나만 선택하여 타겟팅 하는 경우 영향범위가 어떻게 되는지 궁금합니다.

[답변] 모먼트의 유저 추정지역정보는 최근 180일간의 서비스 활동내역을 바탕으로 생성되며, 유저는 오직 하나의 지역정보를 가집니다. 따라서 7월 1일 전남광주통합특별시 신설 이후부터 신규 지역코드로 지역 정보가 추정되는 유저가 점차 증가하게됩니다. 따라서 ‘광주광역시 광산구 송정2동’ 과 ‘전남광주통합특별시 광산구 송정2동’를 함께 타겟팅 설정했을 때 해당 지역으로 추정되는 유저를 모두 타겟팅 할 수 있습니다.(구)지역인 광주광역시 광산구 송정2동만 타겟팅 설정했을 경우, 시간이 지나면서 점차 타겟 모수가 감소할 수 있습니다.

mz.targetpick · 7월 26, 2026, 11:52오후

내용 확인하였습니다.
추가 문의 발생시 전달드리겠습니다.

답변 감사합니다

mz.targetpick · 7월 28, 2026, 6:58오전

추가 문의 있어 질문 전달드립니다.

행정구역 개편 관련 API 변경된 내용 확인하였으며,
시 / 도 조회 API 호출 시 "R"코드 응답 확인하였습니다.

또한 안내주신 내용 대로 기존에 '국내 전체’로 세팅되어있던 광고그룹 상세 조회시 "R"코드가 포함되지 않은 것 확인하였습니다.

"R"코드를 포함하여 조회가 가능한지 확인하려, 모먼트 admin 접근하여 광고그룹 수정 진행하였으며, 그대로 ‘지역 > 전체 > 국내’ 선택 후 저장 시 동일하게 "R"코드가 없이 api 응답하는 것으로 확인하였습니다.

기존에 이미 생성되어있는 광고그룹은 ‘행정구역 상세’ 세팅이 아닌 ‘전체’ 지역으로는 전남광주통합특별시 포함 세팅은 불가할까요?

기존에 생성되어있는 광고그룹의 타겟팅이 ‘행정구역’ 이었는데 '전체’로 수정하는경우는 정상응답 합니다.
다만 기존에 이미 '전체’였으나 그대로 다시 '전체’로 수정하는 경우에는 신규지역 코드가 제외된 상태로 응답 합니다.

신규 광고그룹 생성시에는 ‘전체’ 지역 선택시 ‘전남광주통합특별시’ 정상 응답 확인했습니다.

mz.targetpick · 7월 29, 2026, 5:47오전

추가 내용 문의드립니다.

account id : 579922
adgroup id : 4483557

위 광고그룹 대상의 데이터를 조회해본 결과

광고그룹 상세 조회시 “locationType”: “ALL” 로 하위 locations 데이터는 "R"을 제외한 타겟팅 지역들만 응답합니다.

API 수정 전에 생성된 광고그룹으로 신규 생성된 전남광주통합특별시는 제외하여 응답한것으로 이해하였습니다.

하지만 어제자(2026-07-28) 보고서 데이터 조회결과
dimension → location 조회 시

"start": "2026-07-28",
"end": "2026-07-28",
"dimensions": {
    "ad_group_id": "4483557",
    "location": "전남광주통합특별시"
},
"metrics": {
    "imp": 4**,
    "click": 1**,
    "ctr": 0.***,
    "cost": 1**.0,
    "video_play_3s": 0,
    "vtr": 0.0
}

위와 같이 전남광주통합특별시에 성과데이터를 응답하고 있습니다.
(일부 데이터 마스킹 처리 하여 첨부합니다.)

‘전남광주통합특별시’ 행정구역을 타겟팅으로 포함되지 않은 광고그룹인데 성과 데이터가 존재하여,
관련하여 정상 응답을 하고 있는것이 맞는지 문의드립니다.

mz.targetpick · 7월 31, 2026, 1:06오전

위 추가 문의 내용 확인 부탁드립니다.

mz.targetpick · 8월 4, 2026, 2:14오전

안녕하세요.

아직 관련하여 답변 주시기 전이나,
확인된 내용이 있어서 확인차 전달드립니다.

모먼트 Admin > 광고그룹 수정 시
→ 기존 ‘국내 전체’ 지역 타겟팅으로 생성된 광고그룹을 동일하게 ‘국내 전체’ 지역 타겟팅으로 수정시 기존에는 "R"코드가 미포함된 채로 수정되었던 것으로 확인하였는데, 금일 재 테스트 결과 "R"코드가 포함되는 것으로 확인하였습니다. API가 수정된 것이 맞을까요?
→ 맞다면, 관련하여 광고그룹 수정 Open API 호출시에도 기존 ‘R’ 코드 없이 '국내전체 타겟팅’으로 생성된 광고그룹을 수정할 때에는 필수로 ‘R’ 코드를 추가하여 request 데이터 전달하는 것이 맞는지 확인 요청 드립니다.

mz.targetpick · 8월 10, 2026, 1:26오전

안녕하세요.
바쁘신 와중에 죄송하지만 위 내용 아직 확인이 어려운지 문의드립니다.

주요 내용

API 변경 전 생성된 ‘국내 전체 지역’ 타겟팅 광고그룹은 "R"코드가 추가 되어 있지 않은데, 전남광주통합특별시에 대한 성과 데이터가 있음.
API 변경 전 생성된 ‘국내 전체 지역’ 타겟팅 광고그룹을 모먼트 Admin에서 그대로 수정할 경우 기존에는 "R"코드가 없이 수정되었는데, 현 시점에는 "R"코드가 추가되는 것으로 확인함. Open API를 활용하여 수정 요청하는 경우에도 동일하게 기존 "R"코드 없이 전체 지역 타겟팅한 광고그룹의 경우에도 "R"코드를 추가하여 요청해야 하는 것인지.