数据报表相关API
功能描述:目前仅提供RTB效果数据按天统计的报表查询。
1.RTB效果数据查询
接口:adreport/rtbeffect
请求字段:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
page | int | N | 当前页码,可以为空,默认值1 |
size | int | N | 每页条数,可以为空,默认值100,最大1000 |
data | 对象类型 | N | 可以为空 |
data内容详细:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
start_date | string | N | 开始日期,格式 Ymd(20190201),默认取当天 |
end_date | string | N | 开结束日期,格式 Ymd(20190201),默认取当天 |
接口返回:
名称 | 类型 | 描述 |
---|---|---|
ret_code | int | 返回码 |
ret_msg | 对象类型 | 返回内容 |
error_code | int | 错误补充码 |
ret_msg内容详细:
名称 | 类型 | 描述 |
---|---|---|
total | int | 总共条数 |
data | 数组类型 | 详细数据 |
data 内容详细:
名称 | 类型 | 描述 |
---|---|---|
date | string | 日期 |
order_id | string | 订单id |
location_id | string | 广告位id |
location_name | string | 广告位名称 |
client | string | 客户名称 |
amount | float | 消耗金额 |
pv | int | 曝光 |
click | int | 点击 |
bid_suc | int | 竞价成功 |
bid_fai | int | 竞价失败 |
bid_inv | int | 无效竞价 |
bid_all | int | 请求出价 |
请求示例:
{
"page": 1,
"size": 100,
"data":
{
"start_date":"20190201",
"end_date":"20190203"
}
}
返回示例:
{
"ret_code":0,
"ret_msg":{
"total":39,
"data":[
{
"date":"2019-02-01",
"order_id":"20190201001",
"location_id":"App_Stream_news_news",
"location_name":"新闻客户端-信息流广告",
"client":"北京腾讯文化",
"amount":9.36,
"pv":1859,
"click":10,
"bid_suc":24898,
"bid_fai":0,
"bid_inv":11476,
"bid_all":36374
},
{
"date":"2019-02-03",
"order_id":"20190203001",
"location_id":"App_Cmt_news_news",
"location_name":"新闻客户端-评论页半屏广告",
"client":"上海腾讯科技",
"amount":0,
"pv":0,
"click":0,
"bid_suc":0,
"bid_fai":0,
"bid_inv":0,
"bid_all":0
}
]
},
"error_code":0
}
注意: 传入参数开始时间结束时间间隔不能大于90天,默认情况下数据保留半年。