设备层级数据报告 API
修订历史#
| 文档版本 | 发布时间 | 修订说明 |
|---|---|---|
| v4.0 | 2022-9-15 | 设备层级API支持TP预估收入查询 |
| v3.0 | - | 设备层级API支持自定义用户ID维度查询 |
| v2.0 | - | 支持设备层级数据查询 |
注意事项
- 接口会返回四个可供下载csv文件的url,有效时长15min，超过有效时长,请重新获取
- 四个csv文件对应我们四个计算中心的计算结果，汇总即为所有数据
- 由于用户分布不同，会存在某个计算中心没有对应数据，属于正常情况
因三方广告网络API存在数据时区问题，为确保数据的一致性，可以当天请求前天的数据，或者每次请求前两天数据进行数据覆盖刷新- 不支持获取一年前的历史数据，若有需要请联系您的客户经理。
- v4.0 Api 仅提供 2022-09-12 号及以后的报表数据
各时区数据更新时间点：
- UTC+8：5点(北京时间)
- UTC+0：15点(北京时间)
- UTC-8：次日2点(北京时间)
1. 接口校验#
1.1 协议#
1.2 Header公共请求参数#
需要在头部加入 Authorization: Bearer {your token}
| 参数 | 说明 | 样例 |
|---|---|---|
| Authorization | 授权信息 | Bearer {your token} |
2. 设备层级数据报告 API v4.0#
2.1 URL#
2.2 请求协议#
2.3请求参数#
| 参数名 | 类型 | 是否必传 | 备注 | 样例 |
|---|---|---|---|---|
| date | String | Y | 日期，格式：YYYY-mm-dd，仅支持单天 | 2020-03-01 |
| timezone | String | N | 时区，枚举值，仅支持："UTC+8"、"UTC+0"、"UTC-8"。不传默认为"UTC+0" | UTC+8 |
| currency | String | N | 币种：不传默认USD 仅支持USD CNY | USD |
| appId | String | Y | 平台中应用ID，单选 |
2.4 返回参数#
| 字段 | 类型 | 备注 |
|---|---|---|
| dateTimeStamp | int | 时间戳（日期） |
| appId | String | 应用ID （tradplus） |
| placementId | String | 广告位ID （tradplus） |
| placementName | String | 广告位名字（tradplus） |
| adFormat | Int | 广告位类型 |
| adFormatName | String | 广告位类型名字 |
| area | String | 国家地区编码(ISO 3166-1二位国家地区代码) |
| network | Int | 广告网络ID |
| networkName | String | 广告网络名字 |
| networkPlacementId | String | 广告网络的广告位ID信息 |
| networkPlacementName | String | 广告网络的广告源名称 （tradplus） |
| networkPlacementInfo | String | 广告网络的广告位详细信息 |
| androidId | String | 设备ID，androidid |
| gaid | String | Google的广告设备ID |
| idfa | String | iOS的设备ID |
| userId | String | 用户自定义上传的Custom User ID |
| channel | String | 渠道 |
| sub_channel | String | 子渠道 |
| impression | Int | 展示数（tradplus） |
| click | Int | 点击数（tradplus） |
| revenue | Float | 收益 |
| ecpm | Float | 千次展示收益 |
| oaid | String | Android设备标识符 |
| idfv | String | 应用开发商标识符 |
| os_version | String | 终端os版本 |
| att_status | Int | 苹果ATT状态 (0:用户未决定; 1:受限制的; 2:拒绝的; 3:授权的) |
| tp_revenue | Float | TP预估收益 |
2.5 样例#
请求样例：#
响应样例：#
3. 设备层级数据报告 API v3.0#
3.1 URL_V3#
3.2 请求协议_V3#
3.3请求参数_V3#
| 参数名 | 类型 | 是否必传 | 备注 | 样例 |
|---|---|---|---|---|
| date | String | Y | 日期，格式：YYYY-mm-dd，仅支持单天 | 2020-03-01 |
| timezone | String | N | 时区，枚举值，仅支持："UTC+8"、"UTC+0"、"UTC-8"。不传默认为"UTC+0" | UTC+8 |
| currency | String | N | 币种：不传默认USD 仅支持USD CNY | USD |
| appId | String | Y | 平台中应用ID，单选 |
3.4 返回参数_V3#
| 字段 | 类型 | 备注 |
|---|---|---|
| dateTimeStamp | int | 时间戳（日期） |
| appId | String | 应用ID （tradplus） |
| placementId | String | 广告位ID （tradplus） |
| placementName | String | 广告位名字（tradplus） |
| adFormat | Int | 广告位类型 |
| adFormatName | String | 广告位类型名字 |
| area | String | 国家地区编码(ISO 3166-1二位国家地区代码) |
| network | Int | 广告网络ID |
| networkName | String | 广告网络名字 |
| networkPlacementId | String | 广告网络的广告位ID信息 |
| networkPlacementName | String | 广告网络的广告源名称 （tradplus） |
| networkPlacementInfo | String | 广告网络的广告位详细信息 |
| androidId | String | 设备ID，androidid |
| gaid | String | Google的广告设备ID |
| idfa | String | iOS的设备ID |
| userId | String | 用户自定义上传的Custom User ID |
| channel | String | 渠道 |
| sub_channel | String | 子渠道 |
| impression | Int | 展示数（tradplus） |
| click | Int | 点击数（tradplus） |
| revenue | Float | 收益 |
| ecpm | Float | 千次展示收益 |
| oaid | String | Android设备标识符 |
| idfv | String | 应用开发商标识符 |
| os_version | String | 终端os版本 |
| att_status | Int | 苹果ATT状态 (0:用户未决定; 1:受限制的; 2:拒绝的; 3:授权的) |