해당 글은 현재 중국어 및 영어로만 제공됩니다. 빠른 시일 내에 번역을 완료하도록 최선을 다하겠습니다. 이해해 주셔서 감사합니다!

Reporting API 1.0

Release notes

Version	Time	Modification
1.1	2018-08-01
1.2	2019-01-21	Add three fields: media_name, site_name , code_name
1.3	2019-03-12	Add two metrics: JP region, usd currency
1.4	2019-12-05	Change domain
1.5	2021-07-12	• Modified the caliber of fill_rate .New metrics release : ad_request 、 response、ad_fill_rate and ad_impression_rate . But these added metrics do not have data before March 15 2021.•And it is recommended to switch to reporting api 2.0, which will provide a better user experience and better performance
1.6	2021-08-31	Update the domain name"partner.oceanengine.com" to "open-api.pangleglobal.com"

Please ask your BD to apply User ID and secure_key before using TikTok Audience Network reporting API.You can use the following request parameters in three different URLs to get user/app/slot data

General Request Parameters

Name	Value	Required	Description
user_id	long	Y	User ID, provided by BD
timestamp	long	Y	Timestamp
nonce	long	Y	Random string
start_date	string	Y	Start date, format ‘YYYY-MM-DD’, time span needs less than 30 days
end_date	string	Y	End date, format ‘YYYY-MM-DD’, time span needs less than 30 days
sign	string	Y	The rule is as below
time_granularity	string	N	Only support by day, default value is STAT_TIME_GRANULARITY_DAILY
region	string	N	Follow ISO 3166-1 Standard, support China(CN) and Japan(JP).

Python code example:

signature PHP Code Sample：

Get Ad data Account

data request addresshttps://open-api.pangleglobal.com/union/media/open/api/report/userMethod: GetExample:https://open-api.pangleglobal.com/union/media/open/api/report/user?user_id=xx&sign=xxxxxxxxxxxxxx&nonce=12345timestamp=1615778032&start_date=2018-01- 25&end_date=2018-01-28®ion=CN

Return Parameters

Name	Value	Required	Description
code	long	Y	Return code, details please see the Code List below.
message	string	Y	Return message, details please see the Code List below.
data	json	Y	Data json includes stat_datetime、user_id、show、click、click_rate、ecpm、cost
stat_datetime	string	Y	time
region	string	Y	Follow ISO 3166-1 Standard, support China(CN) and Japan(JP).
media_name	unicode	Y	Account name
show	long	Y	Impression
click	long	Y	Click
click_rate	float	Y	Click rate
ecpm	float	Y	eCPM
cost	float	Y	Estimated revenue
currency	long	Y	Currency

Return sample

APP data

request addresshttps://open-api.pangleglobal.com/union/media/open/api/report/appMethod: GetExample:https://open-api.pangleglobal.com/union/media/open/api/report/app?user_id=xx&sign=xxxxxxxxxxxxxx&nonce=12345timestamp=1615778032&start_date=2018-01- 25&end_date=2018-01-28®ion=CN

Return Parameters

Name	Value	Required	Description
code	long	Y	Return code, details please see the Code List below.
message	string	Y	Return message, details please see the Code List below.
data	json	Y	Data json includes stat_datetime、user_id、show、click、click_rate、ecpm、cost
stat_datetime	string	Y	time
region	string	Y	Follow ISO 3166-1 Standard, support China(CN) and Japan(JP).
appid	long	Y	Appid from TikTok Audience Network
media_name	unicode	Y	Account name
site_name	unicode	Y	App name
show	long	Y	Impression
click	long	Y	Click
click_rate	float	Y	Click rate
ecpm	float	Y	eCPM
cost	float	Y	Estimated revenue
currency	long	Y	Currency

Return Sample

Slot data

request addresshttps://open-api.pangleglobal.com/union/media/open/api/report/slotMethod: GetExample: https://open-api.pangleglobal.com/union/media/open/api/report/slot?user_id=xx&sign=xxxxxxxxxxxxxx&nonce=12345timestamp=1615778032&start_date=2018-01- 25&end_date=2018-01-28®ion=CN

Return parameters

Name	Value	Required	Description
code	long	Y	Return code, details please see the Code List below.
message	string	Y	Return message, details please see the Code List below.
data	json	Y	Data json includes stat_datetime、user_id、show、click、click_rate、ecpm、cost
stat_datetime	string	Y	time
region	string	Y	Follow ISO 3166-1 Standard, support China(CN) and Japan(JP).
appid	long	Y	Appid from TikTok Audience Network
ad_slot_id	long	Y	Ad Slot ID from TikTok Audience Network
media_name	unicode	Y	Account name
site_name	unicode	Y	App name
code_name	unicode	Y	Slot name
show	long	Y	Impression
click	long	Y	Click
click_rate	float	Y	Click rate
ecpm	float	Y	eCPM
cost	float	Y	Estimated revenue
currency	long	Y	Currency

Return Sample