报告级API接口
报告级的 API 接口,需要用户参数、应用参数和报告参数,所需参数、获取数据与 百度移动统计 站点的报告数据一致,具体接口如下:
接口
https://openapi.baidu.com/rest/2.0/mtj/svc/app/getDataByKey
参数说明:
每个查询均需要用户参数,应用参数,报告参数三个分类的参数,其中标记为必须的,每个查询都需要带有。
用户参数
参数名 | 类型 | 是否必须 | 描述 | 样例 |
---|---|---|---|---|
access_token | string | 是 | 用户登入后获取的token | 1.a6b7dbd428f731035f771b8d15063f61.86400.1292922000-2346678-124328 |
应用参数
参数名 | 类型 | 是否必须 | 描述 | 样例 |
---|---|---|---|---|
key | string | 是 | 应用KEY,MTJ 站点 APPKEY | 4b**9c |
报告参数
报告参数包括但不限于以下参数列表,具体每个报表所支持的参数见每个报表的说明。
参数名 | 类型 | 是否必须 | 描述 | 样例 |
---|---|---|---|---|
method | string | 是 | 查询的报告数据接口,每个报告不同 | newuser/a |
metrics | string | 是 | 以逗号分隔的需要查询的指标,具体每个报告的指标见报告说明 | user_count |
gran | string | 否 | 查询数据的时间粒度,只支持有该参数的报告,取值为day/hour/week/month,每个报告可取值不同 | day |
start-date | string | 是 | 查询的起始时间 | 20170501000000 |
end-date | string | 是 | 查询的结束时间 | 20170530235959 |
start-date2 | string | 否 | 对比查询的起始时间,对支持对比查询的报表有效 | 20170501000000 |
end-date2 | string | 否 | 对比查询的结束时间,对支持对比查询的报表有效 | 20170530235959 |
channel | string | 否 | 以逗号拼接的渠道号(最多20位数字),作为渠道筛选 | 13843091911868416,3329055359020040241 |
version | string | 否 | 以都厚拼接的版本号(最多20位数字),作为版本筛选 | 13561604050255872,3328210947783339568 |
start-index | uint | 否 | 获取数据偏移,用于分页,默认为0 | 20 |
max-results | uint | 否 | 单次调用获取的数据条数,默认是20 | 20 |
返回格式
请求的报告返回格式每个报告基本相同,主要由以下几部分组成
参数名 | 参数类型 | 描述 |
---|---|---|
data | ReportData | 报告数据 |
status | int | 状态 |
msg | string | 信息 |
其中,ReportData对应的结构为:
参数名 | 参数类型 | 描述 |
---|---|---|
fields | array of string | 指标列表 |
sum | array of string | 总计数据 |
items | array | 指标数据,由4部分构成(0:首列数据,1:指标数据,2:对比时间段数据,3:变化率数据) |
total | uint | 总计条目 |