搜索词报告列表


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

HTTP请求方式

POST

请求地址

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

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 选择关键词报告的投放端类型,mobile表示移动,computer表示计算机,如果不传默认将获取到PC数据
page int No 返回结果的页码,默认为1。(每页600条记录)
参数备注
1 此接口必须按 type=computer,type=mobile 分别取数据,默认为computer
2 建议分日进行取数据 (既startDate=endDate),如果取多天数据分为多次请求
3 每页数据600条
请求示例
curl -X POST \ 
--header 'apiKey:APIKEY' \ 
--header 'accessToken:ACCESSTOKEN' \ 
--data 'startDate=2018-08-01&endDate=2018-09-01&type=computer&page=1' \ 
'https://api.e.360.cn/dianjing/report/queryword'
返回结果
{
  "querywordList": [
    {
      "campaignId": 616649213,
      "campaignName": "计划名称",
      "clicks": "0",
      "creativeId": 6459800769,
      "creativeName": "创意标题",
      "date": "2021-06-01",
      "groupId": 1407772156,
      "groupName": "组名称",
      "keyword": "关键词",
      "queryword": "搜索词",
      "totalCost": "0.00",
      "triggerType": "普通短语",
      "views": "4",
      "converts": "1,                 //仅当type!=all时,才有此字段
      "convertsCost": "425.23",       //仅当type!=all时,才有此字段
      "factConverts": "1",            //仅当type!=all时,才有此字段
      "factConvertsCost": "425.23",   //仅当type!=all时,才有此字段
      "ocpcRemarkName": "表单提交",    //仅当type!=all时,才有此字段
      "ocpcExtUrl": ""               //仅当type!=all时,才有此字段
    }
  ]
}
返回结果说明
字段 类型 描述
queryword string 搜索词
keyword string 关键词
triggerType string 触发模式
campaignId string 推广计划ID
campaignName string 推广计划名称
groupId string 推广组ID
groupName string 推广组名称
creativeId string 创意ID
creativeName 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 ""