跳到主要内容

RTB 效果相关 API(前贴片适用)

数据报表相关 API​

功能描述:目前仅提供 RTB 效果数据按天统计的报表查询。

1.RTB 效果数据查询​

接口:adreport/rtbeffect

请求字段:

名称类型必填描述
pageintN当前页码,可以为空,默认值1
sizeintN每页条数,可以为空,默认值100,最大1000
data对象类型N可以为空

data 内容详细:

名称类型必填描述
start_datestringN开始日期,格式 Ymd(20190201),默认取当天
end_datestringN开结束日期,格式 Ymd(20190201),默认取当天

接口返回:

名称类型描述
ret_codeint返回码
ret_msg对象类型返回内容
error_codeint错误补充码

ret_msg 内容详细:

名称类型描述
totalint总共条数
data数组类型详细数据

data 内容详细:

名称类型描述
datestring日期
order_idstring订单ID
location_idstring广告位ID
location_namestring广告位名称
clientstring客户名称
amountfloat消耗金额
pvint曝光
clickint点击
bid_sucint竞价成功
bid_faiint竞价失败
bid_invint无效竞价
bid_allint请求出价

请求示例:

{
"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天,默认情况下数据保留半年。