광고그룹보고서 API 도달수, 메시지 관련 수치가 대시보드와 다릅니다

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

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

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

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

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

  • 사업자명: (주)차이커뮤니케이션
  • APP 이름(ID): 하나투어(320497)
  • 문의 내용:
    안녕하세요. 카카오모먼트 광고그룹보고서 API 호출 시 도달수, 메시지 열람수 등의 수치가 카카오모먼트 웹 대시보드와 값이 상이하여 문의드립니다.

호출 API
/openapi/v4/adGroups/report?
start=20250812
&end=20250812
&level=CREATIVE
dimension=DEVICE_TYPE
&metricsGroup=BASIC,ADDITION,MESSAGE,VIDEO&
adGroupId=adgroupid

API 호출 결과

아래 엑셀이 API로 받아온 값인데요. 해당 데이터를 조회한 마지막 일자는 8월 15일 오전 5시 10분경에 조회한 8월 12일자 데이터입니다.
비용, 클릭수는 일치하지만 도달수의 경우 2배 이상의 차이가 발생하고 있습니다.
메시지 열람수(msg_open) 값 역시 API는 127,426이지만, 대시보드에서는 145,442로 표기되고 있습니다.
시간이 지나서 나중에 과거 데이터를 확인하는 경우 데이터가 달라지는 것인가요?
카카오모먼트 측에서 과거 데이터를 언제까지 최신화시켜주는지 알려주시면 감사하겠습니다.

추가 문의 1.
소재가 OFF인 항목들은 노출, 클릭, 비용 등의 수치가 존재함에도 광고그룹 리포트 API 호출 결과에서 제외되는 것으로 보이는데 맞을까요?

추가 문의 2.
호출 API
/openapi/v4/adGroups/report?
start=20250819
&end=20250819
&level=CREATIVE
dimension=DEVICE_TYPE
&metricsGroup=BASIC,ADDITION,MESSAGE,VIDEO&
adGroupId=adgroupid
API 호출 일시 : 8월 20일 오전 5시 10분
대시보드 확인 시각: 8월 20일 오전 10시 40분경
=> 노출, 클릭, 비용 값은 일치하지만 도달 수는 API보다 대시보드가 3이 더 높게 표기되고있습니다.

추가 문의 3.
/openapi/v4/adGroups/report?
start=20250812
&end=20250812
&level=CREATIVE
dimension=DEVICE_TYPE
&metricsGroup=BASIC,ADDITION,MESSAGE,VIDEO&
adGroupId=adgroupid
위 호출 API 형태에 맞게 웹 보고서에서 측정항목 선택 시 일, 디바이스, 소재ID, 소재 이름으로 세팅하고 보면 될 지 문의드립니다.

공유주신 첫번째 이미지상의 summary 캠페인단위의 수치이며, 각 탭은 해당 광고단위의 수치를 보여주나. 도달수의 경우에는 중복등이 제거된 캠페인 단위를 보여주고 있습니다.
API Call의 조건의 경우 소재단위의 조회입니다.
소재단위 조회시, 도달수는 소재를 단위로 측정되며, 개별 소재단위의 도달수의 합은 도달의 집계 중복 처리가 되지 않았기에 그 수가 보신바와 같이 큰 값이 됩니다.

추가문의 1: 별도의 조건을 넣지 않는이상 OFF된 소재가 제외되지는 않습니다.
추가문의 2: 상위 질문과 동일하게 소재단위 조회로 야기된것으로 보입니다.
추가문의 3: 광고단위의 값을 "소재"로 추가 세팅하셔야겠습니다.

안녕하세요, 답변 감사합니다.
개별 소재단위의 도달수의 합은 집계 중복 처리가 되지 않아 도달수가 다르다는 부분은 이해했습니다.
그러나 소재를 1개씩 개별로 확인해보아도 API와 대시보드상 도달 수가 서로 일치하지 않고 있는데요.

제가 이해하기로는 소재들의 도달수 합은 집계 중복 처리가 되지 않아 도달수가 다를 수 있지만
각각의 소재에 대한 수치는 맞아야한다고 생각하는데요.
이 경우도 답변주신 것처럼 개별 소재이지만 집계 중복 처리가 되지 않아 수치가 다른 것인가요?


광고주: 하나투어
날짜: 2025년 8월 12일
소재ID: 28728339
소재 이름: biz_tripmarket_jejuair_tr_mmp
대시보드상 도달수: 10,260
API 도달수: 10,322
API가 62 더 높음



광고주: 하나투어
날짜: 2025년 8월 12일
소재ID: 28659479
소재 이름: biz_tripmarket_guampic_tr_mmp
대시보드상 도달수: 6,520
API 도달수: 6,359
대시보드가 161 더 높음

소재단위에 추가로 디바이스 조건으로 분리하신것이 확인됩니다.
대시보드상의 수치는 디바이스 분리가 되지 않은 수치입니다.
디바이스 조건을 추가하였음으로, 더 세분화된 도달수치가 제공되었고, 이것의 합은 대시보드의 수치(중복 처리가된)것보다 작습니다.

안녕하세요. 답변에 감사드립니다.
답변해주신 내용들 중 도달수 관련하여 답변과 맞지 않는 부분이 있어 추가 문의드립니다.

광고주: 하나투어 (320497)
날짜; 2025년 8월 26일
소재ID: 28830126
소재이름: biz_activesenior_safety_stamina_con_cus
API 도달수: iOS는101, Android는 2416
대시보드 도달수: 2505

문의 1.
디바이스 조건을 추가하여 더 세분화된 도달수치가 제공되었고, 이것의 합은 대시보드의 수치(중복 처리가된것)보다 작습니다. 라고 답변해주셨는데요.
위의 경우 답변주신 것과는 달리 대시보드의 수치가 더 큰데 어떤 경우에 이런 것인가요? 도달수의 수치가 API가 더 높은 경우도 있고, 대시보드가 더 높은 경우도 있고 상위 질문에서 문의드렸던 것처럼 제각각입니다.

문의 2.
API로 받아온 디바이스별 도달수 수치는 중복제거가 안된 수치인 것인가요?

문의 3.
API로 받아온 도달수 수치를 대시보드 도달수 수치와 완벽히 일치시킬 수 있는 방법은 없을까요?

잘못된 답변으로, 불편을 끼쳐서 죄송합니다.
세분화된 수치의 합이 대시보드의 수치보다 큰것이 일반적입니다. 반대로 잘못전달드렸습니다.

다만,
언급하신것과 같이 그 값이 상황에 따라서 다를수 있는데,
그 사유는 도달수는 확률적 자료 구조를 이용한 추정치이기 때문이며, 이에 따라서 3% 오차가 발생할 수 있습니다.

API로 전달드리는 수치는 요청하시는 조건에 따라 다른데, 일전에 문의 주셨던 아래의 샘플과 같은 형태라면
디바이스별 중복이 된 상태로 각 디바이스별 자료를 받게됩니다.

대시보드는 디바이스별 도달수치를 제공하지 않습니다.
아래의 조건에서 DEVICE_TYPE을 제거하시면 원하시는 자료로 보이실것 같습니다.

/openapi/v4/adGroups/report?
start=20250812
&end=20250812
&level=CREATIVE
dimension=DEVICE_TYPE
&metricsGroup=BASIC,ADDITION,MESSAGE,VIDEO&
adGroupId=adgroupid