카카오모먼트 광고그룹 생성 API 문의

카카오모먼트 API
1

해당 API를 사용하여
카카오 비즈보드 유형의 광고그룹을 생성할 때 알 수 없는 상황이 발생하여 문의드립니다.

POST
https://apis.moment.kakao.com/openapi/v4/adGroups
{
“campaign”: {
“id”: testtest
},
“config”: “ON”,
“allAvailableDeviceType”: false,
“allAvailablePlacement”: false,
“pacing”: “NONE”,
“adult”: false,
“dailyBudgetAmount”: 15000,
“pricingType”: “CPC”,
“bidAmount”: 0,
“bidStrategy”: “AUTOBID”,
“bidStrategyTarget”: {
“type”: “TARGET_CPA”,
“value”: 100
},
“deviceTypes”: [
“ANDROID”,
“IOS”
],
“placements”: [
“DAUM”,
“NETWORK”
],
“targeting”: {
“ageType”: “NOT_ALL”,
“ages”: [
“25”,
“30”,
“20”
],
“genderType”: “ALL”,
“locationType”: “ALL”
},
“schedule”: {
“detailTime”: false,
“beginDate”: “2026-08-31”,
“lateNight”: false
},
“name”: “xxxxxxaaaa”
}

이와 같은 형태로 API 호출 시 광고그룹이 생성됨을 확인하였습니다.
그런데 요청 body에 보시면 “locationType”: “ALL” 로 요청을 하였는데 광고센터에 접속하여 확인 시 해외 체크박스가 해제되어 있습니다. 해외 체크가 불가능한 경우라면 모르겠는데 광고센터 접속해서 해외 체크가 가능하여 문의드립니다.

++추가로 얼마 전 전남광주통합특별시 관련하여 내용을 확인하였는데,
locationType이 AREA 일 경우에 포함이 필요한 건 알겠으나,
ALL일 경우에도 지역코드 “R” 포함 필요 라는 해당 내용을 확인하여 locations에 지역코드 R을 넣어보았는데 잘못된 요청이라고 응답이 와서 추가로 문의드립니다.

2

안녕하세요. 카카오모먼트 담당자입니다.

  1. 비즈보드 유형 광고그룹 생성
    비즈보드의 경우 최근 해외지역 옵션이 추가되어 모먼트 프론트에서 전체인 경우 해외를 포함하고 있는데 오픈API에서는 아직 이 부분이 반영되지 못해 싱크가 맞지 않아 발생된 현상입니다. 이부분 오픈API를 가능한 빠른시일내에 수정하여 재 공유드리겠습니다.

  2. locations에 지역코드 R요청
    이부분은 요청전문을 추가로 전달해주실 수 있을까요? 회신주시면 상세 확인해보겠습니다.

3

본문의 내용과 같은 상태에서 locationType 아래에 locationType이 AREA일 경우와 동일하게
locations에 값을 넣어서 보내는 거라고 생각하여 아래와 같이 진행했었습니다.

{
“campaign”: {
“id”: testtest
},
“config”: “ON”,
“allAvailableDeviceType”: false,
“allAvailablePlacement”: false,
“pacing”: “NONE”,
“adult”: false,
“dailyBudgetAmount”: 15000,
“pricingType”: “CPC”,
“bidAmount”: 0,
“bidStrategy”: “AUTOBID”,
“bidStrategyTarget”: {
“type”: “TARGET_CPA”,
“value”: 100
},
“deviceTypes”: [
“ANDROID”,
“IOS”
],
“placements”: [
“DAUM”,
“NETWORK”
],
“targeting”: {
“ageType”: “NOT_ALL”,
“ages”: [
“25”,
“30”,
“20”
],
“genderType”: “ALL”,
“locationType”: “ALL”,
“locations”:[
{“value”:“R”}
]
},
“schedule”: {
“detailTime”: false,
“beginDate”: “2026-08-31”,
“lateNight”: false
},
“name”: “xxxxxxaaaa”
}

방식이 틀렸다면 안내해 주시는 방법으로 진행하겠습니다.

4

안녕하세요. 요청에서 locations에 "R"만 포함되어 있어 잘못된 요청입니다로 응답되는건 정상입니다.
"R"를 포함하여 요청이 필요함으로 아래와 같이 "R"이외에 나머지 지역코드도 포함해서 진행 부탁드립니다. 감사합니다.

"locations": [
      { "value": "A" }, { "value": "B" }, { "value": "C" }, { "value": "D" },
      { "value": "E" }, { "value": "F" }, { "value": "G" }, { "value": "H" },
      { "value": "I" }, { "value": "J" }, { "value": "K" }, { "value": "L" },
      { "value": "M" }, { "value": "N" }, { "value": "O" }, { "value": "P" },
      { "value": "Q" }, { "value": "R" }, { "value": "U" }
    ]