Request

URL https://sspi-ext-report.adpopcorn.com/v1/analytics/data
HTTP Method GET

Request Headers

Header Name Type Value Required Description
Authorization String Bearer ${access_token} Yes Send your generated access token in place of ${access_token} for authorization.
Example:

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

Request Query Parameters

The following table lists parameters you can use to build requests.

Parameter Name Type Required Description
fromDate String Yes Start date of data retrieval. Example: 20220101
toDate String Yes End date of data retrieval. Example: 20220101
country Numeric No 1 (true) or 0 (false, *default)

Response

Header Name Type Description
Content-Type application/json JSON response

Response Body Parameters

The following table lists parameters returns in API responses.

Body Parameter Type Description
alert String Alert message from server. In most cases, it will be null, Example: “alert”: null
records Array of object The main table-like data structure
Body Parameter Type Description
report_date String Date (YYYYMMDD format) on which an impression was requested.
media_key String Key of the media from which an impression was requested.
placement_id String ID of the placement from which an impression was requested.
thirdparty_id Numeric Thirdparty id list
report_type Numeric Type of Report ID.
1: Adpopcorn SSP, 3: HeaderBidding, 4: Mediation
country String Country code
request_value Numeric Number of requests. (서드파티가 데이터를 제공하지 않는 경우 0으로 표시)
response_value Numeric Number of responses. (only app publisher)
impression_value Numeric Number of impressions.
click_value Numeric Number of clicks.
media_cost Numeric Revenue. (Currency: USD)

Sample 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
		}
	]
}

Thirdparty ID List

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
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
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