创意报告列表


获取创意报告。通过结算报表接口可以获取最晚到昨天的报表,建议获取时间为第二天的8:30,正常情况8:30之前可以保证生成。如果未生成,接口会返回70109错误码。这类接口不能保证最晚生成时间,最好有识别错误码进行重试的机制。

HTTP请求方式

POST

请求地址

https://api.e.360.cn/dianjing/report/creative

Headers 请求参数
字段 类型 必须 描述
apiKey String Yes 注册时分配到的api key,该参数作为HTTP HEAD字段传递。
accessToken String Yes 身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。参数获取方式见接口clientLogin
Body 请求参数
字段 类型 必须 描述
startDate date Yes 起始日期,最大跨度90天
endDate date Yes 截至日期
level String Yes 物料层级,account代表账户级别,plan代表计划级别,group代表组级别
idList String No 如果是账户不填,其他层级需要对应的计划id或组id,使用json格式,如[1000001,20000001]
type String No 选择关键词报告的投放端类型,允许为空或不包含该参数,若不带该参数默认为all。all表示查询全部投放端数据,mobile表示移动,computer表示计算机
page int No 返回结果的页码,默认为1。
参数备注
1 type不传或type=all ,computer,mobile不会被聚合,如果在两种投放都展现则同一条物料为两条数据
2 建议分日进行取数据 (既startDate=endDate),如果取多天数据分为多次请求
3 level和idList共同控制;level=account,idList不起作用;level=plan,idList为计划id;level=group idList为组id
4 不建议使用idList参数,建议用户取全量数据自行进行筛选
5 每页数据1000条
请求示例
curl -X POST \ 
--header 'apiKey:APIKEY' \ 
--header 'accessToken:ACCESSTOKEN' \ 
--data 'startDate=2018-08-01&endDate=2018-09-01&level=account&idList=&type=all&page=1' \ 
'https://api.e.360.cn/dianjing/report/creative'
返回结果
{
  "creativeList": [
    {
      "campaignId": 851521265,
      "campaignName": "计划标题",
      "clicks": "0",
      "creativeId": 5873112187,
      "date": "2021-06-07",
      "groupId": 938474322,
      "groupName": "组标题",
      "title": "创意标题",
      "totalCost": "0.00",
      "type": "computer",
      "views": "2"
    }
  ]
}
返回结果说明
字段 类型 描述
date string 日期
type string 关键词报告的投放端类型
campaignId string 推广计划ID
campaignName string 推广计划名称
groupId string 推广组ID
groupName string 推广组名称
creativeId string 创意ID
views string 展现
clicks string 点击
totalCost string 消费

results matching ""

    No results matching ""