实时消耗数据
生成展示广告推广组当天实时消耗数据的分小时报告
HTTP请求方式
POST
请求地址
说明
当天数据最新可以获取到上一个小时,具体请参照参数说明。由于报表需要时间生成,如需获取上一个小时的数据,建议延迟15分钟获取
Headers 请求参数
字段 | 类型 | 必须 | 描述 |
---|---|---|---|
Content-Type | string | yes | application/x-www-form-urlencoded |
apiKey | string | yes | 注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken | string | yes | 访问token |
Body 请求参数
字段 | 类型 | 必须 | 描述 |
---|---|---|---|
startDate | date | no | 起始时间,格式为'yyyy-mm-dd hh:00:00',如'2018-01-08 08:00:00',只限查询当天时间段,默认当天0点 |
endDate | date | no | 截至时间,格式为'yyyy-mm-dd hh:00:00',如'2018-0-08 18:00:00',只限查询当天时间段,最大至23点,默认为当天上一个小时整点 |
rowsPerPage | Int | no | 每页返回条数,默认返回所有 |
page | Int | no | 请求的页码,默认为1 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--data 'startDate=STARTDATE&endDate=ENDDATE&rowsPerPage=ROWPERPAGE&page=PAGE' \
'https://api.e.360.cn/display/report/realTimeCost'
返回结果
{
"count": 2,
"cost":[
{
"date": "2018-01-08",
"hour": "0",
"advertiserId": "436764",
"campaignId": "3081276",
"groupId": "29455803",
"creativeId": "95008390",
"views": "31",
"clicks": "0",
"totalCost": "0.00000",
"advertiserName": "广告主名称",
"campaignName": "推广计划名称",
"groupName": "推广组名称",
"creativeName": "创意名称1",
"link": "http://www.360.cn",
"materialUrls": [
"http://s3m.mediav.com/n2ffe78632faheend.jpg"
]
},
{
"date": "2018-01-08",
"hour": "0",
"advertiserId": "436764",
"campaignId": "3081276",
"groupId": "29455803",
"creativeId": "95008390",
"views": "31",
"clicks": "0",
"totalCost": "0.00000",
"advertiserName": "广告主名称",
"campaignName": "推广计划名称",
"groupName": "推广组名称",
"creativeName": "创意名称2",
"link": "http://www.360.cn",
"materialUrls": [
"http://s3m.mediav.com/n2ffe78632faheend.jpg"
]
}
]
}
返回结果说明
字段 | 类型 | 描述 |
---|---|---|
count | int | 返回记录总条数 |
cost | array | 消耗数据数组 |
date | string | 日期 |
hour | string | 小时整点 |
advertiserId | string | 展示广告系统里的广告主ID |
campaignId | string | 推广计划ID |
groupid | string | 推广组ID |
creativeId | string | 创意ID |
views | string | 展现 |
clicks | string | 点击 |
totalCost | string | 消耗 |
advertiserName | string | 广告主名称 |
campaignName | string | 推广计划名称 |
groupName | string | 推广组名称 |
creativeName | string | 创意名称 |
link | string | 创意落地页链接 |
materialUrls | array | 素材内容 |