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/unity//350/277/233/351/230/266/346/214/207/345/215/227//345/256/236/346/227/266/350/260/203/350/257/225.md

@@ -0,0 +1,53 @@
+---
+code: unity_sdk_debug
+name: "实时调试"
+wikiToken: PfJ0wKFici1b8Qkh2TMchJT3njh
+parentWikiToken: BMYXwREPHidgIokPXd3cibSdnqe
+updateTime: 1764143376000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=unity_sdk_debug
+---
+# 实时调试
+
+在SDK接入过程中，您可以通过查看SDK在IDE控制台中的日志或者使用 AE 的Debug功能，进行实时调试。
+
+### 一、打印SDK日志
+
+```
+// 开启打印数据Log
+TDAnalytics.EnableLog(true);
+```
+
+<!-- unsupported block: 34 -->
+
+打开日志后，可以在IDE中过滤 TDAnalytics 相关的日志来观察 SDK 的数据上报。
+
+### 二、开启Debug模式
+
+开启Debug模式需要如下两步操作:
+
+1. 客户端开启Debug模式
+以下是客户端开启Debug模式的示例代码:
+
+```
+/*
+设置运行模式为 Debug 模式
+NORMAL模式:数据会存入缓存，并依据一定的缓存策略上报,默认为NORMAL模式；建议在线上环境使用
+Debug模式:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
+DebugOnly模式:只对数据做校验，不会入库；不建议在线上环境使用
+ */
+TDConfig tdConfig = new TDConfig(appId, serverUrl);
+tdConfig.mode = TDMode.Debug;
+TDAnalytics.Init(tdConfig);
+```
+
+1. AE 后台添加Debug设备
+为了避免 Debug 模式在生产环境上线，规定只有指定的设备才能开启 Debug 模式。只有在客户端开启了 Debug 模式，并且设备 ID 在 AE 后台的"埋点管理"页的"Debug 数据"板块中配置了的设备才能开启 Debug 模式。
+
+设备 ID 可以通过以下三种方式获取：
+
+- AE 平台中事件数据中的 #device_id 属性
+- 客户端日志：SDK 初始化完成后会打印设备 DeviceId
+- 通过实例接口调用：获取设备ID
+<!-- unsupported block: 34 -->
+
+Debug 模式可能会影响数据采集质量和 App 的稳定性，只用于集成阶段数据验证，不要在线上环境使用。

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/unity//350/277/233/351/230/266/346/214/207/345/215/227//350/207/252/345/212/250/351/207/207/351/233/206.md

@@ -0,0 +1,156 @@
+---
+code: unity_sdk_autotrack
+name: "自动采集"
+wikiToken: CjFJwVNa0ih6skkZHBmc0edmnCc
+parentWikiToken: BMYXwREPHidgIokPXd3cibSdnqe
+updateTime: 1755763733000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=unity_sdk_autotrack
+---
+# 自动采集
+
+### 一、 开启自动采集事件
+
+<!-- unsupported block: 19 -->
+
+Harmony平台该功能暂时关闭
+
+您可以通过调用 `EnableAutoTrack` 传入 `TDAutoTrackEventType` 来开启指定事件的自动采集功能。
+
+```
+public enum TDAutoTrackEventType
+{
+    None = 0,
+    AppStart = 1 << 0,
+    AppEnd = 1 << 1,
+    AppCrash = 1 << 4,
+    AppInstall = 1 << 5,
+    AppSceneLoad = 1 << 6,
+    AppSceneUnload = 1 << 7,
+    All = AppStart | AppEnd | AppInstall | AppCrash | AppSceneLoad | AppSceneUnload
+}
+```
+
+对于自动采集事件的说明如下：
+
+- **AppStart**: 当游戏进入前台的时候会触发上报 `ta_app_start`, 预置属性 `#resume_from_background` 表示本次启动是否是重新启动。
+<!-- unsupported block: 19 -->
+
+注:微信小游戏的AppStart事件变为show事件，事件名为: *`ta_mg_show`*，增加属性*`start_reason`*
+
+- **AppEnd**: 当游戏进入后台的时候会触发上报 `ta_app_end`, 预置属性 `#duration` 字段表示此次游戏在前台的持续时长，单位为秒。
+<!-- unsupported block: 19 -->
+
+注:微信小游戏的AppEnd事件变为hide事件，事件名为: *`ta_mg_hide`*
+
+- **AppCrash**: 当出现未捕获异常的时候会触发上报 `ta_app_crash`, 目前 Android 平台会处理虚拟机的未捕获异常。iOS 平台会处理 Unix 信号异常和 NSException 异常。
+- **AppInstall**: 当应用首次安装后打开时触发上报 `ta_app_install`. 不区分是否是卸载重装。该时间只在安装后上报一次，后续更新不会再上报。
+<!-- unsupported block: 19 -->
+
+注:微信小游戏的AppInstall事件变为launch事件，事件名为: *`ta_mg_launch`*，增加属性*`start_reason`*
+
+- **AppSceneLoad**: 当游戏场景（Scene）加载的时候触发上报 `ta_scene_loaded`
+- **AppSceneUnload**: 当游戏场景（Scene）卸载的时候触发上报 `ta_scene_unloaded`
+您可以通过传入 `TDAutoTrackEventType.All` 来开启目前支持的所有自动采集事件，也可以根据您项目的需求开启部分自动采集事件。
+
+```
+// 开启全部自动采集事件
+TDAnalytics.EnableAutoTrack(TDAutoTrackEventType.All);
+
+// 开启启动和关闭事件的自动采集
+TDAnalytics.EnableAutoTrack(TDAutoTrackEventType.AppStart | TDAutoTrackEventType.AppEnd);
+```
+
+<!-- unsupported block: 34 -->
+
+注意：如果您需要设置自定义访客 ID，或者公共事件属性，需要在打开自动采集事件之前完成。自动采集事件目前不支持动态公共属性。
+
+关于 `AppCrash` 如果在 `iOS` 和 `Android` 平台上只想采集 `Objective-C` 和 `Java` 异常，不采集 `C#` 异常，在 v2.3.1 及以上版本，可以通过在 `Resources` 目录添加 `ta_public_config.xml` 来配置开关，如下：
+
+```
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!-- ThinkingAnalytics disable C# Exception -->
+    <bool name="DisableCSharpException">true</bool>
+</resources>
+```
+
+### 二、 设置自动采集事件的自定义属性
+
+自 v2.2.4 开始，您可以通过调用 `EnableAutoTrack` 开启自动采集的同时，传入需要采集的自定义属性。
+
+```
+// 开启自动采集事件，并设置自定属性
+TDAnalytics.EnableAutoTrack(TDAutoTrackEventType.All, new Dictionary<string, object>() {
+    {"custom_key", "custom_value"}
+});
+```
+
+也可以调用 `SetAutoTrackProperties` 来指定特定自动采集事件的自定义属性。
+
+<!-- unsupported block: 34 -->
+
+注意：`SetAutoTrackProperties` 不会开启自动采集事件的采集，需要配`EnableAutoTrack` 方法使用。
+
+```
+// 设置指单个自动采集事件的自定义属性
+TDAnalytics.SetAutoTrackProperties(TDAutoTrackEventType.AppStart, new Dictionary<string, object>() 
+{
+    {"start_key", "start_value"}
+});
+
+// 设置指多个自动采集事件的自定义属性
+TDAnalytics.SetAutoTrackProperties(TDAutoTrackEventType.AppInstall | TDAutoTrackEventType.AppStart, new Dictionary<string, object>() 
+{
+    {"install_crash_key", "install_crash_value"}
+});
+
+// 开启全部自动采集事件
+TDAnalytics.EnableAutoTrack(TDAutoTrackEventType.All);
+```
+
+### 三、 设置自动采集事件回调
+
+    从 v2.4.0 开始，支持设置自动采集事件回调，以实时设置自定义属性，或在对应事件触发时机执行自定义代码。设置自动采集事件回调，需要先新建类并实现 `TDAutoTrackEventHandler` 接口，复写 `public Dictionary<string, object> GetAutoTrackEventProperties(int type, Dictionary<string, object>properties)` 方法，该方法的返回值即是需要设置的动采集事件属性。再调用 `EnableAutoTrack` 传入自动采集事件回调对象，如下：
+
+```
+// 1.自动采集事件回调实现
+public class AutoTrackECB : TDAutoTrackEventHandler
+{
+    public Dictionary<string, object> GetAutoTrackEventProperties(int type, Dictionary<string, object>properties)
+    {
+        return new Dictionary<string, object>() 
+        {
+            {"AutoTrackEventProperty", DateTime.Today}
+        };
+    }
+}
+// 2.开启自动采集，并设置事件回调
+TDAnalytics.EnableAutoTrack(TDAutoTrackEventType.All, new AutoTrackECB());
+```
+
+### 四、 开启场景自动采集事件
+
+从 v2.4.1 开始，支持自动采集场景的加载和卸载事件。
+
+通过注册场景加载、卸载的委托事件，来开启场景的自动采集事件。
+
+建议在 `MonoBehaviour` 脚本的 `OnEnable` 方法中调用。
+
+```
+    private void OnEnable()
+    {
+        // 监听场景加载、卸载事件
+        SceneManager.sceneLoaded += TDAnalytics.OnSceneLoaded;
+        SceneManager.sceneUnloaded += TDAnalytics.OnSceneUnloaded;
+    }
+```
+
+从 v2.5.1 开始，可以通过调用 `EnableAutoTrack` 方法开启场景自动采集事件
+
+```
+// 开启全部自动采集事件
+TDAnalytics.EnableAutoTrack(TDAutoTrackEventType.All);
+
+// 开启启动和关闭事件的自动采集
+TDAnalytics.EnableAutoTrack(TDAutoTrackEventType.AppSceneLoad | TDAutoTrackEventType.AppSceneUnload);
+```

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/unity//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,293 @@
+---
+code: unity_sdk_preset_properties
+name: "预置属性"
+wikiToken: UXOfwUqHBiMmhxk4dEyclIbBn3c
+parentWikiToken: BMYXwREPHidgIokPXd3cibSdnqe
+updateTime: 1753238421000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=unity_sdk_preset_properties
+---
+# 预置属性
+
+### 一、预置属性说明
+
+<!-- unsupported block: 34 -->
+
+各个平台采集的预置属性会有一定的差异，具体可以参考如下文档: Android平台 、 iOS平台  
+
+**非Native平台(如PC,Switch等终端)的****预置****属性: **
+
+**属性名**
+
+**中文名**
+
+**属性类型**
+
+**说明**
+
+#ip
+
+IP 地址
+
+文本
+
+用户的 IP 地址，AE 将以此获取用户的地理位置信息
+
+#country
+
+国家
+
+文本
+
+用户所在国家，根据 IP 地址生成
+
+#country_code
+
+国家代码
+
+文本
+
+用户所在国家的国家代码(ISO 3166-1 alpha-2，即两位大写英文字母)，根据 IP 地址生成
+
+#province
+
+省份
+
+文本
+
+用户所在省份，根据 IP 地址生成
+
+#city
+
+城市
+
+文本
+
+用户所在城市，根据 IP 地址生成
+
+#os_version
+
+操作系统版本
+
+文本
+
+如windows10
+
+#manufacturer
+
+设备制造商
+
+文本
+
+显卡的厂商名称
+
+#os
+
+操作系统
+
+文本
+
+如 MacOS,Windows等
+
+#device_id
+
+设备 ID
+
+文本
+
+用户的设备 ID
+
+#screen_height
+
+屏幕高度
+
+数值
+
+用户设备的屏幕高度，如 1920 等
+
+#screen_width
+
+屏幕宽度
+
+数值
+
+用户设备的屏幕高度，如 1080 等
+
+#device_model
+
+设备型号
+
+文本
+
+用户设备的型号，如 iPhone 8 等
+
+#app_version
+
+APP 版本
+
+文本
+
+您的 APP 的版本
+
+#bundle_id
+
+应用唯一标识
+
+文本
+
+应用包名
+
+#lib
+
+SDK 类型
+
+文本
+
+您接入 SDK 的类型，如 Android，iOS 等
+
+#lib_version
+
+SDK 版本
+
+文本
+
+您接入 SDK 的版本
+
+#network_type
+
+网络状态
+
+文本
+
+上传事件时的网络状态，如 Mobile,LAN
+
+#carrier
+
+网络运营商
+
+文本
+
+用户设备的网络运营商，如中国移动，中国电信等
+
+#zone_offset
+
+时区偏移
+
+数值
+
+数据时间相对 UTC 时间的偏移小时数
+
+#system_language
+
+系统语言
+
+文本
+
+用户设备的系统语言(ISO 639-1，即两位小写英文字母)，如 zh, en 等
+
+#start_reson
+
+启动原因
+
+文本
+
+应用打开或是进入前台页面的启动原因
+
+### 二、获取预置属性
+
+v2.2.0 及以后的版本可以调用 `TDAnalytics.GetPresetProperties()` 方法获取预置属性。服务端埋点需要 App 端的一些预置属性时，可以通过此方法获取 App 端的预置属性，再传给服务端。
+
+```
+//获取属性对象
+TDPresetProperties presetProperties = TDAnalytics.GetPresetProperties();
+
+//生成事件预置属性
+Dictionary<string, object> eventPresetProperties = presetProperties.ToDictionary();
+/*
+   {
+        "#carrier": "中国电信",
+        "#os": "iOS",
+        "#device_id": "A8B1C00B-A6AC-4856-8538-0FBC642C1BAD",
+        "#screen_height": 2264,
+        "#bundle_id": "com.sw.thinkingdatademo",
+         "#app_version": "0.1",
+        "#manufacturer": "Apple",
+        "#device_model": "iPhone7",
+        "#screen_width": 1080,
+        "#system_language": "zh",
+        "#os_version": "10",
+        "#network_type": "WIFI",
+        "#zone_offset": 8,
+        "#app_version":"1.0.0"
+    }
+*/
+
+//获取某个预置属性
+string bundleId = presetProperties.BundleId;//包名
+string appVersion = presetProperties.AppVersion;//App版本号
+string os = presetProperties.OS;//os类型，如Android、iOS
+string systemLanguage = presetProperties.SystemLanguage;//手机系统语言类型
+int screenWidth = presetProperties.ScreenWidth;//屏幕宽度
+int screenHeight = presetProperties.ScreenHeight;//屏幕高度
+string deviceModel = presetProperties.DeviceModel;//设备型号
+string deviceId = presetProperties.DeviceId;//设备唯一标识
+string carrier = presetProperties.Carrier;//手机SIM卡运营商信息，双卡双待时，取主卡的运营商信息
+string manufacture = presetProperties.Manufacturer;//手机制造商 如HuaWei、Apple
+string networkType = presetProperties.NetworkType;//网络类型
+string osVersion = presetProperties.OSVersion;//系统版本号
+double zoneOffset = presetProperties.ZoneOffset;//时区偏移值
+string appVersion = presetProperties.appVersion;//App版本号
+```
+
+<!-- unsupported block: 34 -->
+
+IP，国家城市信息由服务端解析生成，客户端不提供接口获取这些属性
+
+### 三、关闭预置属性采集
+
+在 v2.3.1 及以上版本，支持屏蔽指定预置属性的上报。通过在 `Resources` 目录添加 `ta_public_config.xml` 来配置开关，配置的字段对应的预置属性将不会上传。如下：
+
+```
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!-- ThinkingAnalytics DisablePresetProperties start -->
+    <string-array name="TDDisPresetProperties">
+       <item>#disk</item>
+       <item>#fps</item>
+       <item>#ram</item>
+       <!-- <item>#app_version</item> -->
+       <!-- <item>#os_version</item> -->
+       <!-- <item>#manufacturer</item> -->
+       <!-- <item>#device_model</item> -->
+       <!-- <item>#screen_height</item> -->
+       <!-- <item>#screen_width</item> -->
+       <!-- <item>#carrier</item> -->
+       <!-- <item>#device_id</item> -->
+       <!-- <item>#system_language</item> -->
+       <!-- <item>#lib</item> -->
+       <!-- <item>#lib_version</item> -->
+       <!-- <item>#os</item> -->
+       <!-- <item>#bundle_id</item> -->
+       <!-- <item>#install_time</item> -->
+       <!-- <item>#start_reason</item> -->
+       <!-- <item>#simulator</item> -->
+       <!-- <item>#network_type</item> -->
+       <!-- <item>#start_reason</item> -->
+       <!-- <item>#resume_from_background</item> -->
+       <!-- <item>#title</item> -->
+       <!-- <item>#screen_name</item> -->
+       <!-- <item>#url</item> -->
+       <!-- <item>#referrer</item> -->
+       <!-- <item>#element_type</item> -->
+       <!-- <item>#element_id</item> -->
+       <!-- <item>#element_position</item> -->
+       <!-- <item>#element_content</item> -->
+       <!-- <item>#element_selector</item> -->
+       <!-- <item>#app_crashed_reason</item> -->
+    </string-array>
+    <!-- ThinkingAnalytics DisablePresetProperties end -->
+</resources>
+```
+
+<!-- unsupported block: 34 -->
+
+如果您屏蔽设备ID的情况下，需要使用首次事件，请务必填写first_check_id属性