省级地域报告列表
获取实时省级地域报告。接口分为实时数据接口和结算数据接口。通过实时数据接口可以获取相应层级的实时数据,可以不考虑延迟,但是数据没有经过反作弊清洗,不能作为结算数据。
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/report/regionNow
字段 |
类型 |
必须 |
描述 |
apiKey |
String |
Yes |
注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken |
String |
Yes |
身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。参数获取方式见接口clientLogin |
Body 请求参数
字段 |
类型 |
必须 |
描述 |
level |
String |
Yes |
物料层级,account代表账户级别,plan代表计划级别,group代表组级别 |
idList |
String |
No |
如果是账户不填,其他层级需要对应的计划id或组id,使用json格式,如[1000001,20000001] |
region |
String |
No |
默认全国,其他填写地域id,json格式,如[1000001,20000001] |
page |
int |
No |
返回结果的页码,默认为1。 |
参数备注 |
|
1 |
type不传或type=all ,computer,mobile不会被聚合,如果在两种投放都展现则同一条物料为两条数据 |
2 |
level和idList共同控制;level=account,idList不起作用;level=plan,idList为计划id;level=group idList为组id |
3 |
不建议使用idList参数,建议用户取全量数据自行进行筛选 |
4 |
每页数据1000条 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'level=account&idList=®ion=&type=all&page=1' \
'https://api.e.360.cn/dianjing/report/regionNow'
返回结果
{
"regionList": [
{
"areaType": "2",
"campaignId": 1239901766,
"campaignName": "计划名称",
"clicks": "7",
"date": "2021-06-23",
"groupId": 786893860,
"groupName": "推广组名称",
"regionId": "13",
"regionName": "安徽省",
"totalCost": "0.00",
"type": "mobile",
"views": "16"
}
]
}
返回结果说明
字段 |
类型 |
描述 |
date |
string |
日期 |
areaType |
string |
地域类型:1地理,2意图 |
campaignId |
string |
推广计划ID |
campaignName |
string |
推广计划名称 |
groupId |
string |
推广组ID |
groupName |
string |
推广组名称 |
regionId |
string |
所属省份ID |
regionName |
string |
所属省份名称 |
views |
string |
展现 |
clicks |
string |
点击 |
totalCost |
string |
消费 |
type |
string |
关键词报告的投放端类型 |