Device结构
| 字段 | 类型 | 说明 | 示例 | 是否必填 |
|---|---|---|---|---|
| ip | string | 设备 IP 地址，请务必传递客户端真实的 IP 地址，不能传递服务端或者私有 ip | 110.23.43.29 | 是 |
| user_agent | string | 客户端webview User-Agent | 是 | |
| idfa | string | IOS6.0及以上的idfa号明文，长度36位，英文字母或阿拉伯数字，英文字母大写；由五组字符组成，"-"连接，第一组8个字符，第二、三、四组4个字符，第五组12个字符； | E7DD2AC6- CA04-460C- 926F-B77B6 0CB3DDC | IOS设备可获取时必填，不可获取时不传，不可填默认值 |
| ali_aaid | string | 阿里巴巴匿名设备标识，需集成阿里 SDK 获取，具体咨询商务获取 SDK 信息。 | 660FA84D-3BE3-AA98-4D79-C078A878D7DC | IOS 可获取时设备必填 |
| caid | string | 阿里巴巴匿名设备标识，需集成阿里 SDK 获取，具体咨询商务获取 SDK 信息。 | 660FA84D-3BE3-AA98-4D79-C078A878D7DC | IOS 可获取时设备必填 |
| imei | string | 安卓设备的imei号明文，长度15-17位，数字或字符；如果是安卓设备，imei和imei_md5两个字段中必须且只能填写一个；当无法获取时不传 | 864892024829751 | 安卓设备 imei 和 imei_md5 两 者至少填一个；IOS设备勿填 |
| imei_md5 | string | 原始imei转大写之后的的md5值，大写形式；如果是安卓设备，imei和imei_md5两个字段中必须且只能填写一个；当无法获取时不传，不可填默认值 | 安卓设备 imei 和 imei_md5 两 者至少填一个；IOS设备勿填 | |
| oaid 1 | string | 安卓设备 Android Q 级以上版本的设备号，明文形式 | faffffdf-d7fe -8550-bfef-3 ffcffee0ac2 | 运行于Android Q以上版本的APP必传 |
| mac | string | 设备的 mac 地址，大写明文(保留冒号); mac 和 mac_md5 两个字段只能填写一个。 | OTT 设备必填 | |
| mac_md5 | string | 原始 mac 去冒号转大写之后的 md5 值， 大写形式; | 否 | |
| android_id | string | android_id | 否 | |
| device_type | int32 | 设备类型 0-手机;1-平板;2-PC;3-互联网电视 | 是 | |
| brand | string | 设备品牌 | Samsung | 是 |
| model | string | 设备型号 | galaxy | 是 |
| os | string | 操作系统 | Android,iOS | 是 |
| osv | string | 操作系统版本 | 7.0 | 是 |
| network | int32 | 设备所处网络环境 0-未识别,1-wifi,2-2g,3-3g,4-4g,5-5g | 是 | |
| operator | int32 | 设备的网络运营商 0-未知,1-移动,2-联通,3-电信 | 否 | |
| width | int32 | 设备屏幕尺寸:宽 | 否 | |
| height | int32 | 设备屏幕尺寸:高 | 否 | |
| pixel_ratio | int32 | 设备密度 | 否 | |
| orientation | int32 | 屏幕方向 0-未知,1-竖屏,2-横屏 | 否 | |
| timezone_offset | int32 | 用户所处时区的分钟偏移量 例如：如果是东八区，则timezone_offset=60x8=480 | 否 | |
| geo | object | 地理位置信息 | 否 | |
| boot_mark | string | 相关问题请咨询阿里集团媒介商务 | 取原值回传 iOS：1623815045.970028；Android：ec7f4f33-411a-47bc-8067-744a4e7e0723 | 是 |
| update_mark | string | 相关问题请咨询阿里集团媒介商务 | 取原值回传 iOS：1581141691.570419583 Android：1004697.709999999 | 是 |
[warning]关于设备号无法获取时的处理说明
由于系统或用户隐私设置等原因，部分设备的设备号可能无法正常获取。当获取不到，或者获取到系统相同值时（请关注客户端获取设备号方法的返回值），请不要使用默认值填写，否则当做非法设备号被认为是无效流量。例如IMEI回传，
null、0、0000000等；MAC获取到02:00:00:00:00:00等均会被反作弊过滤
Geo结构
| 字段 | 类型 | 说明 | 示例 | 是否必填 |
|---|---|---|---|---|
| lat | double | 维度，取值范围[-90.0,+90.0] | 否 | |
| Ion | double | 维度，取值范围[-180.0,+180.0] | 否 |
1. Android Q开始禁止非系统应用访问Device ID（imei），国内安卓设备厂商为开发者提供OAID的替代方案。目前获取OAID有两个渠道：通过厂商接口或移动安全联盟MSA提供的统一SDK ↩