推广计划报告列表


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

HTTP请求方式

POST

请求地址

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

Headers 请求参数
字段 类型 必须 描述
apiKey String Yes 注册时分配到的api key,该参数作为HTTP HEAD字段传递。
accessToken String Yes 身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。参数获取方式见接口clientLogin
Body 请求参数
字段 类型 必须 描述
startDate date Yes 起始日期,最大跨度90天
endDate date Yes 截止日期,最晚为昨天
type String No 选择报告的投放端类型,允许为空或不包含该参数,若不带该参数默认为all,表示查询全部投放端数据(会汇总在一起);mobile表示移动数据,computer表示PC数据
page int No 返回结果的页码,默认为1。每次查询数据最多返回1000条明细,如超过,需要指定page进行分页查询
参数备注
1 type不传或type=all ,computer,mobile会被聚合成一条
2 建议按type=computer,type=mobile 分别取数据
3 每页数据1000条
请求示例
curl -X POST \ 
--header 'apiKey:APIKEY' \ 
--header 'accessToken:ACCESSTOKEN' \ 
--data 'startDate=2018-08-01&endDate=2018-08-01&type=all&page=1' \ 
'https://api.e.360.cn/dianjing/report/campaign'
返回结果
{
  "campaignList": [
    {
      "campaignId": 4024958540,
      "campaignName": "推广计划名称",
      "date": "2018-08-01",
      "views": "2000",
      "clicks": "100",
      "totalCost": "10.00",
      "converts": "1,                 //仅当type!=all时,才有此字段
      "convertsCost": "425.23",       //仅当type!=all时,才有此字段
      "factConverts": "1",            //仅当type!=all时,才有此字段
      "factConvertsCost": "425.23",   //仅当type!=all时,才有此字段
      "ocpcRemarkName": "表单提交",    //仅当type!=all时,才有此字段
      "ocpcExtUrl": ""               //仅当type!=all时,才有此字段
    }
  ]
}
返回结果说明
字段 类型 描述
date string 日期
campaignId string 推广计划ID
campaignName string 推广计划名称
views string 展现
clicks string 点击
totalCost string 消费
converts string 转化数,仅当type!=all时,才有此字段
convertsCost string 实际转化成本,仅当type!=all时,才有此字段
factConverts string 转化数(计费时间),仅当type!=all时,才有此字段
factConvertsCost string 实际转化成本(计费时间),仅当type!=all时,才有此字段
ocpcRemarkName string 转化类型,仅当type!=all时,才有此字段
ocpcExtUrl string 快投放的转化成功页网址,仅当type!=all时,才有此字段

results matching ""

    No results matching ""