1、utc+8:延迟1天,下午11:30点(utc+8)更新
2、utc+0:延迟1天,下午5:30点(utc+8)更新
3、utc-8:延迟2天,上午1:30点(utc+8)更新
1、utc+8:延迟2天,上午4点(utc+8)更新
2、utc+0:延迟2天,上午12点(utc+8)更新
3、utc-8:延迟3天,上午4点(utc+8)更新
https://openapi.toponad.com/v3/devicereport
GET
字段 | 类型 | 是否必传 | 备注 | 样例 |
---|---|---|---|---|
day | Int | Y | 开始日期,格式:YYYYmmdd | 20190501,仅支持1天前的日期 |
app_id | String | Y | 开发者后台的应用ID,单选 | xxxxx |
timezone | Int | N | 时区支持 | -8,8,0三个时区 |
请求样例:
curl --location --request GET 'https://openapi.toponad.com/v3/devicereport? app_id=a606c22b789bc3&day=20210823&timezone=8' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0===b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626056011000' \
--header 'Content-Type: application/json'
此接口返回报表数据的下载链接,开发者获取此链接后,可直接在浏览器中下载报表数据。链接格式如下:
文件以csv形式提供,用","作为分隔符,具体参数内容如下:
字段 | 类型 | 备注 |
---|---|---|
placement_id | String | 广告位ID |
placement_name | String | 广告位名称 |
placement_format | String | 0: native,1: rewarded_video,2: banner,3: interstitial,4: splash |
android_id | String | 设备ID,androidid |
gaid | String | Google的广告设备ID |
idfa | String | iOS的设备ID |
area | String | 国家 |
impression | String | 展示数 |
click | String | 点击数 |
revenue | decimal(18,6) | 收益,根据三方广告平台的收益对设备层级进行拆分,货币单位同开发者后台配置一致 |
ecpm | decimal(18,6) | Taku基于收益API按设备展示拆分后的收益和Taku统计的设备展示计算出eCPM,计算公式:(设备收益/Taku统计的设备展示)*1000。注:eCPM延迟2天提供 |
is_abtest | String | 对照组或测试组 0 表示对照组或未开通A/B测试 1 表示测试组 |
traffic_group_id | String | 对照组或测试组id |
segment_id | String | 流量分组ID |
segment_name | String | 流量分组名称 |
idfv | String | iOS的设备ID |
oaid | String | 安卓的设备ID |
user_id | String | 开发者的自定义用户ID |
network_firm_id | String | 广告平台ID |
network_firm | String | 广告平台名称 |
currency | String | 开发者账号币种,USD表示美元,CNY表示人民币 |
os_version | String | 设备的操作系统版本 |
att_status | String | iOS设备的ATT授权状态: 0:Not determined(未决定是否授权) 1:Restricted (受限制) 2:Denied(已拒绝) 3:Authorize(已授权) |
imei | String | 安卓的设备识别码 |
device_type | String | 设备类型,枚举值说明: 0: 非IOS设备 1: iphone 2: ipad |
brand | String | 设备品牌名 |
model | String | 设备型号 |
app_vn | String | 应用版本名 |
app_vc | String | 应用版本号 |
new_user_type | String | 新用户类型,枚举值说明: 1: 是新用户 2: 不是新用户 |
channel | String | 渠道,由开发者通过Taku SDK传入的渠道 |
estimate_revenue | decimal(18,6) | 预估收益,竞价广告源以实时的广告展示价格汇总得出预估收益,非竞价广告源以人工填写的eCPM价格 * Taku统计的展示汇总得出预估收益, 单位美元 |
cny_estimate_revenue | decimal(18,6) | 预估收益,竞价广告源以实时的广告展示价格汇总得出预估收益,非竞价广告源以人工填写的eCPM价格 * Taku统计的展示汇总得出预估收益, 单位人民币 |
set_gaid | String | 用户自定义上传的Google的广告设备ID |
set_imei | String | 用户自定义上传的安卓的设备识别码 |
set_oaid | String | 用户自定义上传的安卓的设备ID |
set_idfa | String | 用户自定义上传的iOS的设备ID |
amazon_id | String | amazon设备ID(sdk6.2.50及以上版本支持),android系统独有 |
sub_channel | String | 子渠道,由开发者通过SDK传入的子渠道 |