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/unreal.md

@@ -0,0 +1,228 @@
+---
+code: unreal_sdk_installation
+name: "Unreal"
+wikiToken: WzIhwbKmkiwbUDkYZ4hcySdrnrg
+parentWikiToken: BAU2w0eipiqGnckeUsIc0mYQnZc
+updateTime: 1760166643000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=unreal_sdk_installation
+---
+# Unreal
+
+::: tip 提示
+
+ 在接入前, 请先阅读接入前准备。
+
+TDAnalytics 实现了虚幻引擎内置的 Analytics 服务，同时也支持直接通过 C++ 代码调用接口上报数据。目前支持 Android、iOS、 Windows 和 macOS 平台。支持虚幻引擎4.26+和5.+版本。
+
+ :::
+
+**最新版本:** v3.0.3
+
+**更新时间:** 2025-10-11
+
+**资源下载: **源码、SDK下载
+
+::: warning 注意
+
+当前文档适用于 v2.0.0 及以后的版本，历史版本请参考 Unreal 接入指南（V1），SDK下载（v1.6.0）
+
+::: 
+
+### 一、集成SDK
+
+#### 1.1 集成 TDAnalytics 插件
+
+下载 Unreal SDK，解压后将 `TDAnalytics` 放入您项目的 `Plugins` 目录； 如果 `Plugins` 目录不存在，首先在项目根目录下创建 `Plugins` 目录，然后将 `TDAnalytics` 目录放入其中。
+
+#### 1.2 激活 TDAnalytics 插件
+
+为了启用 TDAnalytics 插件，你需要执行以下步骤：
+
+- 重启 Unreal Editor
+- 打开 编辑 > 插件，在项目 `Analytics` 类别下，启用 `TDAnalytics`
+- 如果您使用 Blueprint，请启用内置 `Analytics` 类别下的 `Analytics Blueprint Library`
+- 再次重启 Unreal Editor
+- 打开 编辑>项目设置，在插件类别下，设置 TDAnalytics 参数：
+- Server Url: 必填。接收端地址，需使用 https 类型的地址
+- App ID: 必填。您项目的 APP ID，在 AE 后台项目管理页可以查看
+- TimeZone: 可选，如果需要对齐时区，请填写规范的 TimeZone ID，例如"UTC01:00". 不需要对齐时区的情况下，不需要填写
+- Enable Encrypt: 是否开启数据加密 默认false，开启后数据会加密后上传到 AE 
+- EncryptPublicKey: 可选，不填则使用默认配置，加密公钥 
+- EncryptVersion: 可选，不填则使用默认配置，密钥版本 
+- SymmetricEncryption: 可选，不填则使用默认配置，对称密钥 
+- AsymmetricEncryption: 可选，不填则使用默认配置，非对称密钥 
+<!-- unsupported block: 34 -->
+
+注意：Windows/MacOS 暂不支持对齐时区。
+
+- 在 `Config` 目录下的 `DefaultEngine.ini` 文件中添加以下内容:
+```
+[Analytics]
+ProviderModuleName=TDAnalytics
+```
+
+- 如果您希望直接在 C++ 代码中使用 `TDAnalytics` 接口，需要在您项目的 `*.Build.cs` 文件中添加以下内容：
+```
+PrivateDependencyModuleNames.AddRange(new string[] { "TDAnalytics" });
+PrivateIncludePathModuleNames.AddRange(new string[] { "TDAnalytics" });
+```
+
+并且，在您希望使用 SDK 的文件中引用 `TDAnalytics``.h` 头文件:
+
+```
+#include "TDAnalytics.h"
+```
+
+### 二、初始化
+
+以下是SDK初始化的示例代码:
+
+```
+// 初始化 SDK
+UTDAnalytics::Initialize();
+```
+
+初始化完成之后，就可以使用 SDK 上报事件了。
+
+### 三、常用功能
+
+在使用常用功能之前，建议你先了解用户识别规则；SDK默认会生成随机数作为访客ID，并持久化存储访客ID在本地；用户未登录之前，会以访客ID作为身份识别ID。注意:访客 ID 在用户重新安装 App 以及更换设备时将会变更。
+
+#### 3.1 设置账号ID
+
+在用户进行登录时，可调用 `Login` 来设置用户的账号 ID， AE 平台将会以账号 ID 作为身份识别 ID，并且设置的账号 ID 将会在调用 `Logout` 之前一直保留。多次调用 `Login` 将覆盖先前的账号 ID 。
+
+```
+// 用户的登录唯一标识，此数据对应上报数据里的#account_id，此时#account_id的值为TA
+UTDAnalytics::Login("TA");
+```
+
+`Login` 可以多次调用，每次调用会判断传入的账号 ID 与先前保存的 ID 是否一致，一致则忽略调用，不一致则会覆盖先前的 ID。
+
+<!-- unsupported block: 34 -->
+
+**该方法不会上传登录事件**
+
+#### 3.2 设置公共事件属性
+
+公共事件属性指的就是每个事件都会带有的属性，您可以调用 `SetSuperProperties` 来设置公共事件属性，我们推荐您在发送事件前，先设置公共事件属性。对于一些重要的属性，譬如用户的会员等级、来源渠道等，这些属性需要设置在每个事件中，此时您可以将这些属性设置为公共事件属性。
+
+```
+    TSharedPtr<FJsonObject> Properties = MakeShareable(new FJsonObject);
+    Properties->SetStringField("channel", "ta");//字符串
+    Properties->SetNumberField("age", 1);//数字
+    Properties->SetBoolField("isSuccess", true);//布尔
+    FDateTime DateTime = FDateTime::Now();
+    Properties->SetStringField("birthday", FDateTime::FromUnixTimestamp(DateTime.ToUnixTimestamp()).ToString(TEXT("%Y-%m-%d %H:%M:%S.")) += *FString::Printf(TEXT("%03d"), DateTime.GetMillisecond()));//时间
+
+    TSharedPtr<FJsonObject> ItemProperties = MakeShareable(new FJsonObject);
+    ItemProperties->SetStringField("itemChannel", "item");
+    Properties->SetObjectField("object", ItemProperties);//对象
+
+    TArray< TSharedPtr<FJsonValue> > DataObjectArray;
+    TSharedPtr<FJsonObject> ArrayItemProperties = MakeShareable(new FJsonObject);
+    ArrayItemProperties->SetStringField("arrayItemChannel", "array_item");
+    TSharedPtr<FJsonValueObject> DataObjectValue = MakeShareable(new FJsonValueObject(ArrayItemProperties));
+    DataObjectArray.Add(DataObjectValue);
+    Properties->SetArrayField("object_arr", DataObjectArray);//对象组
+
+    TArray< TSharedPtr<FJsonValue> > DataArray;
+    TSharedPtr<FJsonValueString> DataValue = MakeShareable(new FJsonValueString("data_value"));
+    DataArray.Add(DataValue);
+    Properties->SetArrayField("arr", DataArray);//数组
+
+    UTDAnalytics::SetSuperProperties(Properties, AppID);
+```
+
+- Key 为该属性的名称，为字符串类型，规定只能以字母开头，包含数字，字母和下划线 "_"，长度最大为 50 个字符，对字母大小写不敏感，AE 会统一转化为小写字母
+- Value 为该属性的值，支持字符串、数字、布尔、时间、对象、对象组、数组
+<!-- unsupported block: 34 -->
+
+**事件属性、用户属性的要求与公共事件属性保持一致**
+
+#### 3.3 开启自动采集
+
+以下代码示例开启安装、启动、关闭事件（PC端不支持自动采集），如果您想详细了解SDK的自动采集能力，可以查看自动采集功能详细介绍
+
+```
+// 开启自动采集
+UTDAnalytics::EnableAutoTrack();
+```
+
+#### 3.4 发送事件
+
+您可以调用 `T``r``ack` 来上传事件，建议您根据先前梳理的埋点文档来设置事件的属性以及发送信息的条件，此处以用户购买某商品作为范例：
+
+```
+TSharedPtr<FJsonObject> Properties = MakeShareable(new FJsonObject);
+Properties->SetStringField("product_name", "商品名");//字符串
+// 上报一个不带属性事件
+UTDAnalytics::Track("product_buy", Properties);
+```
+
+事件的名称是字符串类型，只能以字母开头，可包含数字，字母和下划线 "_"，长度最大为 50 个字符。
+
+#### 3.5 设置用户属性
+
+对于一般的用户属性，您可以调用 `UserSet`来进行设置，使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例。
+
+```
+ //此时"username"为"TA"
+TSharedPtr<FJsonObject> Properties = MakeShareable(new FJsonObject);
+Properties->SetStringField("username", "TA");//字符串
+UTDAnalytics::UserSet(Properties);
+//此时"userName"为"TE"
+TSharedPtr<FJsonObject> NewProperties = MakeShareable(new FJsonObject);
+NewProperties->SetStringField("username", "TE");//字符串
+UTDAnalytics::UserSet(NewProperties);
+```
+
+### 四、最佳实践
+
+以下示例代码包含以上所有操作，我们推荐按照如下步骤使用:
+
+```
+#include "TDAnalytics.h"
+if (授权隐私政策) {
+   //初始化 SDK
+   UTDAnalytics::Initialize();
+   // 开启自动采集事件
+   UTDAnalytics::EnableAutoTrack();
+   //如果用户已登录，可以设置用户的账号ID作为身份唯一标识
+   UTDAnalytics::Login("TA");
+   //设置公共事件属性
+   TSharedPtr<FJsonObject> Properties = MakeShareable(new FJsonObject);
+   Properties->SetStringField("channel", "ta");//字符串
+   Properties->SetNumberField("age", 1);//数字
+   Properties->SetBoolField("isSuccess", true);//布尔
+   FDateTime DateTime = FDateTime::Now();
+   Properties->SetStringField("birthday", FDateTime::FromUnixTimestamp(DateTime.ToUnixTimestamp()).ToString(TEXT("%Y-%m-%d %H:%M:%S.")) += *FString::Printf(TEXT("%03d"), DateTime.GetMillisecond()));//时间
+
+   TSharedPtr<FJsonObject> ItemProperties = MakeShareable(new FJsonObject);
+   ItemProperties->SetStringField("itemChannel", "item");
+   Properties->SetObjectField("object", ItemProperties);//对象
+
+   TArray< TSharedPtr<FJsonValue> > DataObjectArray;
+   TSharedPtr<FJsonObject> ArrayItemProperties = MakeShareable(new FJsonObject);
+   ArrayItemProperties->SetStringField("arrayItemChannel", "array_item");
+   TSharedPtr<FJsonValueObject> DataObjectValue = MakeShareable(new FJsonValueObject(ArrayItemProperties));
+   DataObjectArray.Add(DataObjectValue);
+   Properties->SetArrayField("object_arr", DataObjectArray);//对象组
+
+   TArray< TSharedPtr<FJsonValue> > DataArray;
+   TSharedPtr<FJsonValueString> DataValue = MakeShareable(new FJsonValueString("data_value"));
+   DataArray.Add(DataValue);
+   Properties->SetArrayField("arr", DataArray);//数组
+   UTDAnalytics::SetSuperProperties(Properties, AppID);
+   //发送事件
+   TSharedPtr<FJsonObject> Properties = MakeShareable(new FJsonObject);
+   Properties->SetStringField("product_name", "商品名");//字符串
+   UTDAnalytics::Track("product_buy", Properties);
+   //设置用户属性
+   TSharedPtr<FJsonObject> UserProperties = MakeShareable(new FJsonObject);
+   UserProperties->SetStringField("username", "TA");//字符串
+   UTDAnalytics::UserSet(Proper);
+}
+```
+
+###

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.md

@@ -0,0 +1,20 @@
+---
+code: game_engine_sdk_installation
+name: "游戏引擎"
+wikiToken: BAU2w0eipiqGnckeUsIc0mYQnZc
+parentWikiToken: FTcTwinIOi3OiRkK4MPc2Ex7neg
+updateTime: 1745310872000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=game_engine_sdk_installation
+---
+# 游戏引擎
+
+<!-- unsupported block: 22 -->
+
+- Unity
+- Unreal
+- Cocos2d-x
+- Cocos2d-Lua
+- CocosCreator
+- LayaAir
+- Egret
+- Corona

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/flutter//345/220/210/350/247/204/346/214/207/345/215/227.md

@@ -0,0 +1,37 @@
+---
+code: flutter_sdk_compliance
+name: "合规指南"
+wikiToken: R3eIwcw0ZifH61k6F3acDdXJnib
+parentWikiToken: OxdhwoyTDiS4kLknBKBcxZH3n7C
+updateTime: 1745309816000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=flutter_sdk_compliance
+---
+# 合规指南
+
+### 一. 隐私政策中填写 SDK 相关内容
+
+#### 1.1 收集和获取
+
+在《隐私政策》中收集和获得您的个人信息栏目中根据实际情况填写以下内容。
+
+当您在激活使用时，我们会通过ThinkingData收集您的设备信息（IDFV、AndroidID、操作系统、设备型号、设备制造商、系统版本、应用进程信息等）用于统计分析您在 App 内的使用效果。
+
+#### 1.2 与授权合作伙伴共享
+
+在《隐私政策》中的与授权合作伙伴共享栏目中根据实际情况填写以下内容。
+
+ThinkingData SDK：收集您的设备信息（IDFV、AndroidID、操作系统、设备型号、设备制造商、系统版本、应用进程信息等）、联网信息用于数据分析，从而改进我们的产品和服务。
+
+### 二. SDK合规步骤
+
+ThinkingData SDK需要在用户同意 《隐私政策》后初始化
+
+```
+// 根据隐私协议判断是否开启数据采集
+import 'package:thinking_analytics/thinking_analytics.dart';
+if (授权隐私政策)
+{
+   //SDK初始化
+   await TDAnalytics.init(APPID, SERVER_URL);
+}
+```

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

@@ -0,0 +1,201 @@
+---
+code: flutter_sdk_release_note
+name: "更新日志"
+wikiToken: LWwAw8ZY2iDhJnkd7Cacou0tnnf
+parentWikiToken: OxdhwoyTDiS4kLknBKBcxZH3n7C
+updateTime: 1762773097000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=flutter_sdk_release_note
+---
+# 更新日志
+
+### v3.3.1
+
+**更新时间: 2025/11/10**
+
+**更新内容：**
+
+- 修复已知问题
+### v3.3.0
+
+**更新时间: 2025/08/21**
+
+**更新内容：**
+
+- 支持鸿蒙平台
+- 支持页面浏览和元素点击事件
+- JS打通接口优化
+### v3.2.2
+
+**更新时间: 2025/08/19**
+
+**更新内容：**
+
+- 已知问题修复
+### v3.2.1
+
+**更新时间: 2025/08/01**
+
+**更新内容：**
+
+- 已知问题修复
+### v3.2.0
+
+**更新时间: 2025/06/11**
+
+**更新内容：**
+
+- 升级安卓SDK至3.1.1，iOS至3.1.0
+- 新增getAccountId接口
+- 支持flutter3.29
+- 已知问题修复
+### v3.1.3
+
+**更新时间: 2025/05/16**
+
+**更新内容：**
+
+- 升级安卓SDK至3.0.2.3
+### v3.1.2
+
+**更新时间: 2025/04/29**
+
+**更新内容：**
+
+- 升级安卓iOS三方插件SDK
+### v3.1.1
+
+**更新时间: 2025/04/22**
+
+**更新内容：**
+
+- 兼容Flutter3.29版本
+### v3.1.0
+
+**更新时间: 2024/****11****/1****9**
+
+**更新内容：**
+
+- 原生和Webview打通
+- 解决iOS ThinkingDataCore版本依赖的问题
+### V3.0.1
+
+**更新时间: 2023/11/24**
+
+**更新内容：**
+
+- 升级Android、iOS SDK至3.0.0
+### V3.0.0
+
+**更新时间: 2023/08/28**
+
+**更新内容：**
+
+- 代码规范、注释规范
+### V2.2.2
+
+**更新时间: 2023/03/16**
+
+**更新内容：**
+
+- 代码注释规范
+### V2.2.1
+
+**更新时间: 2023/03/03**
+
+**更新内容：**
+
+- login和logout添加future回调
+### V2.2.0
+
+**更新时间: 2022/11/17**
+
+**更新内容：**
+
+- 更新安卓（2.8.1.7）iOS （2.8.1.6）SDK
+### v2.1.0 
+
+**更新时间: 2022/05/27**
+
+**更新内容：**
+
+- 支持三方数据接入需求 
+- 支持数据传输加密 
+- 支持userUniqAppend 
+- 优化数据停止/暂停上报接口 
+- 优化获取预置属性接口 
+- 自动采集事件支持自定义静态属性 
+- 新增获取静态公共属性接口 
+### v2.0.1 
+
+**更新时间: 2021/06/08**
+
+**更新内容：**支持预置属性获取
+
+### v2.0.0 
+
+**更新时间: 2021/05/17**
+
+**更新内容：**适配Flutter2.0
+
+### v1.3.3 
+
+**更新时间: 2020/10/29**
+
+**更新内容：**
+
+- 适配 iOS 5G 网络
+- 优化 install,start 事件上报逻辑
+- 优化数据传输格式
+- 默认网络上报策略调整为 2G/3G/4G/5G/WIFI
+### v1.3.2 
+
+**更新时间: 2020/08/25**
+
+**更新内容：**修复特殊事件不设置 timeZone 导致上报错误的#zone_offset 的问题.
+
+### v1.3.0
+
+**更新时间: 2020/08/24**
+
+**更新内容：**
+
+- 支持首次事件, 允许传入自定义的 ID 校验是否首次上报
+- 支持可更新、可重写的事件
+### v1.2.1 
+
+**更新时间: 2020/06/28**
+
+**更新内容：**修复极端情况下的空指针异常
+
+### v1.2.0 
+
+**更新时间: 2020/06/23**
+
+**更新内容：**
+
+- 优化 Debug 模式，配合后台埋点管理
+- 支持 #system_language 属性
+### v1.1.1
+
+**更新时间: 2020/04/14**
+
+**更新内容：**修复 Android 平台 DEBUG 模式下事件上传的 BUG
+
+### v1.1.0 
+
+**更新时间: 2020/04/03**
+
+**更新内容：**支持使用时间戳校准
+
+### v1.0.0 
+
+**更新时间: 2020/03/10**
+
+**更新内容：**
+
+- 支持事件和用户属性数据上报
+- 支持多实例和轻实例
+- 支持公共事件属性和动态公共属性
+- 支持自动采集事件
+- 支持 Debug 模式
+- 支持设置默认时区

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/flutter//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,54 @@
+---
+code: flutter_sdk_debug
+name: "实时调试"
+wikiToken: Fw5dwDn0DiUNnMkIbVdcACEjnVc
+parentWikiToken: CNPfwkQYaiYn4Wkkbqac8cBwnUh
+updateTime: 1763013372000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=flutter_sdk_debug
+---
+# 实时调试
+
+在SDK接入过程中，您可以通过查看SDK在IDE控制台中的日志或者使用 AE 的Debug功能，进行实时调试。
+
+### 一、打印SDK日志
+
+```
+TDAnalytics.*enableLog*(true);
+```
+
+<!-- unsupported block: 34 -->
+
+打开日志后，可以在IDE中过滤 ThinkingAnalytics 相关的日志来观察 SDK 的数据上报。
+
+### 二、开启 Debug 模式
+
+开启Debug模式需要如下两步操作:
+
+1. 客户端开启Debug模式
+以下是客户端开启Debug模式的示例代码:
+
+```
+/*
+设置运行模式为 Debug 模式
+NORMAL模式:数据会存入缓存，并依据一定的缓存策略上报,默认为NORMAL模式；建议在线上环境使用
+Debug模式:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
+DebugOnly模式:只对数据做校验，不会入库；不建议在线上环境使用
+ */
+TDConfig config = TDConfig();
+config.appId = "appId";
+config.serverUrl = "serverUrl";
+config.setMode(TDMode.DEBUG);
+TDAnalytics.*initWithConfig*(config);
+```
+
+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/flutter//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,139 @@
+---
+code: flutter_sdk_autotrack
+name: "自动采集"
+wikiToken: FEltw8wLjizkqikfz9QcedJnnte
+parentWikiToken: CNPfwkQYaiYn4Wkkbqac8cBwnUh
+updateTime: 1764557625000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=flutter_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`
+- `ta_app_click`：APP 控件点击事件将会在用户点击控件时触发，对应类型为`TDAutoTrackEventType.APP_CLICK`
+关于自动采集事件，需要注意：
+
+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 在使用Navigator路由跳转时触发，详细的事件介绍如下：
+
+- 事件名：ta_app_view
+- 预置属性：
+`#screen_name`：字符串型，页面名称
+
+`#title`：字符串型，页面标题
+
+`#referrer`：字符串型，前向地址
+
+- 开启步骤：
+- 添加全局监听，在MaterialApp下增加navigatorObservers
+```
+import 'package:thinking_analytics/autotrack/td_page_view.dart';
+
+void main() => runApp(new MaterialApp(
+    navigatorObservers: TDNavigatorObserver.*wrap*([]), home: MyApp()));
+```
+
+- 调用*enableAutoTrack开启，示例代码如下：*
+```
+TDAnalytics.*enableAutoTrack*(TDAutoTrackEventType.*APP_VIEW_SCREEN*,
+    autoTrackEventProperties: {
+      "test_property": "test_property_value"
+    },
+    autoTrackPageConfig: TDAutoTrackConfig(
+      pageConfigs: [
+        TDAutoTrackPageConfig<Page1>(
+          screenName: "Page1",
+          title: "第一个页面",
+        ),
+        TDAutoTrackPageConfig<Page2>(
+          screenName: "Page2",
+          title: "第二个页面",
+          ignore: false,
+          properties: {
+            "multi_property": "multi_property_value"
+          },
+        )
+      ],
+));
+```
+
+autoTrackEventProperties：设置自动采集的公共属性
+
+autoTrackPageConfig：页面浏览相关的配置信息，可以自定义每一个页面的title和screenName，ignore是是否需要忽略这个页面的采集，properties是该页面的自定义属性
+
+<!-- unsupported block: 19 -->
+
+需要尽早开启，否则第一个页面的生命周期已过，采集不到第一个页面的浏览事件
+
+#### 2.1 元素点击事件
+
+APP 控件点击事件将会在用户点击控件时触发
+
+- 事件名：ta_app_click
+- 预置属性：
+`#screen_name`：字符串型，页面名称
+
+`#title`：字符串型，页面标题
+
+`#element_type`：字符串型，元素类型
+
+`#element_content`：字符串型，元素内容
+
+- 开启步骤
+```
+TDAnalytics.*enableAutoTrack*(TDAutoTrackEventType.*APP_CLICK*);
+```
+
+- 控件自定义属性
+通过设置TDElementKey来自定义属性
+
+- 第一个参数：元素ID，对应属性#element_id
+- properties：自定义属性
+- isIgnore：是否忽略该控件自动采集事件
+```
+import 'package:thinking_analytics/autotrack/td_autotrack_config.dart';
+
+ElevatedButton(
+    key: TDElementKey("元素ID", properties: {"key": "value"},isIgnore: true),
+    onPressed: () {},
+    child: Text(
+      "按钮2",
+      style: TextStyle(fontSize: 14),
+    )),
+```
+
+### 三、设置自定义采集事件公共属性
+
+可以调`setAutoTrackProperties`设置或者更新自定义属性
+
+```
+TDAnalytics.*enableAutoTrack*(TDAutoTrackEventType.*APP_START*,
+    autoTrackEventProperties: {
+  'auto_test': 'stu',
+  'auto_arr': [1, 2, 3],
+  'auto_obj': {'obj_test': 'xxx'}
+});
+```