跳到主要内容

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