1.Campaign
请求说明
- 该接口对大小写敏感,请求的地址及参数需要严格按照规定的大小;
- 接口可查询自2021-01-01起的campaign维度数据。
URL
请求协议
请求类型
请求参数
Parameters |
Tpye |
Requirement |
Default |
Expample |
desc |
username |
string |
Y |
none |
username |
username |
token |
string |
Y |
none |
8f60c8102d29fcd 525162d02eed4566b |
md5(API_KEY.md5(time)) ex:md5(YM6L7FZ5KY1U16bCBMER+md5(1470499200)) |
timestamp |
int |
Y |
none |
1569859200 |
Request unix timestamp |
date_begin |
string |
Y |
none |
2021-06-01 |
YYYY-MM-DD |
date_end |
string |
Y |
none |
2019-06-02 |
YYYY-MM-DD |
media |
string |
Y |
none |
toutiao,tiktok,tencent,kuaishou,baidu_sem,baidu_feed,kwai |
媒体名字 |
product |
string |
N |
none |
Simply Guitar_G2C |
NativeX Product Name |
Token的生成
- 在请求参数中传入 username, timestamp, token 来通过认证,token 由 API
_KEY, 请求时间 timestamp 生成
- 规则 md5(API_KEY.md5(time)) "." 为字符串连接符
上述所提到的 API_KEY 需要相关人员申请
限流
接口请求采用限流措施:限制每分钟最多20次请求
返回字段
Field |
Type |
Example |
Desc |
code |
int |
200 |
200 Success !=200 Fail |
message |
string |
success |
the code message |
data |
array |
'[...]' |
return Data |
data字段
Field |
Type |
Example |
Desc |
date |
string |
2019-12-01 |
Date Time YYYY-MM-DD |
media |
string |
tiktok |
Media Name |
account_id |
string |
1665030325122059 |
Account Id |
campaign_id |
string |
1675351064177726 |
Campaign Id |
campaign_name |
string |
单个12247_0_PL顾客买面包解说 |
Campaign Name |
geo |
string |
CN |
Country Id |
impression |
int |
1234 |
Impression |
click |
int |
123 |
Click |
media_conversion |
int |
12 |
Conversion |
platform |
string |
ios |
Os |
media_spend |
float |
22.86 |
Spend |
product |
string |
Object Hunt_Global |
NativeX Product Name |
json样例
{
{
"code": 200,
"message": "success",
"data": [
{
"media": "toutiao",
"date": "2021-01-07",
"account_id": "1665030325122059",
"campaign_id": "1675351064177726",
"campaign_name": "单个_12247_0_PL_顾客买面包解说-pl0615-RR20",
"geo": "CN",
"impression": 976,
"click": 295,
"media_conversion": 42,
"media_spend": 11.02,
"platform": "ios",
"product": "Object Hunt_Global"
},
{
"media": "toutiao",
"date": "2021-01-07",
"account_id": "1665030325122059",
"campaign_id": "1677165183558701",
"campaign_name": "单个_12247_0_PL_顾客买面包解说-pl0615",
"geo": "CN",
"impression": 1167,
"click": 420,
"media_conversion": 48,
"media_spend": 13.23,
"platform": "ios",
"product": "Object Hunt_Global"
},
{
"media": "toutiao",
"date": "2021-01-07",
"account_id": "1665030325122059",
"campaign_id": "1677167816094755",
"campaign_name": "单个_12247_0_PL_顾客买面包解说-pl0615-RR30+渠道-copy1",
"geo": "CN",
"impression": 854,
"click": 312,
"media_conversion": 35,
"media_spend": 10.48,
"platform": "ios",
"product": "Object Hunt_Global"
}
}
}