关键词报告列表
获取关键词报告。通过结算报表接口可以获取最晚到昨天的报表,建议获取时间为第二天的8:30,正常情况8:30之前可以保证生成。如果未生成,接口会返回70109错误码。这类接口不能保证最晚生成时间,最好有识别错误码进行重试的机制。
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/report/keyword
字段 |
类型 |
必须 |
描述 |
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时,才有此字段 |