ae-tracking 0.1.0

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/layaair//350/277/233/351/230/266/346/214/207/345/215/227//351/242/204/347/275/256/345/261/236/346/200/247.md

@@ -0,0 +1,254 @@
+---
+code: laya_sdk_preset_properties
+name: "预置属性"
+wikiToken: KybfwOR2UiL2AMkVR0ZcNtMbn7e
+parentWikiToken: EksTw8Wpci1LZ8kWmAdcJp4DnyC
+updateTime: 1751965908000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=laya_sdk_preset_properties
+---
+# 预置属性
+
+#### 一、所有事件带有的预置属性
+
+<!-- unsupported block: 34 -->
+
+各个平台采集的预置属性会有一定的差异，具体可以参考如下文档: Android平台 、 iOS平台  
+
+**小游戏平台所有事件都会带有的预置属性:**
+
+**属性名**
+
+**中文名**
+
+**属性类型**
+
+**说明**
+
+#ip
+
+IP 地址
+
+文本
+
+用户的 IP 地址，AE 将以此获取用户的地理位置信息
+
+#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_mp_show）的预置属性
+**属性名**
+
+**中文名**
+
+**属性类型**
+
+**说明**
+
+#url_path
+
+页面路径
+
+文本
+
+小程序启动被展示页面的路径
+
+#start_reason
+
+应用启动来源
+
+文本
+
+内容为JSON字符串，是从`getLaunchOptionsSync`接口获取的参数
+
+- 小游戏隐藏（ta_mg_hide）的预置属性
+**属性名**
+
+**中文名**
+
+**属性类型**
+
+**说明**
+
+#duration
+
+事件时长
+
+数值
+
+表示本次启动 `ta_mg_show` 到隐藏 `ta_mg_hide` 的持续时长，单位是秒
+
+#### 三、获取预置属性
+
+服务端埋点需要 App 端的一些预置属性时，可以通过此方法获取 客户端 端的预置属性，再传给服务端。
+
+```
+//获取属性对象
+TDAnalytics.getPresetPropertiesAsync((presetProperties)=>{
+    //生成事件预置属性
+    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.manufacturer;//设备制造商
+var deviceModel=presetProperties.deviceModel;//设备型号
+var screenWidth=presetProperties.screenWidth;//屏幕宽度
+var screenHeight=presetProperties.screenHeight;//屏幕高度
+var deviceId=presetProperties.deviceId;//设备ID
+var zoneOffset=presetProperties.zoneOffset;//时区偏移值
+```
+
+<!-- unsupported block: 34 -->
+
+IP，国家城市信息由服务端解析生成，客户端不提供接口获取这些属性