报表数据
根据媒体 token 获取报表数据, 需要先申请 密钥
请求地址及方法
- 请求接口地址: https://api.mobrtb.com/reports/媒体token
- 请求方法为 HTTP GET
请求内容
签名
签名的生成规则如下:
hex(md5(密钥 + query))
其中,query
是 URL 中 ?
之后的字符串。 例如,若 URL 为 /report/F3486598CC4A4A7B882957703E644824?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 | 起始日期 | 必选 | YYYY-MM-DD | 2018-09-09 |
to | 结束日期 | 必选 | YYYY-MM-DD | 2018-09-09 |
monetizer_app_token | 媒体应用 token,可选, 从新义管理后台获取 | 可选 | 32 位字符串 | F3486598CC4A4A7B882957703E644824 |
monetizer_app_ad_unit_token | 媒体应用广告位 token,可选, 从新义管理后台获取 | 可选 | 32 位字符串 | F3486598CC4A4A7B882957703E644824 |
group_by | 返回报表数据的维度,可按日期、媒体应用、媒体应用广告位分组 | 可选 | date 、monetizer_app_token 、monetizer_app_ad_unit_token | date |
响应
字段名称 | 描述 | 类型 | 示例值 |
---|---|---|---|
requests | 请求次数 | 整数 | 1 |
impressions | 曝光次数 | 整数 | 1 |
clicks | 点击次数 | 整数 | 1 |
income | 收入 | 浮点数 | 1.0 |
date | 日期(可能为空,根据 group_by 而定) | 字符串 | 20180909 |
monetizer_app_token | 媒体应用 token(可能为空,根据 group_by 而定) | 字符串 | F3486598CC4A4A7B882957703E644824 |
monetizer_app_ad_unit_token | 媒体应用广告位 token(可能为空,根据 group_by 而定) | 字符串 | F3486598CC4A4A7B882957703E644824 |