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//346/233/264/346/226/260/346/227/245/345/277/227.md

@@ -0,0 +1,505 @@
+---
+code: unity_sdk_release_note
+name: "更新日志"
+wikiToken: Eo48wSBdbifxQEkKmAfcggGknRg
+parentWikiToken: Vlbrwj9vYijvVIkwaCtcIABFnMf
+updateTime: 1773313300000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=unity_sdk_release_note
+---
+# 更新日志
+
+### v3.4.6
+
+**更新时间: 2026/03/12 ****下载**
+
+**更新内容:**
+
+- 已知问题修复
+### v3.4.5
+
+**更新时间: 2026/03/11 ****下载**
+
+**更新内容:**
+
+- 升级Android模块
+- 升级ios模块
+- 已知问题修复
+### v3.4.2
+
+**更新时间: 2025/12/03 ****下载**
+
+**更新内容:**
+
+- 升级ios模块
+### v3.4.0
+
+**更新时间: 2025/11/06 ****下载**
+
+**更新内容:**
+
+- 微信小游戏支持show, hide, launch，并且采集启动参数
+- 升级安卓iOS三方插件至最新版本
+- 导出鸿蒙时包名名称修改兼容
+- 已知问题修复
+### **v3.3.0**
+
+**更新时间: 2025/06/25 ****下载**
+
+**更新内容:**
+
+- 提供Lua层数据埋点接口
+- 支持 ProjectSettings 来配置项目信息
+- 代码优化
+- 修复已知问题
+### **v3.2.2**
+
+**更新时间: 2025/07/31 ****下载**
+
+**更新内容:**
+
+- 已知问题修复
+### **v3.2.1**
+
+**更新时间: 2025/05/09 ****下载**
+
+**更新内容:**
+
+- 修复鸿蒙平台打包失败问题
+### **v3.2.0**
+
+**更新时间: 2025/04/27 ****下载**
+
+**更新内容:**
+
+- 支持策略SDK相关业务
+### **v3.1.4**
+
+**更新时间: 2025/04/07 ****下载**
+
+**更新内容:**
+
+- 修复打包失败问题
+- 升级iOS SDK至3.1.0
+### **v3.1.3**
+
+**更新时间: 2025/03/25 ****下载**
+
+**更新内容:**
+
+- 修复打包失败问题
+### **v3.1.2**
+
+**更新时间: 2025/02/28 ****下载**
+
+**更新内容:**
+
+- 修复打包失败问题
+### **v3.1.1**
+
+**更新时间: 2025/02/20 ****下载**
+
+**更新内容:**
+
+- 支持腾讯广告SDK
+- 已知问题修复
+### **v3.1.0.1**
+
+**更新时间: 2025/03/14 ****下载**
+
+**更新内容:**
+
+- 修复已知问题
+### **v3.1.0**
+
+**更新时间: 2024/11/12 ****下载**
+
+**更新内容:**
+
+- 支持OpenHarmony平台
+### **v3.0.8**
+
+**更新时间: 2024/09/19 ****下载**
+
+**更新内容:**
+
+- 升级iOS SDK至3.0.4
+- Unity和安卓所有交互重新改造
+- 提供直接上报字符串的接口
+### **v3.0.7**
+
+**更新时间: 2024/08/02 ****下载**
+
+**更新内容:**
+
+- 修复安卓获取设备号导致install事件丢失问题
+- 解决安卓短时间内上报大量事件闪退问题
+- 修复安卓install事件丢失的问题
+- 修复安卓时区问题
+### **v3.0.6**
+
+**更新时间: 2024/03/20 ****下载**
+
+**更新内容:**
+
+- 修复安卓install事件导致自动采集失效的问题
+### **v3.0.5**
+
+**更新时间: 2024/03/06 ****下载**
+
+**更新内容:**
+
+- 修复Decimal格式化报错问题
+### v3.0.4
+
+**更新时间: 2024/02/07 ****下载**
+
+**更新内容:**
+
+- 修复networktype默认为wifi的问题
+### v3.0.3
+
+**更新时间: 2024/02/01 ****下载**
+
+**更新内容:**
+
+- 优化动态公共属性
+- 优化日期格式化
+### v3.0.2
+
+**更新时间: 2024/01/16 ****下载**
+
+**更新内容:**
+
+- PackageManager集成方式支持预置体
+- 预置体networktype默认为 All
+### v3.0.1
+
+**更新时间: 2023/11/23 ****下载**
+
+**更新内容:**
+
+- 升级AndroidSDK至3.0.0
+### v3.0.0
+
+**更新时间: 2023/09/15 ****下载**
+
+**更新内容:**
+
+- 优化代码
+### v2.6.1
+
+**更新时间: 2023/07/19 ****下载**
+
+**更新内容:**
+
+- 优化代码
+### v2.6.0
+
+**更新时间: 2023/04/19 ****下载**
+
+**更新内容:**
+
+- 新增支持 iOS / Android 原生 SDK 可插拔
+- 优化代码
+### v2.5.1 
+
+**更新时间: 2022/11/21**
+
+**更新内容:**
+
+- 新增支持设置实例名称
+- 新增支持获取国家/地区信息
+- 优化代码
+### v2.5.0 
+
+**更新时间: 2022/10/20**
+
+**更新内容:**
+
+- 优化代码 
+### v2.4.1 
+
+**更新时间: 2022/08/08**
+
+**更新内容:**
+
+- 支持 Package Manager 接入 
+- 新增自动采集场景加载、卸载事件 
+- 优化代码 
+### v2.4.0 
+
+**更新时间: 2022/06/14**
+
+**更新内容:**
+
+- 新增支持去重追加用户属性 
+- 新增支持自动采集事件回调 
+- 新增支持 iOS / Android 数据加密上报 
+- 优化代码 
+### v2.3.1 
+
+**更新时间: 2022/04/21**
+
+**更新内容:**
+
+- 新增预置属性禁用开关 
+- 优化代码 
+### v2.3.0
+
+**更新时间: 2022/02/28**
+
+**更新内容:**
+
+- 全平台支持缓存事件、批量发送 
+- 优化代码 
+### v2.2.5 
+
+**更新时间: 2022/01/17**
+
+**更新内容:**
+
+- 新增预置属性`#app_version`
+- 支持 Switch 等平台，放开对支持平台的限制 
+- 简化初始化流程，放开 Unity 预置体的限制 
+- 优化代码 
+### v2.2.4 
+
+**更新时间: 2021/11/15**
+
+**更新内容:**
+
+- 支持复杂数据类型 
+- 自动采集事件支持自定义属性 
+- 支持 WebGL 
+- 优化代码 
+<!-- unsupported block: 34 -->
+
+注意：若从低版本升级到 v2.2.4，或手动初始化且未加载 `ThinkingAnalytics` 预置体，需注意有两个脚本要挂载到 `GameObject` 上：`ThinkingAnalyticsAPI` 、 `ThinkingSDKTask` 。
+
+### v2.2.2
+
+**更新时间: 2021/09/15**
+
+**更新内容:**
+
+- 支持手动初始化 
+- 支持事件黑名单 
+- 优化代码 
+### v2.2.1 
+
+**更新时间: 2021/07/21**
+
+**更新内容:**
+
+- 优化代码
+### v2.2.0 
+
+**更新时间: 2021/06/16**
+
+**更新内容:**
+
+- 支持预置属性获取
+- 新增 C# 异常采集
+- 兼容Bitcode
+- 优化对低版本Unity的支持
+- 更新 Android SDK (v2.7.0)、iOS SDK (v2.7.0)
+- 代码优化
+### v2.1.5
+
+**更新时间: 2021/04/19**
+
+**更新内容:**
+
+- 兼容低版本.net
+- 代码优化
+### v2.1.4 
+
+**更新时间: 2021/03/15**
+
+**更新内容:**
+
+- 适配iOS 14
+- 适配Android 11
+- 新增预置属性#bundle_id(应用唯一标识)
+- 优化网络信号获取逻辑
+### v2.1.3 
+
+**更新时间: 2021/01/04**
+
+**更新内容:**
+
+- 支持UnityEditor中上报数据
+- 支持PC端游戏(Windows,MacOS)
+- 多实例场景,支持代码设置默认实例
+### v2.1.2 
+
+**更新时间: 2020/10/29**
+
+**更新内容:**
+
+- 适配 iOS 5G 网络
+- 优化 install,start 事件上报逻辑
+- 优化数据传输格式
+- 默认网络上报策略调整为 2G/3G/4G/5G/WIFI
+### v2.1.1 
+
+**更新时间: 2020/08/25**
+
+**更新内容:**
+
+- 修复特殊事件不设置 timeZone 导致上报错误的#zone_offset 的问题.
+### v2.1.0
+
+**更新时间: 2020/08/24**
+
+**更新内容:**
+
+- 支持首次事件, 允许传入自定义的 ID 校验是否首次上报
+- 支持可更新、可重写的事件
+- 优化#lib/#lib_version 字段为 Unity SDK 信息
+- 升级原生 SDK 版本为 v2.6.0
+### v2.0.8 
+
+**更新时间: 2020/06/28**
+
+**更新内容:**
+
+- 更新原生 Android SDK，避免极端情况下的空指针异常
+### v2.0.7 
+
+**更新时间: 2020/06/23**
+
+**更新内容:**
+
+- 新增预置属性 #system_language
+- 更新原生 SDK 版本号: Android v2.5.5, iOS v2.5.5
+- Android 不再通过修改 gradle 配置来引入 ThinkingAnalyticsSDK 依赖
+### v2.0.6 
+
+**更新时间: 2020/06/17**
+
+**更新内容:**
+
+- 解决 iOS 32 位机型 long 型溢出的问题
+### v2.0.5 
+
+**更新时间: 2020/05/19**
+
+**更新内容:**
+
+- 解决 2018.04 版本无法使用 ntp 校准时间的问题
+### v2.0.4
+
+**更新时间: 2020/05/15**
+
+**更新内容:**
+
+- 更新原生 iOS SDK 到 v2.5.2，解决上个版本中 Debug 模式问题
+### v2.0.3 
+
+**更新时间: 2020/05/14**
+
+**更新内容:**
+
+- 更新原生 SDK 版本，适配 AE 后台埋点管理功能
+- 优化代码，避免出现异常（可能会导致与其他崩溃采集 SDK 冲突）
+### v2.0.2 
+
+**更新时间: 2020/04/17**
+
+**更新内容:**
+
+- 修复 Double 类型在自定义 CultureInfo 的场景下格式错误
+### v2.0.1 
+
+**更新时间: 2020/04/14**
+
+**更新内容:**
+
+- 修复 Android 平台 DEBUG 模式上报事件的 BUG
+### v2.0.0
+
+**更新时间: 2020/04/03**
+
+**更新内容:**
+
+- 修改自动采集逻辑，支持四种类型的自动采集事件：启动、关闭、崩溃、安装
+- 支持 SDK 时间校准功能，支持时间戳校准和 NTP 服务器校准
+- 允许为用户属性相关设置接口传入指定时间
+### **v1.4.3**
+
+**更新时间: 2020/03/19**
+
+**更新内容:**
+
+- 支持对数据 #time 属性的默认时区设置
+- 更新原生 SDK 版本
+### v1.4.2 
+
+**更新时间: 2020/02/21**
+
+**更新内容:**
+
+- 更新 iOS 插件，修复在较老版本 iOS 系统中引入的 bug
+### v1.4.1 
+
+**更新时间: 2020/02/14**
+
+**更新内容:**
+
+- 适配 Unity 2019.3.1f1
+### v1.4.0
+
+**更新时间: 2020/02/11**
+
+**更新内容:**
+
+- 属性值支持 List / Array 类型
+- 新增 UserAppend 接口
+- 支持 Debug 模式数据校验
+- 支持为每个实例单独配置接收端地址
+- 去除本地数据格式校验
+### v1.3.1
+
+**更新时间: 2019/12/25**
+
+**更新内容:**
+
+- 修复 Android 4.3 以下版本退出超时
+- 修复 未包含 iOS 开发环境时的报错
+### v1.2.0 
+
+**更新时间: 2019/09/02**
+
+**更新内容:**
+
+- 支持关闭/打开数据上报
+- 支持暂停/继续数据上报
+- 支持轻量级实例
+- 修复 2019.2.1f 版本设置网络类型失败
+- 修复 timeEvent 不准确问题
+- Android/iOS SDK 升级为 2.1.0
+### v1.1.0 
+
+**更新时间: 2019/08/09**
+
+**更新内容:**
+
+- 支持获取设备 ID
+- 支持动态公共属性
+- 支持安装事件采集
+- 内嵌 Android SDK 升级为 2.0.2
+- 内嵌 iOS SDK 升级为 2.0.1
+- 支持上报缓存选项，用户可以选择主动调用 `StartTrack()` 去开始上报
+### v1.0.0 
+
+**更新时间: 2019/06/20**
+
+**更新内容:**
+
+- 支持 访客 ID 和 用户账号 的设置
+- 支持事件和用户属性上报
+- 支持 `ta_app_start` 和 `ta_app_end` 事件的自动上报
+- 支持公共属性接口
+- 支持 `timeEvent` 接口
+- 支持多项目上报

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//344/270/211/346/226/271/346/225/260/346/215/256.md

@@ -0,0 +1,86 @@
+---
+code: unity_sdk_thirdparty
+name: "三方数据"
+wikiToken: TWc3w3O0GiKaJXkMSeocntqpnlh
+parentWikiToken: BMYXwREPHidgIokPXd3cibSdnqe
+updateTime: 1745309704000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=unity_sdk_thirdparty
+---
+# 三方数据
+
+从v2.4.0开始支持三方数据接入功能，以下是同步多个平台数据的示例代码:
+
+```
+TDAnalytics.EnableThirdPartySharing(TDThirdPartyType.APPSFLYER | TDThirdPartyType.ADJUST | TDThirdPartyType.TRADPLUS | TDThirdPartyType.TRACKING | TDThirdPartyType.TOPON | TDThirdPartyType.BRANCH | TDThirdPartyType.IRONSOURCE);
+```
+
+### 1.Appsflyer
+
+在AppsFlyer SDK调用start方法之前调用API。 
+
+```
+TDAnalytics.EnableThirdPartySharing(TDThirdPartyType.APPSFLYER);
+```
+
+注册创角色之后(可选)。 
+
+```
+TDAnalytics.Login("account_id");
+TDAnalytics.EnableThirdPartySharing(TDThirdPartyType.APPSFLYER);
+```
+
+如果调用了 AE 的Login方法（会修改account_id）或者SetDistinctId方法（会修改distinct_id），需要再次调用EnableThirdPartySharing同步数据。
+
+### 2.Adjust
+
+在Adjust SDK初始化之前调用。 
+
+```
+TDAnalytics.EnableThirdPartySharing(TDThirdPartyType.ADJUST);
+```
+
+注册创角色之后(可选)。 
+
+```
+TDAnalytics.Login("account_id");
+TDAnalytics.EnableThirdPartySharing(TDThirdPartyType.ADJUST);
+```
+
+### 3.Branch
+
+在Branch initialize the session之前调用。 
+
+```
+TDAnalytics.EnableThirdPartySharing(TDThirdPartyType.BRANCH);
+```
+
+注册创角色之后(可选)。 
+
+```
+TDAnalytics.Login("account_id");
+TDAnalytics.EnableThirdPartySharing(TDThirdPartyType.BRANCH);
+```
+
+### 4.TopOn
+
+在ATSDK.*init之前调用。*
+
+```
+TDAnalytics.EnableThirdPartySharing(TDThirdPartyType.TOPON);
+```
+
+### 5.Tradplus
+
+在TradPlusSdk.*initSdk之前调用。*
+
+```
+TDAnalytics.EnableThirdPartySharing(TDThirdPartyType.TRADPLUS);
+```
+
+### 6.IronSource
+
+在IronSourceSdk初始化之后调用。
+
+```
+TDAnalytics.EnableThirdPartySharing(TDThirdPartyType.IRONSOURCE);
+```

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/216/237/347/224/237-sdk-/345/217/257/346/217/222/346/213/224.md

@@ -0,0 +1,44 @@
+---
+code: unity_sdk_pluggable
+name: "原生 SDK 可插拔"
+wikiToken: LW9awZLwKiOUVBkqw56c31gznrb
+parentWikiToken: BMYXwREPHidgIokPXd3cibSdnqe
+updateTime: 1745309707000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=unity_sdk_pluggable
+---
+# 原生 SDK 可插拔
+
+::: tip 提示
+
+从 v2.6.0 开始支持动态切换 iOS/Android 原生平台执行代码逻辑。默认执行 Objective-C/Java逻辑，切换之后执行 C# 代码逻辑。
+
+已上线的 iOS/Android 应用，用户在更新“执行 C# 代码逻辑”的版本之后，会丢失持久化数据，包括设备ID、账号ID、访客ID、事件公共属性等，出现被判定为新用户的情况。请慎重选择。
+
+:::
+
+## 一、可插拔流程
+
+### 1.1 iOS 平台
+
+<!-- unsupported block: 34 -->
+
+默认执行 Objective-C 代码逻辑，切换后执行 C# 代码逻辑。
+
+- 下载 Unity SDK 之后解压成 `ta_unity_sdk.unitypackage` 文件，双击选择导入 SDK，在导入界面取消勾选 `Plugins/iOS` 目录，再导入即可
+<!-- unsupported block: 34 -->
+
+注意：如果已经导入过 Unity SDK，需要检查 Plugins/iOS 目录中的文件，如果没有 “ThinkingSDK”、“TAThirdParty”、“ThinkingAnalytics.m”之外的文件或目录，直接删除 Plugins/iOS 即可，否则删除上述文件和目录即可。
+
+- 打开 `Project Settings` 界面，切换到 `iOS` 栏，找到 `Scripting Define Symbols`，新增一行输入`TE_DISABLE_IOS_OC` 然后点击 `Apply` 按钮完成设置，最后在开发完成之后正常导出 Xcode 工程即可
+### 1.2 Android 平台
+
+<!-- unsupported block: 34 -->
+
+默认执行 Java 代码逻辑，切换后执行 C# 代码逻辑。
+
+- 下载 Unity SDK 之后解压成 `ta_unity_sdk.unitypackage` 文件，双击选择导入 SDK，在导入界面取消勾选 `Plugins/Android` 目录，再导入即可
+<!-- unsupported block: 34 -->
+
+注意：如果已经导入过 Unity SDK，需要检查 Plugins/Android 目录中的文件，如果没有 “ThinkingSDK.aar”、“ThinkingSDK-gameengine.aar”、“ThinkingSDK-thirdparty.aar”之外的文件或目录，直接删除 Plugins/Android 即可，否则删除上述文件即可。
+
+- 打开 `Project Settings` 界面，切换到 `Android` 栏，找到 `Scripting Define Symbols`，新增一行输入 `TE_DISABLE_ANDROID_JAVA` 然后点击 `Apply` 按钮完成设置，最后在开发完成之后正常导出 Android 工程即可

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/244/232/345/256/236/344/276/213.md

@@ -0,0 +1,55 @@
+---
+code: unity_sdk_multi_appid
+name: "多实例"
+wikiToken: TpD7wLlUkiEQqdkb4WtcOx9mnof
+parentWikiToken: BMYXwREPHidgIokPXd3cibSdnqe
+updateTime: 1745309706000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=unity_sdk_multi_appid
+---
+# 多实例
+
+### 一、创建多实例
+
+在实际的业务中，如果你期望把数据发送到多个项目，可以使用我们提供的多实例功能。
+
+传入不同的项目信息完成 SDK 初始化，即可创建多个 SDK 实例。
+
+```
+//多实例初始化
+TDConfig tdConfig_1 = new TDConfig(appId_1, serverUrl_2);
+TDConfig tdConfig_2 = new TDConfig(appId_2, serverUrl_2);
+//初始化第一个实例
+TDAnalytics.Init(tdConfig_1);
+//初始化第二个实例
+TDAnalytics.Init(tdConfig_2);
+//使用多实例进行数据埋点
+Dictionary<string, object> properties = new Dictionary<string, object>(){
+    {"product_name", "商品名"}
+};
+//使用第一个实例上报数据
+TDAnalytics.Track("product_buy", properties, appId_1);
+//使用第二个实例上报数据
+TDAnalytics.Track("product_buy", properties, appId_2);
+//如果不传项目ID，将默认使用第一个实例上报数据
+TDAnalytics.Track("product_buy", properties);
+```
+
+<!-- unsupported block: 34 -->
+
+访客 ID、账户 ID、公共属性等在多项目中不共享，需要为每个 APP ID 实例单独进行设置。
+
+### 二、创建轻实例
+
+```
+//首先创建一个SDK实例
+TDAnalytics.Init("APPID", "SERVER");
+//然后调用createLightInstance生成轻实例
+string lightKey = TDAnalytics.LightInstance();
+//再根据lightKey设置login信息、上报事件
+TDAnalytics.Login("123ABCabc@thinkingdata.cn", lightKey);
+TDAnalytics.Track("some_event", lightKey);
+```
+
+<!-- unsupported block: 34 -->
+
+轻实例与父实例的 APPID、上报地址以及部分设置一致，但其他信息不共享。