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

@@ -0,0 +1,491 @@
+---
+code: ios_sdk_release_note
+name: "更新日志"
+wikiToken: Rz3MwuPJciJBcTkGppEcRNeIngc
+parentWikiToken: RCJRwHveBi4YRBk2AqncI0VqncS
+updateTime: 1773312609000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=ios_sdk_release_note
+---
+# 更新日志
+
+### v3.3.5
+
+**更新时间:** **2026/03/12 ****下载**
+
+**更新内容:**
+
+- 已知问题修复
+### v3.3.4
+
+**更新时间:** **2026/03/09 ****下载**
+
+**更新内容:**
+
+- 已知问题修复
+### v3.3.3
+
+**更新时间:** **2025/12/29 ****下载**
+
+**更新内容:**
+
+- 已知问题修复
+### v3.3.2
+
+**更新时间:** **2025/12/03 ****下载**
+
+**更新内容:**
+
+- 已知问题修复
+### v3.3.1
+
+**更新时间:** **2025/11/18 ****下载**
+
+**更新内容:**
+
+- 已知问题修复
+### v3.3.0
+
+**更新时间:** **2025/11/03 ****下载**
+
+**更新内容:**
+
+- 已知问题修复
+- 可选开启本地数据加密
+- 初始化异步
+### v3.1.6
+
+**更新时间:** **2025/10/10 ****下载**
+
+**更新内容:**
+
+- 已知问题修复
+### v3.1.5
+
+**更新时间:** **2025/08/25 ****下载**
+
+**更新内容:**
+
+- 已知问题修复
+### v3.1.4
+
+**更新时间:** **2025/08/19 ****下载**
+
+**更新内容:**
+
+- 已知问题修复
+### v3.1.3
+
+**更新时间:** **2025/08/05 ****下载**
+
+**更新内容:**
+
+- 已知问题修复
+### v3.1.2
+
+**更新时间:** **2025/07/31 ****下载**
+
+**更新内容:**
+
+- 已知问题修复
+### v3.1.1
+
+**更新时间:** **2025/05/23 ****下载**
+
+**更新内容:**
+
+- 提升 SDK 稳定性
+### v3.1.0
+
+**更新时间:** **2025/03/13 ****下载**
+
+**更新内容:**
+
+- 发布正式版本
+### v3.0.6
+
+**更新时间:** **2025/02/25 ****下载（iOS）****  ****下载（OSX）**
+
+**更新内容:**
+
+- 优化线程调度
+### v3.1.0
+
+**更新时间:** **2024/12/15**
+
+**更新内容:**
+
+- 新增客户端触发式相关的路由
+### v3.0.6
+
+**更新时间:** **2025/01/07 ****下载（iOS）**
+
+**更新内容:**
+
+- 优化线程调度
+### v3.0.5
+
+**更新时间:** **2024/11/05 ****下载**
+
+**更新内容:**
+
+- 提升 SDK 在 OSX 平台的兼容性
+- 修复hook可能引起的崩溃问题
+### v3.0.4
+
+**更新时间: 2024/08/01 ****下载**
+
+**更新内容:**
+
+- 兼容 iOS 18
+- 提升SDK稳定性
+### v3.0.3
+
+**更新时间: 2024/05/17 ****下载**
+
+**更新内容:**
+
+- 支持DNS解析IP地址
+### v3.0.2
+
+**更新时间: 2024/04/09 ****下载**
+
+**更新内容:**
+
+- 发布正式版本
+### v3.0.1
+
+**更新时间: 2024/01/03 ****下载**
+
+**更新内容:**
+
+- 发布正式版本
+### v3.0.0
+
+**更新时间: 2023/****10****/****10**** ****下载**
+
+**更新内容:**
+
+- 优化内存占用
+- SDK使用全新的静态方法API
+### v2.8.4
+
+**更新时间: 2023/08/29 ****下载**
+
+**更新内容:**
+
+- 提升时区精度
+- 修复启动事件采集方式
+### v2.8.3.2
+
+**更新时间: 2023/04/03**
+
+**更新内容:**
+
+- 优化代码，提高SDK稳定性
+### v2.8.3.1
+
+**更新时间: 2022/12/30**
+
+**更新内容:**
+
+- 优化代码，提高SDK稳定性
+### v2.8.3
+
+**更新时间: 2022/11/08**
+
+**更新内容:**
+
+- 优化代码，提高SDK稳定性
+- 移除三方数据集成代码
+### v2.8.2
+
+**更新时间: 2022/09/27**
+
+**更新内容:**
+
+- 代码优化，提升SDK稳定性
+- 新增预置属性#device_type
+- 新增获取手机region信息接口
+### v2.8.1.1 
+
+**更新时间: 2022/06/27**
+
+**更新内容:**
+
+- 代码优化，提升SDK稳定性 
+### v2.8.1
+
+**更新时间: 2022/06/13**
+
+**更新内容:**
+
+- 提供AppExtension数据采集模块 
+### v2.8.0.1
+
+**更新时间: 2022/05/23**
+
+**更新内容:**
+
+- 修复获取推送启动原因时导致的系统回调无法执行 
+### v2.8.0 
+
+**更新时间: 2022/04/18**
+
+**更新内容:**
+
+- 代码优化
+- 添加三方数据集成功能 
+- 添加加密功能 
+### v2.7.4
+
+**更新时间: 2022/01/18**
+
+**更新内容:**
+
+- 代码优化
+- 添加启动原因、性能指标等预置属性 
+### v2.7.3
+
+**更新时间: 2021/11/09**
+
+**更新内容:**
+
+- 支持复杂数据类型 
+### v2.7.2 
+
+**更新时间: 2021/08/18**
+
+**更新内容:**
+
+- 代码优化
+- 优化安装事件采集逻辑
+### v2.7.1 
+
+**更新时间: 2021/07/21**
+
+**更新内容:**
+
+- 代码优化
+### v2.7.0
+
+**更新时间: 2021/06/16**
+
+**更新内容:**
+
+- 支持预置属性获取
+- 代码优化
+### v2.6.5 
+
+**更新时间: 2021/04/19**
+
+**更新内容:**
+
+- 代码优化
+### v2.6.4 
+
+**更新时间: 2021/03/15**
+
+**更新内容:**
+
+- 新增预置属性#bundle_id(应用包名)
+- 适配iOS 14
+### v2.6.3 
+
+**更新时间: 2021/01/18**
+
+**更新内容:**优化获取网络类型逻辑
+
+### v2.6.2
+
+**更新时间: 2020/10/29**
+
+**更新内容:**
+
+- 适配 5G 网络
+- 优化 install,start 事件上报逻辑
+- 优化数据传输格式
+- 默认网络上报策略调整为 2G/3G/4G/5G/WIFI
+### v2.6.1
+
+**更新时间: 2020/08/25**
+
+**更新内容:**
+
+- 修复特殊事件设置 timeZone 的逻辑, 现在不设置 timeZone 上报数据不会再带有#zone_offset=0 了.
+### v2.6.0 
+
+**更新时间: 2020/08/24**
+
+**更新内容:**
+
+- 支持首次事件, 允许传入自定义的 ID 校验是否首次上报
+- 支持可更新、可重写的事件
+### v2.5.6 
+
+**更新时间: 2020/08/11**
+
+**更新内容:**
+
+- 优化时间校准 API, 现在多次调用会多次生效.
+### v2.5.5
+
+**更新时间: 2020/06/23**
+
+**更新内容:**
+
+- 修复部分机型 #system_language 异常
+### v2.5.4 
+
+**更新时间: 2020/06/22**
+
+**更新内容:**
+
+- 修复 v2.5.3 undeclared selector 'applicationWillTerminateNotification:' [-Wundeclared-selector]
+### v2.5.3 
+
+**更新时间: 2020/06/22**
+
+**更新内容:**
+
+- 新增预置属性 #system_language
+- 固定预置属性 #os 为 "iOS"
+- 优化代码
+### v2.5.2 
+
+**更新时间: 2020/05/15**
+
+**更新内容:**
+
+- 修复 v2.5.1 中 Debug 模式会因数据格式错误降级的问题
+### v2.5.1 
+
+**更新时间: 2020/05/14**
+
+**更新内容:**
+
+- 适配 AE 后台 2.7 版本屏蔽事件配置接口
+- 调整 DEBUG 模式，去除客户端抛异常逻辑
+### v2.5.0 
+
+**更新时间: 2020/04/03**
+
+**更新内容:**
+
+- 支持客户端 SDK 的时间校准功能
+- 新增指定时间的用户属性设置接口
+- 代码优化
+### v2.4.3
+
+**更新时间: 2020/03/11**
+
+**更新内容:**
+
+- 去除 UIWebView 相关代码
+### v2.4.2
+
+**更新时间: 2020/03/09**
+
+**更新内容:**
+
+- 延迟初始化时正常按间隔上报数据
+- 代码优化
+### v2.4.1 
+
+**更新时间: 2020/02/21**
+
+**更新内容:**
+
+- 修复 v2.3.0、v2.3.1、v2.4.0 引入的 bug
+### v2.4.0 
+
+**更新时间: 2020/02/10**
+
+**更新内容:**
+
+- 支持 NSArray 类型
+- 新增 user_append 接口
+- 去除客户端的属性格式检查
+### v2.3.1 
+
+**更新时间: 2020/01/07**
+
+**更新内容:**
+
+- 支持配置默认时区
+### v2.3.0 
+
+**更新时间: 2019/12/31**
+
+**更新内容:**
+
+- 支持 Debug 模式: 需配合后台 Debug 设备白名单一起开启
+- H5 与原生 SDK 打通支持多实例
+- 优化 SDK 配置: 增加全局设置;上报策略允许针对不同项目配置
+- 支持配置 HTTPS 证书校验
+### v2.2.2 
+
+**更新时间: 2019/12/01**
+
+**更新内容:**
+
+- 修复使用 `EnableSceneSupport` 时，APP 启动事件(`ta_app_install`)中的属性 `#resume_from_background` 取值异常的问题
+### v2.2.1
+
+**更新时间: 2019/11/22**
+
+**更新内容:**
+
+- 依据 Appstore ITMS-90809 默认去除 UIWebView 相关内容
+### v2.2.0
+
+**更新时间: 2019/10/21**
+
+**更新内容:**
+
+- 新增`user_unset`接口，可用于清空一个用户属性
+- 新增预置属性`#zone_offset`，单位为小时。 默认情况下会将本地时区的偏移上报到服务端，该时间偏移会受夏令时影响。满足如下公式：
+```
+utc_time + #zone_offset = #event_time
+```
+
+### v2.1.1
+
+**更新时间: 2019/10/11**
+
+**更新内容:**
+
+- 优化上报逻辑，解决极端情况下数据异常上报的问题
+### v2.1.0
+
+**更新时间: 2019/09/16**
+
+**更新内容:**
+
+- 支持轻量级实例, 便于上报被动事件等需求
+- 新增 enableTracking 接口, 可以打开或关闭实例上报功能
+- 新增 optOutTracking/optInTracking 接口
+- 其他代码优化
+### v2.0.1
+
+**更新时间: 2019/07/15**
+
+**更新内容:**
+
+- 调整了自动采集事件中 ta_app_install（APP 安装事件）的触发顺序，现在将在 ta_app_start（APP 启动事件）前触发
+### v2.0.0 
+
+**更新时间: 2019/07/12**
+
+**更新内容:**
+
+- 自动采集事件新增 APP 安装事件
+- 默认不采集后台自启时产生的数据，后续会添加后台自启接口，可控制是否采集后台自启时产生的数据
+### v1.2.0 
+
+**更新时间: 2019/06/20**
+
+**更新内容:**
+
+- 新增多 APPID 实例功能
+- 新增动态公共属性特性
+- 自动采集事件新增 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/ios//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,154 @@
+---
+code: ios_sdk_thirdparty
+name: "三方数据"
+wikiToken: NUm1wa8Qii1F41kIKKic4lTDn2c
+parentWikiToken: T7Ocw5qr7is1Z5k0P6VcZVSKnDd
+updateTime: 1745309660000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=ios_sdk_thirdparty
+---
+# 三方数据
+
+**最新版本: **v0.3.5
+
+**更新时间:** 2025-02-10
+
+**资源下载: **源代码 Framework 下载
+
+使用cocopoads方式来集成：
+
+```
+pod 'TAThirdParty'
+```
+
+ ThinkingSDK 从 v2.8.0 开始支持三方数据接入功能，以下是同步多个平台数据的示例代码:
+
+```
+[TDAnalytics enableThirdPartySharing:TDThirdPartyTypeAppsFlyer | TDThirdPartyTypeAdjust | TDThirdPartyTypeTradPlus | TDThirdPartyTypeTracking | TDThirdPartyTypeTopOn | TDThirdPartyTypeBranch | TDThirdPartyTypeIronSource];
+```
+
+<!-- unsupported block: 34 -->
+
+如果需要增加额外参数，可以使用`enableThirdPartySharing:customMap`，该API不支持位运算
+
+### 一、Appsflyer
+
+在AppsFlyer SDK调用start方法之前调用API 
+
+```
+[TDAnalytics enableThirdPartySharing:TDThirdPartyTypeAppsFlyer];
+```
+
+注册创角色之后(可选) 
+
+```
+[TDAnalytics login:@"account_id"];
+[TDAnalytics enableThirdPartySharing:TDThirdPartyTypeAppsFlyer properties:@{@"ta_data11":@"ta_value11"}];
+```
+
+每次调用了TE的`login`方法或者`setDistinctId`方法，您需要同步调用 `enableThirdPartySharing`更新用户标识。
+
+注意:由于AppFlyer的setAdditionalData每次调用，会覆盖设置的用户标识。您可以通过我们提供的`enableThirdPartySharing`方法设置参数:
+
+```
+NSDictionary *dic = @{@"af_test_key1": @"test1",@"af_test_key2": @"test2"};
+[AppsFlyerLib.shared setAdditionalData:dic];
+```
+
+因为setAdditionalData调用多次，会覆盖之前的参数，可以将参数传递给TE，SDK内部会将参数进行拼接合并
+
+```
+NSDictionary *dic = @{@"af_test_key1": @"test1",@"af_test_key2": @"test2"};
+[TDAnalytics enableThirdPartySharing:TDThirdPartyTypeAppsFlyer properties:dic];
+```
+
+### 二、Adjust
+
+在Adjust SDK初始化之前调用 
+
+```
+[TDAnalytics enableThirdPartySharing:TDThirdPartyTypeAdjust];
+```
+
+注册创角色之后(可选) 
+
+```
+[TDAnalytics login:@"account_id"];
+[TDAnalytics enableThirdPartySharing:TDThirdPartyTypeAdjust];
+```
+
+### 三、Branch
+
+在Branch SDK初始化之前调用 
+
+```
+[TDAnalytics enableThirdPartySharing:TDThirdPartyTypeBranch];
+```
+
+注册创角色之后(可选) 
+
+```
+[TDAnalytics login:@"account_id"];
+[TDAnalytics enableThirdPartySharing:TDThirdPartyTypeBranch];
+```
+
+### 四、TopOn
+
+在ATSDK初始化*之前调用:*
+
+```
+[TDAnalytics enableThirdPartySharing:TDThirdPartyTypeTopOn];
+```
+
+多次调用TE的`login`或者`setDistinctId`，需要再次调用enableThirdPartySharing同步数据。
+
+注意:由于TopOn的`setCustomData`每次调用，会覆盖设置的用户标识。您可以通过我们提供的`enableThirdPartySharing`方法设置参数:
+
+```
+NSDictionary *dic = @{@"test_key1": @"test1", @"test_key2": @"test2"};
+[TDAnalytics enableThirdPartySharing:TDThirdPartyTypeTopOn properties:dic];
+```
+
+### 五、Tradplus
+
+在TradPlusSdk初始化之前调用
+
+```
+[TDAnalytics enableThirdPartySharing:TDThirdPartyTypeTradPlus];
+```
+
+### 六、IronSource
+
+在IronSourceSdk初始化之后调用
+
+```
+[TDAnalytics enableThirdPartySharing:TDThirdPartyTypeIronSource];
+```
+
+### 七、AppLovin
+
+- 展示级别
+在AppLovinSdk初始化之后调用
+
+```
+[TDAnalytics enableThirdPartySharing:TDThirdPartyTypeAppLovin];
+```
+
+- 用户级别
+如果要实现变现数据获取，您需要实现 `-[MAAdRevenueDelegate didPayRevenueForAd:]`，在该方法中获取变现数据并且通过 SDK 的`enableThirdPartySharing`进行数据上报，示例代码如下：
+
+```
+- (**void**)didPayRevenueForAd:(MAAd *)ad {
+    //获取 Ad 数据
+    NSDictionary *adInfo = @{
+        @"ad_id": ad.adUnitIdentifier,
+        @"revenue": @(ad.revenue),
+        @"countryCode": [[[ALSdk shared] configuration] countryCode],
+        @"networkName": ad.networkName,
+        @"adUnitId": ad.adUnitIdentifier,
+        @"adFormat": ad.format,
+        @"placement": ad.placement
+    };
+    [TDAnalytics enableThirdPartySharing:TDThirdPartyTypeAppLovin];
+    [TDAnalytics track:@"appLovin_sdk_ad_revenue" properties:adInfo];
+}
+```