凤舞报告列表
获取凤舞报告。通过结算报表接口可以获取最晚到昨天的报表,建议获取时间为第二天的8:30,正常情况8:30之前可以保证生成。如果未生成,接口会返回70109错误码。这类接口不能保证最晚生成时间,最好有识别错误码进行重试的机制。
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/report/fengwu
字段 |
类型 |
必须 |
描述 |
apiKey |
String |
Yes |
注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken |
String |
Yes |
身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。参数获取方式见接口clientLogin |
Body 请求参数
字段 |
类型 |
必须 |
描述 |
startDate |
date |
Yes |
起始日期,最大跨度90天 |
endDate |
date |
Yes |
截至日期 |
type |
String |
Yes |
选择报告的投放端类型,允许为空或不包含该参数,若不带该参数或者为all默认为computer。mobile表示移动,computer表示计算机 |
ad_type |
String |
No |
选择报告类型,允许为空或不包含该参数,若不带该参数默认为creative。creative表示分创意类型报告,base_report表示基础数据报告 |
page |
int |
No |
返回结果的页码,默认为1。每次查询数据最多返回1000条明细,如超过,需要指定page进行分页查询 |
参数备注 |
|
1 |
type不传或者为all默认为computer,computer,mobile必须分开请求 |
2 |
建议分日进行取数据 (既startDate=endDate),如果取多天数据分为多次请求 |
3 |
每页数据1000条 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'startDate=2019-02-01&endDate=2019-03-01&type=computer&ad_type=base_report&page=1' \
'https://api.e.360.cn/dianjing/report/fengwu'
返回结果
{
"fengwuList": [
{
"adType": "商品导航橱窗(old)",
"campaignId": 3871524241,
"campaignName": "计划名称",
"clicks": "0",
"date": "2021-06-07",
"groupId": 3352490773,
"groupName": "组名称",
"totalCost": "0.00",
"views": "1"
}
]
}
返回结果说明
字段 |
类型 |
描述 |
date |
string |
日期 |
campaignId |
string |
推广计划ID |
campaignName |
string |
推广计划名称 |
groupId |
string |
推广组ID |
groupName |
string |
推广组名称 |
adType |
string |
凤舞创意类型(仅在分创意类型报告返回该字段) |
views |
string |
展现 |
clicks |
string |
点击 |
totalCost |
string |
消费 |