쿠팡 API - Report

?????? 이건 뭘 하는 API 인지?

URL

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

Method

  • GET

Request Headers

NameTypeValue필수설명

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

ParameterType필수설명

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 parameterType설명

alert

string

서버에서 전송된 알림 메시지. 대부분의 경우 null일 것입니다. 예시: "alert": null

records

Array of object

리포트 데이터

recordsType설명

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

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 플랫폼에 문제가 발생했습니다.

Last updated