쿠팡 API - Report

URL

• https://sspi-ext-report.adpopcorn.com/v1/analytics/data

Method

• GET

Request Headers

Name	Type	Value	필수	설명
Authorization	string	Bearer ${access_token}	Y	생성된 액세스 토큰을 ${access_token} 자리에 넣어 인증에 사용하세요.

예시 : curl “https://sspi-ext-report.adpopcorn.com/v1/analytics/data?fromDate=20220101&toDate=20220101” -H “Authorization: Bearer test_access_token” -L

Parameter

Parameter	Type	필수	설명
fromDate	string	Y	시작일
toDate	string	Y	종료일
reportTypeId	int	N	리포트 타입

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

Content-Type

• application/json

Response parameter

Body parameter	Type	설명
alert	string	서버에서 전송된 알림 메시지. 대부분의 경우 null일 것입니다. 예시: "alert": null
records	Array of object	리포트 데이터

records	Type	설명
report_date	string	날짜
sub_id	string	sub id
publisher_id	string	publisher id (reportTypeId: 2 에서만 제공)
click	numeric	클릭 수 (reportTypeId: 1, 3 에서만 제공)
conversion	numeric	전환 수
conversion_revenue	numeric	전환 비용
cancel	numeric	취소 수
cancel_revenue	numeric	취소 비용
total_revenue	numeric	총 revenue

200

json

{
	"alert": null,
	"records": [
		{
			"report_date": "20220101",
			"sub_id": "test_sub_id",
			"publisher_id": "test_publisher_id",
			"click": 22649,
			"conversion": 470,
			"conversion_revenue": 13065380,
			"cancel": 55,
			"cancel_revenue": -978080
			"total_revenue": 12087300
		}
	]
}

서버 응답 코드

아래 표는 Adpopcorn API 플랫폼에서 REST API 응답으로 전송되는 일반적인 HTTP 상태 코드를 나열한 것입니다.

Code	메세지	설명
200	성공	요청이 성공적으로 처리되었습니다.
400	client-side 에러	유효성 검사에 실패했습니다.
401	인증되지 않음	인증 또는 권한 부여 실패가 발생했습니다.
500	API-side 에러	Adpopcorn API 플랫폼에 문제가 발생했습니다.