关键词报告列表


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

HTTP请求方式

POST

请求地址

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

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代表组级别
type String No 选择关键词报告的投放端类型,允许为空或不包含该参数,若不带该参数默认为all。all表示查询全部投放端数据,mobile表示移动,computer表示计算机
idList String 如果是账户不填,其他层级需要对应的计划id或组id,使用json格式,如[1000001,20000001]
page Int 返回结果的页码,默认为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&type=all&idList=&page=1' \ 
'https://api.e.360.cn/dianjing/report/keyword'
返回结果
{
  "keywordList": [
    {
      "avgPosition": "0.00",
      "campaignId": 4056011810,
      "campaignName": "计划名称",
      "clicks": "1",
      "date": "2021-06-07",
      "groupId": 2414022933,
      "groupName": "组名称",
      "keyword": "关键词",
      "keywordId": 42005003180,
      "mavgPosition": "1.00",
      "avgLeftPosition": "0.00",
      "mavgLeftPosition": "1.00",
      "mobileUrl": "http://m.simba.taob.com/",
      "totalCost": "0.75",
      "type": "mobile",
      "url": "http://www.simba.taob.com/",
      "views": "2",
      "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 日期
type string 关键词报告的投放端类型
campaignId string 推广计划ID
campaignName string 推广计划名称
groupId string 推广组ID
groupName string 推广组名称
keywordId string 关键词ID
keyword string 关键词
views string 展现
clicks string 点击
totalCost string 消费
avgPosition string 关键词计算机排名
mavgPosition string 关键词移动排名
avgLeftPosition string 关键词左方排名
mavgLeftPosition string 关键词上方排名
url string pc端url
mobileUrl string 移动端url
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 ""