菜单

设备展示明细报表

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

使用注意：

TopOn只保留最近30天数据。返回的内容以文件形式提供，如果当时未获取到数据请隔天再重试。不同时区更新数据时间如下：
提前任务各时区数据更新时间点：

1、utc+8：延迟1天，13:00点（utc+8）更新

2、utc+0：延迟1天，14:00点（utc+8）更新

3、utc-8：延迟1天，22:00点（utc+8）更新

1 请求URL

https://openapi.toponad.com/v3/report/device_imp_detail

2 请求方式

GET

3 请求参数

字段	类型	是否必传	备注	样例
day	Int	Y	开始日期，格式：YYYYmmdd	20190501，仅支持1天前的日期
app_id	String	Y	开发者后台的应用ID，单选	xxxxx
timezone	Int	Y	时区支持	-8,8,0三个时区

请求样例：

curl --location --request GET 'https://openapi.toponad.com/v3/report/device_imp_detail? 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 返回参数

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

http://sz-topon-emr-hive.oss-cn-shenzhen.aliyuncs.com/topon-openapi%2Ftopon_report_device_impression_utce8%2Fdt%3D2024-02-22%2Fpublisher_id%3D9993%2Fapp_id%3Da658d368a23640%2Fpart-00000-191f3072-eb3e-4bbc-abe0-6e52f6e3c372.c000.csv?Expires=1709028669&OSSAccessKeyId=LTAI5tKdnC9J6sdUn1SB1ju3&Signature=iFU9HlMzAzwcHD%2FwYksb355Wiok%3D

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

字段	类型	备注
request_id	String	广告请求唯一ID
sdk_time	Int	SDK记录的时间戳，单位毫秒
area	String	国家两字符短码，参考iso国际标准
placement_id	String	广告位ID
nw_firm_id	Int	广告平台的数字ID。具体参考《广告平台ID表》
network_pl_id	String	广告平台的广告位ID信息
ecpm	Decimal(18,6)	展示的ecpm
channel	String	渠道，由开发者通过TopOn SDK传入的渠道
sub_channel	String	子渠道，由开发者通过TopOn SDK传入的子渠道
platform	Int	系统平台，1：android，2：ios
os_vn	String	操作系统版本
idfa	String	iOS的设备ID
idfv	String	iOS的设备ID
gaid	String	Google的广告设备ID
oaid	String	安卓的设备ID
att_status	Int	iOS设备的ATT授权状态： 0：Not determined(未决定是否授权) 1：Restricted (受限制) 2：Denied(已拒绝) 3：Authorize(已授权)
user_id	String	开发者的自定义用户ID
app_custom	String	应用自定义数据(Load时传入的自定义参数)
show_custom_ext	String	展示时传入的自定义参数

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

大纲