Publisher API (Report)

매일 오전 11시 50분에 2일 전 데이터가 확정됩니다.

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	시작일 (yyyyMMdd)
toDate	string	Y	종료일 (yyyyMMdd)
country	numeric	N	0 or 1 (default: 0)

Content-Type

• application/json

Response Body

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

ID	Type	설명
report_date	string	날짜
media_key	string	노출 요청이 발생한 미디어의 키
placement_id	string	노출 요청이 발생한 지면 ID
thirdparty_id	numeric	서드파티 리스트
report_type	numeric	1: 애드팝콘 SSP, 3: 헤더비딩, 4: 미디에이션
country	string	국가 코드 (country=1 일 경우)
request_value	numeric	요청 수 (서드파티가 데이터를 제공하지 않을 경우 0으로 표시)
response_value	numeric	응답 수 (앱 매체에 한함, 서드파티가 데이터를 제공하지 않을 경우 0으로 표시)
impression_value	numeric	노출 수
click_value	numeric	클릭 수
media_cost	numeric	revenue (USD)

200

json

{
	"alert": null,
	"records": [
		{
			"report_date": "20220101",
			"media_key": "test_media",
			"placement_id": "test_placement",
			"thirdparty_id": 0,
			"report_type": 1,
			"request_value": 23456,
			"response_value": 20000,
			"impression_value": 12345,
			"click_value": 10,
			"media_cost": 123.123456
		}
	]
}

서버 응답 코드

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

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

서드파티 리스트

ID	Name	Type
1	AdMob	App
3	MoPub	App
4	Cauly	App
5	Mezzomedia	App
6	Mobon	App
7	Unity	App
8	Mintegral	App
9	FAN (Facebook Audience Network)	App
10	AdFit	App
12	Criteo	App
14	Vungle	App
16	Fyber	App
17	TapJoy	App
18	Pangle	App
19	GAM (Google Ad Manager)	App
21	AppLovin (Waterfall)	App
22	NAM (Naver Ad Manager)	App
23	AppLovin (Bidding)	App
24	ADOP	App
25	Coupang (CPM)	App
26	MobWith	App
27	AyetStudios	App
28	ADforus	App
80	Rainbow8 (Reward Banner)	App
81	NHNAce (Reward Banner)	App
82	MobWith (Reward Banner)	App
83	Mezzomedia (Reward Banner)	App
84	Ebay (Reward Banner)	App
85	Coupang (Reward Banner)	App
86	ADOP (Reward Banner)	App
87	Mobon (Reward Banner)	App
88	Digital camp (Reward Banner)	App
89	Admixer (Reward Banner)	App
90	Appier (Reward Banner)	App
1500	Interworksmedia	Web
1501	ADON	Web
1504	Mobon	Web
1505	Widerplanet	Web
1506	MobWith	Web
1607	Across adx	Web
1508	NHNAceToast	Web
1509	Mezzomedia Targetpick	Web
1510	Coupang	Web
1511	Neo Interactive	Web
1512	Digitalcamp	Web
1513	NextPaper	Web
1514	EDNPlus	Web
1515	ADOP	Web
1516	Adfit	Web