菜单

展示、点击设备维度报表

注意:接入Api前请先熟悉api签名机制(参考接口鉴权说明), 即Api请求样例中的一些http请求头的来源

使用注意:

  • 数据支持的时间从Taku运营开通权限后开始支持生成(例如1号开通权限,最早2号才能拉取到某些时区数据,具体时间参考下面的提前任务各时区数据更新时间点),并且只保留最近30天数据。返回的内容以文件形式提供,如果当时未获取到数据请隔天再重试。注意:Taku每天生成各个时区数据任务会执行两次,一次为提前任务,一次为兜底任务,提前任务的收益数据可能不完整(决定因素是不同广告平台出报表数据时间不一样,某些广告平台提前任务时可能还没有出报表数据),开发者可根据需要再拉一次兜底任务后数据
  • 提前任务各时区数据更新时间点:

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)更新

1 请求URL

https://openapi.toponad.com/v3/devicereport

2 请求方式

GET

3 请求参数

字段类型是否必传备注样例
dayIntY开始日期,格式:YYYYmmdd20190501,仅支持1天前的日期
app_idStringY开发者后台的应用ID,单选xxxxx
timezoneIntN时区支持-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'

4 返回参数

此接口返回报表数据的下载链接,开发者获取此链接后,可直接在浏览器中下载报表数据。链接格式如下:

https://topon-openapi.s3.amazonaws.com/topon_report_device/dt%3D2019-07-10/publisher_id%3D22/app_id%3Da5d147334b3685/000000_0?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA35FGARBHLHHS7TWB%2F20190828%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20190828T095315Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=6aaf947f9b2cf02f3acb49d64a3daf719cb0b57a3d5221b0121a006e58b04b10

文件以csv形式提供,用","作为分隔符,具体参数内容如下:

字段类型备注
placement_idString广告位ID
placement_nameString广告位名称
placement_formatString0: native,1: rewarded_video,2: banner,3: interstitial,4: splash
android_idString设备ID,androidid
gaidStringGoogle的广告设备ID
idfaStringiOS的设备ID
areaString国家
impressionString展示数
clickString点击数
revenuedecimal(18,6)收益,根据三方广告平台的收益对设备层级进行拆分,货币单位同开发者后台配置一致
ecpmdecimal(18,6)Taku基于收益API按设备展示拆分后的收益和Taku统计的设备展示计算出eCPM,计算公式:(设备收益/Taku统计的设备展示)*1000。注:eCPM延迟2天提供
is_abtestString对照组或测试组 0 表示对照组或未开通A/B测试 1 表示测试组
traffic_group_idString对照组或测试组id
segment_idString流量分组ID
segment_nameString流量分组名称
idfvStringiOS的设备ID
oaidString安卓的设备ID
user_idString开发者的自定义用户ID
network_firm_idString广告平台ID
network_firmString广告平台名称
currencyString开发者账号币种,USD表示美元,CNY表示人民币
os_versionString设备的操作系统版本
att_statusStringiOS设备的ATT授权状态:
0:Not determined(未决定是否授权)
1:Restricted (受限制)
2:Denied(已拒绝)
3:Authorize(已授权)
imeiString安卓的设备识别码
device_typeString设备类型,枚举值说明:
0: 非IOS设备
1: iphone
2: ipad
brandString设备品牌名
modelString设备型号
app_vnString应用版本名
app_vcString应用版本号
new_user_typeString新用户类型,枚举值说明:
1: 是新用户
2: 不是新用户
channelString渠道,由开发者通过Taku SDK传入的渠道
estimate_revenuedecimal(18,6)预估收益,竞价广告源以实时的广告展示价格汇总得出预估收益,非竞价广告源以人工填写的eCPM价格 * Taku统计的展示汇总得出预估收益, 单位美元
cny_estimate_revenuedecimal(18,6)预估收益,竞价广告源以实时的广告展示价格汇总得出预估收益,非竞价广告源以人工填写的eCPM价格 * Taku统计的展示汇总得出预估收益, 单位人民币
set_gaidString用户自定义上传的Google的广告设备ID
set_imeiString用户自定义上传的安卓的设备识别码
set_oaidString用户自定义上传的安卓的设备ID
set_idfaString用户自定义上传的iOS的设备ID
amazon_idStringamazon设备ID(sdk6.2.50及以上版本支持),android系统独有
sub_channelString子渠道,由开发者通过SDK传入的子渠道


最近修改: 2025-09-05Powered by