카카오모먼트 리포트 API 관련 문의

adphs · 3월 30, 2026, 2:57오전

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

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

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

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

다름이 아니라 카카오모먼트 API 연동 과정에서 오류가 발생하여 문의 드립니다.
내용은 다음과 같습니다.

현상
/openapi/v4/adAccounts/report API 호출 시 cost는 정상 반환되나, imp·click·ctr·video_play_3s·vtr이 전 기간에 걸쳐 0으로 반환됨.
재현 조건
GET /openapi/v4/adAccounts/report
?datePreset=LAST_7DAY (또는 YESTERDAY)
&level=AD_ACCOUNT
&dimension=CREATIVE_FORMAT
&metricsGroup=BASIC
adAccountId: 287984
응답 패턴
cost: 정상 집계 확인 (일별 약 400만~2,100만 원 수준)
imp / click / ctr / video_play_3s / vtr: 전 날짜에서 0
• HTTP 200 / “message”: “Success” — 오류 없음
• datePreset 변경해도 동일 증상
대시보드와의 불일치
카카오모먼트 대시보드에서는 동일 계정·기간의 imp/click이 정상 수치로 표시됨.
확인 요청 사항

*metricsGroup=BASIC*에 imp·click이 포함되는지, 혹은 해당 지표 조회를 위해 별도 metricsGroup 값 지정이 필요한지
API와 대시보드 간 imp/click 수치 불일치 원인에 대한 서버 측 확인

가능하시다면 원인 및 해결 방안에 대한 가이드 안내 주시면 감사하겠습니다. .
추가로 필요하신 정보가 있으시면 말씀 부탁 드립니다.

adphs · 3월 30, 2026, 5:01오전

추가로 확인 시, 해당 캠페인 ‘메시지’ 캠페인으로 보여, dimension 조건 부분 등 다르게 설정해야하는 부분이 있다면 말씀 부탁 드리겠습니다.

감사합니다.

moment_openAPI2 · 3월 31, 2026, 1:12오전

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

보내주신 API호출 로그와 현상을 바탕으로 확인한 결과 해당 문제는 광고 계정 내 캠페인 유형과 선택하신 metricsGroup 간의 불일치로 인해 발생하는 현상으로 파악됩니다.

위 디벨로퍼스 문서의 참고사항 3번에 다음과 같은 특성이 안내되어 있습니다.

3. 메시지 캠페인만 있는 광고계정의 경우 기본 지표(BASIC), 추가 지표(ADDITION), 카카오친구 지표(PLUS_FRIEND), 동영상 지표(VIDEO)를 선택하는 경우 값이 없습니다.

이는 메시지 캠페인의 경우 일반적인 디스플레이 광고의 imp(노출), click(클릭) 체계와는 다른 별도의 메시지 전용 지표를 사용하기 때문입니다.

메시지 캠페인의 정확한 성과(발송,열람,클릭,재생 등)를 확인하시려면 metricsGroup 파라미터에 메시지 전용 지표 그룹을 추가하여 호출해보시고 추가 문의 사항이 있으시다면 말씀해주세요.

수정된 호출 예시: metricsGroup에 MESSAGE, MESSAGE_ADDITION, MESSAGE_CLICK 등을 포함

참고를 위해 MetricsGroup (Enum) 도 링크로 첨부드립니다.

감사합니다.