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//350/267/250/345/271/263/345/217/260/346/241/206/346/236/266/react-native//346/233/264/346/226/260/346/227/245/345/277/227.md

@@ -0,0 +1,162 @@
+---
+code: rn_sdk_release_note
+name: "更新日志"
+wikiToken: Ii9NwOctfiwoKRkMrlncIYxOnoz
+parentWikiToken: BNJxwC9F9i9i9MkJyYQcbUs2nAf
+updateTime: 1764555971000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=rn_sdk_release_note
+---
+# 更新日志
+
+### v3.2.0
+
+**更新时间: 2025/12/01**
+
+**更新内容：**
+
+- 升级安卓、iOS SDK至最新稳定版本，升级三方插件至最新版本
+- 中间层调整，使用TDAnalytics
+- 新增页面浏览和元素点击事件
+- 已知问题修复
+### v3.1.0
+
+**更新时间: 202****5****/09/****01**
+
+**更新内容：**
+
+- 原生和Webview打通
+- 已知问题修复
+### v3.0.1
+
+**更新时间: 2023/11/27**
+
+**更新内容：**
+
+- 升级Android SDK至3.0.0
+### v3.0.0
+
+**更新时间: 2023/11/08**
+
+**更新内容：**
+
+- 代码规范、注释规范
+### v2.4.6
+
+**更新时间: 2023/04/19**
+
+**更新内容：**
+
+- 优化代码
+- 升级 iOS SDK 到 v2.8.3.2
+### v2.4.5
+
+**更新时间: 2023/02/17**
+
+**更新内容：**
+
+- 优化代码
+### v2.4.4
+
+**更新时间: 2023/02/13**
+
+**更新内容：**
+
+- 优化代码
+### v2.4.3
+
+**更新时间: 2023/02/13**
+
+**更新内容：**
+
+- 优化代码
+### v2.4.2
+
+**更新时间: 2023/02/10**
+
+**更新内容：**
+
+- 兼容web环境
+### v2.4.1
+
+**更新时间: 2023/02/08**
+
+**更新内容：**
+
+- 移除"react-native"版本依赖
+### v2.4.0 
+
+**更新时间: 2023/01/30**
+
+**更新内容：**
+
+- 优化三方数据集成
+### v2.3.0 
+
+**更新时间: 2022/08/10**
+
+**更新内容：**
+
+- 重构RN对外接口 
+- 支持动态公共属性 
+### v2.2.0
+
+**更新时间: 2022/05/26**
+
+**更新内容：**
+
+- 支持三方数据接入
+- 支持数据传输加密 
+- 支持userUniqAppend 
+- 优化数据停止/暂停上报接口 
+- 支持预置属性获取 
+- 自动采集事件支持自定义静态公共属性 
+- 新增获取静态公共属性接口 
+- 支持访客ID获取 
+- 支持设备ID获取 
+- 优化初始化方式 
+### v2.1.2
+
+**更新时间: 2021/03/16**
+
+**更新内容：**
+
+- 适配iOS 14
+- 适配Android 11
+- 新增预置属性#bundle_id(应用唯一标识)
+- 优化网络信号获取逻辑
+### v2.1.1 
+
+**更新时间: 2020/10/29**
+
+**更新内容：**
+
+- 适配 iOS 5G 网络
+- 优化 install,start 事件上报逻辑
+- 优化数据传输格式
+- 默认网络上报策略调整为 2G/3G/4G/5G/WIFI
+### v2.1.0 
+
+**更新时间: 2020/08/27**
+
+**更新内容：**新增 trackUpdate, trackOverwrite, trackFirstEvent 接口
+
+### v2.0.1
+
+**更新时间: 2020/06/05**
+
+**更新内容：**支持 JSONArray 类型
+
+### v2.0.0
+
+**更新时间: 2020/05/25**
+
+**更新内容：**
+
+- 新增 API 接口
+- 支持多实例
+- 支持自动采集事件（新增 APP 安装事件，启动事件，关闭事件，崩溃事件）
+- 支持客户端 SDK 的时间校准功能
+- 新增 optOutTracking/optInTracking 接口
+- 新增 enableTracking 接口, 可以打开或关闭实例上报功能
+- 支持事件和用户属性数据上报
+- 支持公共事件属性

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//350/267/250/345/271/263/345/217/260/346/241/206/346/236/266/react-native//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,60 @@
+---
+code: rn_sdk_debug
+name: "实时调试"
+wikiToken: BPvEwv1zri1YEUkC3OYcYG7XnBb
+parentWikiToken: ZN3GwnZOlipkO0kyWEPcDR27nMg
+updateTime: 1763013486000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=rn_sdk_debug
+---
+# 实时调试
+
+在接入SDK期间，您可以通过查看SDK在IDE控制台中的日志或者使用 AE 的Debug功能，进行实时调试。
+
+### 一、打印SDK日志
+
+可以在SDK初始化时设置enableLog为true,打开SDK日志开关，打开后将会IDE控制台打印上报的数据。
+
+```
+TDAnalytics.init({ 
+    appId: "xxx", 
+    serverUrl: "https://xxx", 
+    enableLog: true 
+}); 
+```
+
+<!-- unsupported block: 34 -->
+
+打开日志后，可以在IDE中过滤 ThinkingAnalytics 相关的日志来观察 SDK 的数据上报。
+
+### 二、开启 Debug 模式
+
+开启Debug模式需要如下两步操作:
+
+1. 客户端开启Debug模式
+以下是客户端开启Debug模式的示例代码:
+
+```
+/*
+设置运行模式为 Debug 模式
+normal模式:数据会存入缓存，并依据一定的缓存策略上报,默认为NORMAL模式；建议在线上环境使用
+debug模式:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
+debugOnly模式:只对数据做校验，不会入库；不建议在线上环境使用
+ */
+TDAnalytics.init({ 
+    appId: "xxx", 
+    serverUrl: "https://xxx", 
+    mode:"debug"
+}); 
+```
+
+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//350/267/250/345/271/263/345/217/260/346/241/206/346/236/266/react-native//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,140 @@
+---
+code: rn_sdk_autotrack
+name: "自动采集"
+wikiToken: BmlowaQcCiivGvkB1Slc7CGfn26
+parentWikiToken: ZN3GwnZOlipkO0kyWEPcDR27nMg
+updateTime: 1764558942000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=rn_sdk_autotrack
+---
+# 自动采集
+
+### 一、开启自动采集事件
+
+您可以调用 `enableAutoTrack` 并传入一个 `TDAutoTrackEventType` 类型来开启自动采集。当前支持六种：
+
+- `ta_app_start`: 应用进入前台，对应类型为`TDAutoTrackEventType.APP_START`
+- `ta_app_end`: 应用进入后台，对应类型为 `TDAutoTrackEventType.APP_END`
+- `ta_app_install`: 安装后首次打开应用，对应类型为 `TDAutoTrackEventType.APP_INSTALL`
+- `ta_app_crash`: 出现未捕获异常导致应用闪退，对应类型为 `TDAutoTrackEventType.APP_CRASH`
+- `ta_app_view`：APP 在使用Navigator路由跳转时触发，对应类型为`TDAutoTrackEventType.APP_VIEW_SCREEN`（3.2.0及之后的版本支持）
+- `ta_app_click`：APP 控件点击事件将会在用户点击控件时触发，对应类型为`TDAutoTrackEventType.APP_CLICK`（3.2.0及之后的版本支持）
+关于自动采集事件，需要注意：
+
+1. 自动采集事件是在 native SDK 中实现的，因此动态公共属性目前无法在自动采集事件中添加。
+1. 如果您需要设置访客 ID，或者公共属性，请在开启自动采集事件之前完成设置。
+开启自动采集示例：
+
+```
+TDAnalytics.enableAutoTrack(TDAutoTrackEventType.APP_START | TDAutoTrackEventType.APP_END | TDAutoTrackEventType.APP_INSTALL| TDAutoTrackEventType.APP_CRASH | TDAutoTrackEventType.APP_CLICK | TDAutoTrackEventType.APP_VIEW_SCREEN);
+```
+
+### 二、详细介绍
+
+#### 2.1 浏览页面事件
+
+App 页面浏览事件支持 React Navigation ^2.0 ~ ^6.0
+
+APP 在使用navigation路由跳转时触发，详细的事件介绍如下：
+
+- 事件名：ta_app_view
+- 预置属性：
+`#screen_name`：字符串型，页面名称
+
+`#title`：字符串型，页面标题
+
+`#referrer`：字符串型，前向地址
+
+- 开启方式：
+- 调用`enableAutoTrack`，传入`TDAutoTrackEventType.APP_VIEW_SCREEN`
+```
+TDAnalytics.enableAutoTrack(TDAutoTrackEventType.APP_VIEW_SCREEN);
+```
+
+- 执行脚本
+```
+node node_modules/react-native-thinking-data/ThinkingDataRNHook.js -run
+```
+
+- 设置页面自定义属性：在通过 Navigation 跳转时，可以在 params 中添加自定义属性，SDK 会自动使用 params 中的设置值对 App 页面浏览事件的属性进行补充或覆盖。
+```
+navigation.navigate('PageB', {
+  thinkingdataparams: {
+    name: 'name_A',
+    '#title': '第二个页面',
+    '#screen_name': "page_B"
+  }
+});
+```
+
+如果需要自定义#title和#screen_name，可以在thinkingdataparams参数内传入。
+
+- 忽略单个页面浏览事件：在thinkingdataparams中添加TDIgnoreViewScreen属性且值为 true 时会忽略该页面浏览事件
+```
+navigation.navigate('PageB', {
+  thinkingdataparams: {
+    name: 'name_A',
+    '#title': '第二个页面',
+    '#screen_name': "page_B"，
+    TDIgnoreViewScreen: true
+  }
+});
+```
+
+#### 2.2 元素点击事件
+
+App 元素点击事件支持 React Native 0.23 ~ 0.70.0
+
+APP 控件点击事件将会在用户点击控件时触发
+
+- 事件名：ta_app_click
+- 预置属性：
+`#screen_name`：字符串型，页面名称
+
+`#title`：字符串型，页面标题
+
+`#element_content`：字符串型，元素内容
+
+- 开启方式：
+- 调用`enableAutoTrack`，传入`TDAutoTrackEventType.APP_CLICK`
+```
+TDAnalytics.enableAutoTrack(TDAutoTrackEventType.APP_CLICK);
+```
+
+- 执行脚本：
+```
+node node_modules/react-native-thinking-data/ThinkingDataRNHook.js -run
+```
+
+- 设置控件自定义属性：在控件中添加自定义属性thinkingdataparams
+```
+<CustomButton
+  title="按钮"
+  thinkingdataparams={{
+    name: 'button',
+    pro_key:'pro_value'
+  }}
+/>
+```
+
+- 忽略单个控件点击事件：在thinkingdataparams中添加TDIgnoreViewClick属性且值为 true 时会忽略该控件点击事件
+```
+<CustomButton
+  title="按钮"
+  thinkingdataparams={{
+    name: 'button',
+    pro_key:'pro_value'
+    TDIgnoreViewClick: true
+  }}
+/>
+```
+
+### 三、设置自动采集事件自定义属性
+
+您可以调用 `enableAutoTrack`设置自动采集事件的属性
+
+```
+TDAnalytics.enableAutoTrack(TDAutoTrackEventType.APP_START,{
+        auto_name: "xxx",
+        auto_age: "xxx"
+})
+```

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//350/267/250/345/271/263/345/217/260/346/241/206/346/236/266/react-native//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,23 @@
+---
+code: rn_sdk_preset_properties
+name: "预置属性"
+wikiToken: Fk5qw1oCGizY5zkcZ3fce7STn1P
+parentWikiToken: ZN3GwnZOlipkO0kyWEPcDR27nMg
+updateTime: 1745310903000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=rn_sdk_preset_properties
+---
+# 预置属性
+
+### 一、预置属性说明
+
+iOS,Android平台采集的预置属性会有一定的差异，具体可以参考如下文档:
+
+iOS平台预置属性，Android平台预置属性
+
+### 二、 获取预置属性
+
+```
+async () => {
+  var presetProperties = await TDAnalytics.getPresetProperties()
+}
+```