카카오 개발 API 정산 비용 호출 문의

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

  • APP 이름(ID):1368423
  • 문의 내용: 카카오 모먼트, 카카오 키워드광고 정산 데이터 API 호출 문의

저희는 카카오모먼트, 카카오 키워드광고의 정산 데이터 API정보를 불러와서 내부 ERP 시스템을 구축하여 정산 데이터를 일원화하여 관리하려고 합니다.

아래 권한을 가지고 있는 상태에서 주요한 필드 값을 가지고 올 수 있는지 문의 드립니다.

  1. 광고 권한
    1. 카카오 에이전시 관리자 agency.ad.kakao.com (모먼트 광고주 200 개, 키워드 광고주 80 개 확인)
    2. 카카오모먼트 멤버 moment.kakao.com
  2. 필요한 API 정보
    1. 정산 데이터 정보 필요
      1. 비용 metricsgroup.cost *(중요)
      2. 광고 노출 지표metricsgroup.imp
      3. 광고 클릭 지표metricsgroup.click
      4. 전환 지표metricsgroup.conv_purchase
      5. 매출 지표metricsgroup.conv_purchase_p
  3. API 문의 사유
    1. 모든 광고계정 마다 ‘보고서’를 수동으로 만들수 없음(모먼트 광고주 200 개, 키워드 광고주 80 개)
    2. 수동으로 만들더라도 무리한 리소스 발생
  4. API 관련 문의 사항
    1. 실시간 또는 준실시간으로 비용 데이터를 조회할 수 있는 방법이 있나요?
    2. 필요한 API 정보를 ‘보고서’를 통하지 않고 데이터를 확인하여 API를 불러오는 방법
    3. 보고서 정보 필수라면 보고서를 자동으로 작성 하게하고 불러오는 방법
    4. 카카오광고 통합에이전시 에서 정산 및 증빙 및 월렛을 통해 정산 데이터 확인이 가능한 것으로 아는데, 광고 통합 에이전시의 데이터를 API 로 연동하는 방법
  5. 결론
    1. 요지는 필요한 API 정보 데이터들을 받을 수 있는 방법들을 문의드립니다.

안녕하세요. 카카오모먼트 담당자입니다.
문의주신 부분 중 모먼트에 한정하여 답변이 가능하여, 키워드 광고의 경우 키워드광고 카테고리에 문의글을 남겨주시면 감사하겠습니다.

  1. 실시간으로 비용 데이터를 조회할 수 있는 방법은 별도로 없으며, 일자별 비용 데이터를 보고서 API를 통해서 조회할 수 있습니다.
  2. 보고서API를 통하지 않고 정산관련 데이터를 조회할 수 있는 API는 별도로 없는 상태입니다.
  3. 보고서API를 통해 정산 데이터의 내부시스템 구축이 가능할것으로 생각됩니다.
  4. 카카오광고 통합에이전시에서는 별도의 오픈API를 제공하지 않고 있습니다.

따라서, 보고서API의 상세 스펙을 확인해보시고 추가 문의사항 있으시면 댓글 주세요. 감사합니다.

안녕하세요. 답변주셔서 감사합니다!

답변 내용 대부분은 이해가 됐으나, 3. 보고서API를 통해 정산 데이터의 내부시스템 구축이 가능할것으로 생각됩니다.

는 아무리 찾아도 ‘조회’ 밖에 체크가 되지 않는데, 광고 계정에 작성되지 않은 보고서 정보를 API 를 통해 내부 시스템에 작성시키게 해서 불러오는 상세 방법을 여쭤봐도 괜찮을까요?

안녕하세요.
말씀주신데로 보고서API는 조회 기능만을 제공하고 있습니다.
프론트에서 보고서 만들기를 하지 않아도 광고계정에서 발생된 리포트는 API로 조회하실 수 있는데, 혹시 모먼트 프론트에서 보고서를 생성/저장한뒤에 API를 호출하는 순서로 진행해야 한다고 생각하실까요? API로는 별도의 생성/저장 단계 없이 광고계정, 캠페인, 광고그룹, 소재 단위 보고서를 조회하실 수 있어서 응답받으신 결과를 내부 시스템에 저장하시면 될것 같습니다.
제가 잘못 이해한것이라면 어떤 형태로 작업예정이신지 추가 댓글 부탁드립니다.

1개의 좋아요

도움주셔서 감사합니다!

말씀하신 내용이 이해가되었습니다! 매번 보고서를 생성/저장 해야하는지 알고 아찔했네요
상세하게 안내주셔서 감사합니다! 좋은 하루되세요~

1개의 좋아요