# 预置属性
# 一、所有事件带有的预置属性
各个平台采集的预制属性会有一定的差异,具体可以参考如下文档: Android 平台 、 iOS 平台
小游戏平台所有事件都会带有的预置属性:
属性名 | 中文名 | 属性类型 | 说明 |
---|---|---|---|
#ip | IP 地址 | 文本 | 用户的 IP 地址,TA 将以此获取用户的地理位置信息 |
#country | 国家 | 文本 | 用户所在国家,根据 IP 地址生成 |
#country_code | 国家代码 | 文本 | 用户所在国家的国家代码(ISO 3166-1 alpha-2,即两位大写英文字母),根据 IP 地址生成 |
#province | 省份 | 文本 | 用户所在省份,根据 IP 地址生成 |
#city | 城市 | 文本 | 用户所在城市,根据 IP 地址生成 |
#device_model | 设备型号 | 文本 | 用户设备的型号,如 iPhone 8 等 |
#device_id | 设备 ID | 文本 | 用户的设备 ID,取初始化时生成的 UUID |
#screen_height | 屏幕高度 | 数值 | 用户设备的屏幕高度,如 1920 等 |
#screen_width | 屏幕宽度 | 数值 | 用户设备的屏幕高度,如 1080 等 |
#manufacturer | 设备制造商 | 文本 | 用户设备的制造商,如 Apple,vivo 等 |
#os_version | 操作系统版本 | 文本 | iOS 11.2.2、Android 8.0.0 等 |
#os | 操作系统 | 文本 | 如 Android、iOS 等 |
#network_type | 网络状态 | 文本 | 上传事件时的网络状态,如 WIFI、3G、4G 等 |
#lib | SDK 类型 | 文本 | 您接入 SDK 的类型,如 MG(小游戏) |
#lib_version | SDK 版本 | 文本 | 您接入 SDK 的版本 |
#scene | 场景值 | 数值 | 微信小游戏启动时传入的场景值 |
#mp_platform | 小游戏平台 | 文本 | 标识应用所在的平台 |
#zone_offset | 时区偏移 | 数值 | 数据时间相对 UTC 时间的偏移小时数 |
# 二、自动采集事件的预置属性
以下预置属性,是各个自动采集事件中所特有的预置属性
- 小游戏隐藏(ta_mg_hide)的预置属性
属性名 | 中文名 | 属性类型 | 说明 |
---|---|---|---|
#duration | 事件时长 | 数值 | 表示本次启动 ta_mg_show 到隐藏 ta_mg_hide 的持续时长,单位是秒 |
# 三、获取预制属性
服务端埋点需要 App 端的一些预置属性时,可以通过此方法获取 客户端 端的预置属性,再传给服务端。
//获取属性对象
var presetProperties = ta.getPresetProperties();
//生成事件预置属性
var properties = presetProperties.toEventPresetProperties();
/*
{
"#device_model":"iPhone 5",
"#device_id":"3204487163-1624513721217",
"#screen_width":320,
"#screen_height":568,
"#os":"iOS",
"#os_version":"10.0.1",
"#network_type":"wifi",
"#zone_offset":8,
"#manufacturer":"Apple"
}
*/
//获取某个预置属性
var os = presetProperties.os; //os类型,如Android
var osVersion = presetProperties.osVersion; //系统版本号
var networkType = presetProperties.networkType; //网络类型
var manufacture = presetProperties.manufacture; //设备制造商
var deviceModel = presetProperties.deviceModel; //设备型号
var screenWidth = presetProperties.screenWidth; //屏幕宽度
var screenHeight = presetProperties.screenHeight; //屏幕高度
var deviceId = presetProperties.deviceId; //设备ID
var zoneOffset = presetProperties.zoneOffset; //时区偏移值
IP,国家城市信息由服务端解析生成,客户端不提供接口获取这些属性