Moment_management 토큰관련 문의 드립니다

카카오모먼트 API에 대한 최신 공지는 카카오모먼트 공지사항카카오광고 통합 에이전시 에서 확인 가능합니다.

카카오모먼트 API 외 문의사항은 DevTalk 각 카테고리나 FAQ에서 확인 가능합니다. 카카오모먼트 오픈API 외 자주 발생하는 문의는 아래 게시판에서 확인 및 등록 가능합니다.

︎- AdFit SDK FAQ
︎- AdFit SDK 고객센터 문의
︎- 픽셀&SDK FAQ 1
︎- 픽셀&SDK 고객센터 문의

카카오모먼트 오픈API 권한이 없는 앱, 카카오모먼트 오픈API가 아닌 다른 문의의 경우 답변이 늦어지거나 진행이 불가하오니 이 점 양해 부탁드립니다.

※ 사용 중 문의사항은 아래 내용을 기재하신 후 작성해주시길 바랍니다.
호출 시 발생한 오류의 경우 호출 /응답 내용을 상세히 남겨주시는 것이 확인 및 답변에 도움이 됩니다.

  • 사업자명: 루드웍스
  • APP 이름(ID): 카카오 모먼트 광고 대시보드 api ansdml emflqslek.
  • 문의 내용: "moment_management 토큰으로 campaigns/report의 metrics가 빈 객체로 오는데 어떤게 문제 일까요?

안녕하세요. 카카오모먼트 담당자입니다.
요청하신 전문과 응답받으신 결과를 첨부해주실 수 있을까요? 전달해주시면 상세 원인 확인해보겠습니다.

안녕하세요.
전문과 응답 결과 첨부 하겠습니다.

요청 자체는 정상 처리됩니다 (HTTP 200, dimensions엔 캠페인/광고그룹/소재 ID가 정확히 매칭)

  1. 하지만 metrics만 항상 빈 객체로 옵니다
  2. metricsGroups 파라미터를 이것저것 바꿔봐도, 캠페인·광고그룹·소재 3단계 리포트 전부에서 똑같이 재현됩니다
  3. 반면 카카오 광고관리자 웹 화면에는 실제 지출이 표시되고 있음

배경(fetch_kakao.py 코드 주석 기준, 2026-08-18 실측):

  • 인증 자체는 정상 — moment_management scope의 비즈니스 토큰으로 캠페인 상태(/campaigns)는 정상 조회됨
  • 그런데 성과 보고서(/campaigns/report)만 요청하면 metrics가 항상 빈 객체로 옴 — 실제로는 대시보드(카카오 광고관리자 화면)에 지출이 잡혀 있는데도 그렇습니다
  • 확인된 제약들: campaignId 필수(없으면 90001 오류), 종료일에 오늘을 넣으면 60008 오류(그래서 어제까지로 고정)
  • 원인 미규명 상태라, 코드에서는 보고서 실패가 상태 수집(ON/OFF, 심사상태)까지 막지 않도록 분리해뒀습니다 → 그래서 대시보드에 카카오 캠페인 상태는 뜨는데 지출·클릭 성과는 0행으로 나오는 상황

카카오모먼트 campaigns/report metrics 빈 값 문의 — 요청·응답 전문

확인 일시: 2026-08-21 (KST 18:54경) 광고계정 ID: 950120 인증: 비즈니스 토큰(scope=moment_management)

1. 기본 재현 (campaigns/report)

요청

GET https://apis.moment.kakao.com/openapi/v4/campaigns/report

?campaignId=1617917,1630276

&start=20260722

&end=20260820

&timeUnit=DAY

&metricsGroups=BASIC

Headers:

Authorization: Bearer {비즈니스 토큰}

adAccountId: 950120

응답 (HTTP 200)

{"code":200,"message":"Success","data":[

{"start":"2026-08-20","end":"2026-08-20","dimensions":{"campaign_id":"1617917"},"metrics":{}},

{"start":"2026-08-19","end":"2026-08-19","dimensions":{"campaign_id":"1617917"},"metrics":{}},

... (이하 동일 패턴 반복, 전체 기간 metrics 전부 빈 객체)

]}

참고: 캠페인 목록(GET /openapi/v4/campaigns)은 정상 응답:

{"content":[

{"id":1617917,"name":"상품 카탈로그_전환_202607132241","userConfig":"ON"},

{"id":1630276,"name":"Display_Visit_TalkStore_ZESTON_202608","userConfig":"ON"}

]}

2. 원인 분리를 위한 추가 테스트 — metricsGroups 파라미터 변형

같은 요청(campaignId=1617917, 2026-08-20 단일일)에서 metricsGroups만 바꿔가며 테스트:

metricsGroups 값 결과
생략 "metrics":{}
BASIC "metrics":{}
BASIC,ADDITION "metrics":{}
basic (소문자) "metrics":{}
BASIC + level=CAMPAIGN 추가 "metrics":{}

파라미터 값과 무관하게 항상 동일한 결과.

3. 원인 분리를 위한 추가 테스트 — 리포트 레벨 변경

같은 계정·같은 날짜(2026-08-20)로 campaign이 아닌 다른 레벨에서도 재현:

adGroups/report

GET /openapi/v4/adGroups/report?adGroupId=4498889&start=20260820&end=20260820&timeUnit=DAY&metricsGroups=BASIC
{"code":200,"message":"Success","data":[

{"start":"2026-08-20","end":"2026-08-20","dimensions":{"ad_group_id":"4498889"},"metrics":{}}

]}

creatives/report

GET /openapi/v4/creatives/report?creativeId=31193496&start=20260820&end=20260820&timeUnit=DAY&metricsGroups=BASIC
{"code":200,"message":"Success","data":[

{"start":"2026-08-20","end":"2026-08-20","dimensions":{"creative_id":"31193496"},"metrics":{}}

]}

캠페인·광고그룹·소재 3개 레벨 모두 동일 증상.

결론

  • 요청은 정상 처리됨 (HTTP 200 / code:200 Success, dimensions에 요청한 ID가 정확히 매칭되어 반환)
  • 캠페인/광고그룹/소재 리포트 3개 레벨 전부에서 metrics가 항상 빈 객체({})로만 옴
  • metricsGroups 파라미터의 값·유무와 무관하게 동일
  • 반면 광고관리자 화면(웹 UI)에서는 해당 기간 실제 지출·노출이 표시되고 있음
  • 클라이언트 측 요청 파라미터 문제가 아니라, 계정(950120) 또는 리포트 API 서버 측에서 지표 데이터가 연결되지 않는 문제로 판단됩니다.

문의: 이 계정(950120)에서 report API의 metrics가 채워지지 않는 원인이 무엇인지, 계정 측 설정(권한/집계 파이프라인 지연 등)에 문제가 있는 것인지 확인 부탁드립니다.

GET https://apis.moment.kakao.com/openapi/v4/campaigns/report 요청 보낼때 파라미터에서 문제가 있습니다.

파라미터중에 metricsGroups=BASIC로 요청을 주셨는데, metricsGroups를 metricsGroup 으로 변경해야 합니다.

안녕하세요, 답변 감사합니다.

말씀해주신 대로 metricsGroupsmetricsGroup(단수)으로 변경해서 요청했더니 정상적으로 지표(imp, click, ctr, cost 등)가 채워지는 것을 확인했습니다.

파라미터명이 공식 문서와 실제 API가 달라서 발생한 문제였네요. 빠르게 원인을 찾아주셔서 감사합니다.

정말감사합니다!