쿠팡 일별 리포트 API

쿠팡 CPS 관련 일별 리포트를 아래의 API를 통해 제공해 드립니다.

URL

• https://sspi-cps-report.adpopcorn.com/dailyreport?reportkey=xxxxxx1k0i1d4a6e2i5g0ajwyobrks&startdate=20210816&enddate=20210816&reporttype=1

Method

• GET

Content-Type

• application/json

Parameter

파라미터	설명	필수	예시
startdate	시작일	Y	20210815
enddate	종료일	Y	20210816
reportkey	인증을 위한 매체별 리포트 키(SSP 사업팀에 문의)	Y	xxxxxx1k0i1d4a6e2i5g0ajwyobrks
reporttype	리포트타입	N	1(default) or 2 or 3

reporttype	설명
1	sub_id 별 리포트 (default)
2	sub_id 별 publisher_id를 구분한 리포트. 단, 클릭 데이터가 제공되지 않음
3	쿠팡 리포트 API를 통해 수집된 데이터. 전일 데이터는 익일 오후 12시 30분 이후 조회 가능

제약 사항

• 조회 기간은 최대 7일 입니다.

Response

key	Type	설명
result	boolean	리포트 조회 결과
resultCode	int	리포트 조회 결과 코드
resultMessage	string	리포트 조회 결과 메시지
report	array of object	리포트 (아래 예시 참고)

200 : reportType=1

json

{
  "Result": true,
  "ResultCode": 1,
  "ResultMessage": "success",
  "Report": [
    {
      "report_date": "20210812",
      "sub_id": "CPSep1",
      "click": 22649,
      "conversion": 470,
      "conversion_revenue": 13065380,
      "cancel": 55,
      "cancel_revenue": 978080,
      "total_revenue": 12087300
    },
    {
      "report_date": "20210812",
      "sub_id": "CPSep2",
      "click": 17307,
      "conversion": 216,
      "conversion_revenue": 9608890,
      "cancel": 15,
      "cancel_revenue": 1564520,
      "total_revenue": 8044370
    }
  ]
}

200: reportType=2

json

{
  "result": true,
  "resultCode": 1,
  "resultMessage": "success",
  "report": [
    {
      "report_date": "20210816",
      "sub_id": "sub1",
      "publisher_id": "aaaa",
      "conversion": 860,
      "conversion_revenue": 27773960,
      "cancel": 80,
      "cancel_revenue": 3545950,
      "total_revenue": 24228010
    },
    {
      "report_date": "20210816",
      "sub_id": "sub1",
      "publisher_id": "bbbbb",
      "conversion": 433,
      "conversion_revenue": 12673080,
      "cancel": 42,
      "cancel_revenue": 1742390,
      "total_revenue": 10930690
    }
  ]
}

200: reportType=3

json

{
  "result": true,
  "resultCode": 1,
  "resultMessage": "success",
  "report": [
    {
      "report_date": "20220801",
      "sub_id": "sub1",
      "click": 15141,
      "conversion": 1044,
      "conversion_revenue": 37178699,
      "cancel": 126,
      "cancel_revenue": -2330357,
      "total_revenue": 34848342
    },
    {
      "report_date": "20220801",
      "sub_id": "sub2",
      "click": 8587,
      "conversion": 582,
      "conversion_revenue": 21559586,
      "cancel": 51,
      "cancel_revenue": -1174181,
      "total_revenue": 20385405
    }
	]
}

서버 응답 코드

Code	Message
1	성공
100	에러
1001	필수 파라미터가 누락되었습니다
1002	요청 파라미터가 없습니다
1003	리포트키가 유효하지 않습니다