市级地域报告列表


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

HTTP请求方式

POST

请求地址

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

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。all表示查询全部投放端数据,mobile表示移动,computer表示计算机
page int No 返回结果的页码,默认为1,表示返回第一页。每次查询数据最多返回1000条明细,如超过,需要指定page进行分页查询
参数备注
1 type不传或type=all ,computer,mobile会被聚合,如果在两种投放都展现则同一条物料为1条数据
2 建议按type=computer,type=mobile 分别取数据
3 建议分日进行取数据 (既startDate=endDate),如果取多天数据分为多次请求
4 每页数据1000条
请求示例
curl -X POST \ 
--header 'apiKey:APIKEY' \ 
--header 'accessToken:ACCESSTOKEN' \ 
--data 'startDate=2019-02-01&endDate=2019-03-01&type=all&page=1' \ 
'https://api.e.360.cn/dianjing/report/city'
返回结果
{
  "cityList": [
    {
      "areaType": "1",
      "campaignId": 3854641979,
      "campaignName": "推广计划名称",
      "cityId": "108",
      "cityName": "城市名称",
      "clicks": "0",
      "date": "2021-05-01",
      "groupId": 451035933,
      "groupName": "推广组名称",
      "provinceId": "11",
      "provinceName": "所属省份名称",
      "totalCost": "0.00",
      "type": "computer",
      "views": "1"
    }
  ]
}
返回结果说明
字段 类型 描述
date string 日期
areaType string 地域类型:1地理,2意图
campaignId string 推广计划ID
campaignName string 推广计划名称
groupId string 推广组ID
groupName string 推广组名称
cityId string 城市ID
cityName string 城市名称
provinceId string 所属省份ID
provinceName string 所属省份名称
views string 展现
clicks string 点击
totalCost string 消费
type string 关键词报告的投放端类型

results matching ""

    No results matching ""