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

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