oCPC报表列表
获取oCPC报表列表。通过结算报表接口可以获取最晚到昨天的报表,建议获取时间为第二天的8:30,正常情况8:30之前可以保证生成。如果未生成,接口会返回70109错误码。这类接口不能保证最晚生成时间,最好有识别错误码进行重试的机制。
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/report/Ocpc
字段 |
类型 |
必须 |
描述 |
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进行分页查询 |
groupDay |
String |
No |
时间分组类型,day表示分日 hour表示分小时 day_hour表示分小时分日,默认day |
参数备注 |
|
1 |
type不传或type=all ,computer,mobile不会被聚合,如果在两种投放都展现则同一条物料为两条数据 |
2 |
每页数据1000条 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'startDate="2019-12-05"&endDate="2019-12-12"' \
'https://api.e.360.cn/dianjing/report/Ocpc'
返回结果
{
"data": [
{
"campaignId": "2615650892",
"campaignName": "测试计划2",
"clicks": "12",
"converts": "22",
"date": "2020-01-02",
"factConverts": "3",
"ocpcDataSource": "2",
"ocpcDataSourceName": "API回传",
"ocpcId": "32",
"ocpcName": "oCPC投放包2",
"ocpcRemark": "SHOP_BUTTON,ADVISORY,APP_RETENTION",
"ocpcRemarkName": "购买按钮点击,一句话咨询,APP次留",
"ocpcStage": "2",
"ocpcStageName": "第二阶段",
"totalCost": "6.02",
"type": "mobile",
"views": "26",
"ocpcExtUrl": "http://so.com",
"hour":"10"
}
]
}
返回结果说明
字段 |
类型 |
描述 |
date |
string |
日期,当groupDay=hour或day_hour时没有此字段 |
campaignId |
string |
推广计划ID |
campaignName |
string |
推广计划名称 |
ocpcId |
string |
oCPC投放包ID |
ocpcName |
string |
oCPC投放包名称 |
ocpcStage |
string |
投放阶段 |
ocpcStageName |
string |
投放阶段名称 |
ocpcDataSource |
string |
转化数据来源ID |
ocpcDataSourceName |
string |
转化数据来源名称 |
ocpcRemark |
string |
转化类型 |
ocpcRemarkName |
string |
转化类型名称 |
views |
string |
展示 |
clicks |
string |
点击 |
totalCost |
string |
消费 |
converts |
string |
转化数 |
factConverts |
string |
转化数(计费时间) |
type |
string |
流量范围 |
ocpcExtUrl |
string |
快投放url |
hour |
string |
小时,仅在groupDay=hour或day_hour时才有此字段 |