报表数据

根据广告主 Token 获取报表数据, 需要先申请 密钥

请求地址及方法

请求接口地址: https://api.mobrtb.com/advertisers/:token/reports
请求方法为 HTTP GET

请求内容

签名

签名的生成规则如下：

hex(md5(密钥 + query))

其中，query 是 URL 中 ? 之后的字符串。例如，若 URL 为 /advertisers/F3486598CC4A4A7B882957703E644824/reports?from=2018-09-09&to=2018-10-09，secret 为 123456，则签名为：

hex(md5(123456from=2018-09-09&to=2018-10-09)) = c96bd9031e1edeb8d589b533b2be7805

签名需要写入 HTTP 头部字段 X-SIGNATURE。

查询参数

参数名称	描述	是否必选	格式	示例值
from	起始日期, 与结束日期之间不能超过31天	必选	`YYYY-MM-DD`	`2018-09-09`
to	结束日期, 与开始日期之间不能超过31天	必选	`YYYY-MM-DD`	`2018-09-09`
group_by	指定数据分组维度, 支持通过 `group_by=date&group_by=advertiser_income_report_key` 传入多个	可选, 默认分组 (`date`,`advertiser_income_report_key`)	`date`: 日期、`advertiser_income_report_key`: 渠道号、`dsp_campaign_id`: 计划 ID	`date`

响应

字段名称	描述	类型	示例值
date	日期	字符串	`20180909`
advertiser_income_report_key	渠道号	字符串	`ch_1`
dsp_campaign_id	计划 ID	整数	`1`
dsp_campaign_name	计划名称	字符串	`计划1`
cost	消耗	浮点型	`100.00`
impression	曝光	整数	`1`
click	点击	整数	`2`
callback	转化	整数	`3`
ctr	点击/曝光	浮点型	`0.10`
cvr	转化/点击	浮点型	`0.10`
cost_per_callback	转化成本, 消耗/转化	浮点型	`0.10`