@thinkingai/ae-cli 1.0.30 → 6.0.16

package/wiki/te-docs/raw//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/cocos2d-lua//350/277/233/351/230/266/346/214/207/345/215/227.md

@@ -0,0 +1,236 @@
+---
+code: cocos2d_lua_sdk_advanced
+name: "进阶指南"
+wikiToken: JT03w6EvOiyVqckztCwcH3Kynm7
+parentWikiToken: UDhNw7ShXiLkTukQ7GTcjKwGnge
+updateTime: 1776262572000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=zh-CN&code=cocos2d_lua_sdk_advanced
+---
+
+## 一、设置用户ID
+SDK 实例默认会使用随机数作为每个用户的默认访客 ID，该 ID 将会作为用户在未登录状态下身份识别 ID。需要注意的是，访客 ID 在用户重新安装 App 以及更换设备时将会变更。
+### 1.1 设置访客 ID
+::: tip 提示
+ 一般情况下，您不需要自定义访客 ID. 请确保已经理解[<text color="purple" underline="true">用户识别规则</text>](https://thinkingdata.feishu.cn/wiki/AUyiw6XZsiF9EMk2fBScKjzunjd)，再进行访客 ID 的设置。
+如果您需要替换访客 ID，则应当在初始化 SDK 结束之后立即进行调用，请勿多次调用，以免产生无用的账号
+ :::
+如果您的游戏对每个用户有自己的访客 ID 管理体系，则您可以调用 `setDistinctId` 来设置访客 ID：
+```lua
+// 将访客ID设置为Thinker
+TDAnalytics.setDistinctId("Thinker");
+```
+
+如果需要获得当前访客 ID，可以调用 `getDistinctId` 获取：
+```lua
+//返回访客ID
+local distinctId = TDAnalytics.getDistinctId();
+```
+
+### 1.2 设置账号 ID
+在用户进行登录时，可调用 `login` 来设置用户的账号 ID， AE 平台将会以账号 ID 作为身份识别 ID，并且设置的账号 ID 将会在调用 `logout` 之前一直保留。多次调用 `login` 将覆盖先前的账号 ID 。
+```lua
+--用户的登录唯一标识，此数据对应上报数据里的#account_id，此时#account_id的值为TA
+TDAnalytics.login("TA");
+```
+
+<quote-container>
+**该方法不会上传登录事件**
+</quote-container>
+
+### 1.3 清除账号ID
+在用户产生登出行为之后，可调用 `logout` 来清除账号 ID，在下次调用 `login` 之前，将会以访客 ID 作为身份识别 ID。
+```lua
+TDAnalytics.logout();
+```
+
+我们推荐您在显性的登出事件时调用 `logout`，比如用户产生了注销账号这一行为时才调用，而不需要在关闭 App 时调用。
+<quote-container>
+**该方法不会上传登出事件**
+</quote-container>
+
+## 二 、发送事件
+在 SDK 初始化完成之后，您就可以进行数据埋点，收集用户的的行为信息。一般情况下普通事件即可满足业务场景需求，您也可以根据自己的实际业务场景使用首次、可更新等事件。
+### 2.1 普通事件
+您可以调用 `track` 来上传事件，建议您根据先前梳理的文档来设置事件的属性以及发送事件的条件，此处以用户购买某商品作为范例：
+```lua
+local properties = { 
+    product_name = "商品名"
+}
+TDAnalytics.track("product_buy", properties)
+```
+
+### 2.2 首次事件
+首次事件是指针对某个设备或者其他维度的 ID，只会记录一次的事件。例如在一些场景下，您可能希望记录在某个设备上的激活事件，则可以用首次事件来上报数据。
+```lua
+-- 示例：上报设备首次事件, 假设事件名为 device_activation
+TDAnalytics.trackFirst("device_activation", nil, {
+    test_string="first_string"
+})
+```
+
+如果您希望以设备以外的其他维度来判断是否首次，则可以为首次事件自定义first_check_id:
+```lua
+-- 将用户ID设置为首次事件的first_check_id，实现用户首次激活事件的采集
+TDAnalytics.trackFirst("account_activation", "TA", {
+    test_string="first_string"
+})
+```
+
+<quote-container>
+注意：由于在服务端完成对是否首次的校验，首次事件默认会延时 1 小时入库。
+</quote-container>
+
+### 2.3 可更新事件
+您可以通过可更新事件实现特定场景下需要修改事件数据的需求。可更新事件需要指定标识该事件的 ID，并在创建可更新事件对象时传入。AE 后台将根据事件名和事件 ID 来确定需要更新的数据。
+```lua
+-- 示例： 上报可被更新的事件，假设事件名为 UPDATABLE_EVENT
+-- 上报后事件属性 status 为 3, price 为 100
+TDAnalytics.trackUpdate("UPDATABLE_EVENT", "Update_EventId", {
+    status = 3,
+    price = 100
+})
+
+-- 上报后事件属性 status 被更新为 5, price 不变
+TDAnalytics.trackUpdate("UPDATABLE_EVENT", "Update_EventId", {
+    status = 5
+})
+```
+
+### 2.4 可重写事件
+可重写事件与可更新事件类似，区别在于可重写事件会用最新的数据完全覆盖历史数据，从效果上看相当于删除前一条数据，并入库最新的数据。AE 后台将根据事件名和事件 ID 来确定需要更新的数据。
+```lua
+-- 示例： 上报可被重写的事件，假设事件名为 OVERWRITABLE_EVENT
+TDAnalytics.trackOverwrite("OVERWRITABLE_EVENT", "Overwrite_EventId", {
+    status = 3,
+    price = 100
+})
+
+-- 上报后事件属性 status 被更新为 5, price 属性被删除
+TDAnalytics.trackOverwrite("OVERWRITABLE_EVENT", "Overwrite_EventId", {
+    status = 5
+})
+```
+
+### 2.5 公共事件属性
+公共事件属性指的就是每个事件都会上传的属性。根据属性更新频率，公共事件属性分为`静态公共事件属性`和`动态公共事件属性`。您可以根据具体的业务场景需求，选择不同的公共事件属性设置方法；我们推荐您在发送事件前，先设置公共事件属性。针对同一事件，当公共事件属性、事件自定义属性、预置属性的Key相同时，我们会按照如下优先级进行赋值:`自定义属性>动态公共事件属性>静态公共事件属性>预置属性`。
+#### 2.5.1 静态公共事件属性
+静态公共事件属性是低频变化且每个事件都会带有的属性，如用户会员等级。通过`setSuperProperties`设置静态公共事件属性之后，SDK将会在事件采集时获取设置的公共事件属性作为事件的属性。
+```lua
+-- 设置公共属性
+TDAnalytics.setSuperProperties({
+    vip_level = 2
+})
+```
+
+静态公共事件属性将会被保存到缓存中，无需每次启动 App 时调用。如果该属性已存在，重新设置的属性将会覆盖原有属性值;如果之前不存在该属性，则会新建属性。除了属性设置，我们也提供其他API来操作静态公共事件属性，满足日常的业务需求。
+```lua
+-- 清除属性名为 trip 的公共属性
+TDAnalytics.unsetSuperProperty("trip")
+-- 清空所有公共属性
+TDAnalytics.clearSuperProperties()
+-- 获取所有公共属性
+TDAnalytics.currentSuperProperties()
+```
+
+#### 2.5.2 动态公共事件属性
+动态公共事件属性是高频变化且每个事件都会带有的属性，如用户的金币数量。通过 `setDynamicSuperProperties` 设置动态公共属性类之后，SDK 将会在事件采集时自动获取动态公共事件的属性，并添加到触发的事件中。
+```lua
+local coin = 0;
+local dynamicProperties = function()
+    coin++
+    local properties = { coin = coin }
+    return properties
+end
+TDAnalytics.setDynamicSuperProperties(dynamicProperties);
+```
+
+### 2.6 记录事件时长
+如果您需要记录某个事件的持续时长，可以调用 `timeEvent` 来开始计时。配置您想要计时的事件名称，当您上传该事件时，将会自动在您的事件属性中加入 `#duration` 这一属性来表示记录的时长，单位为秒。需要注意的是，同一个事件名只能有一个在计时的任务。
+```lua
+--以下示例，完成用户在某个商品页面停留时长的统计
+-- 用户进入商品页面，开始计时
+TDAnalytics.timeEvent("stay_shop")
+-- do some thing...
+-- 用户离开商品页面，计时结束，"stay_shop" 这一事件中将会带有表示事件时长的属性#duration
+TDAnalytics.track("stay_shop", {})
+```
+
+## 三、用户属性
+AE 平台支持的用户属性设置API有：`userSet()`、`userSetOnce()`、`userAdd()`、`userAppend()`、`userUnset()`、`userDelete()`。
+### 3.1 userSet
+对于一般的用户属性，您可以调用 `userSet` 来进行设置。使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例
+```lua
+-- 此时username为TA
+TDAnalytics.userSet({
+    user_name = "TA"
+})
+-- 此时username为AE
+TDAnalytics.userSet({
+    user_name = "TE"
+})
+```
+
+### 3.2 userSetOnce
+如果您要上传的用户属性只要设置一次，则可以调用 `userSetOnce` 来进行设置，当该属性之前已经有值的时候，将会忽略这条信息，以设置首次付费时间来为例：
+```lua
+--first_payment_time为2018-01-01 01:23:45.678
+TDAnalytics.userSetOnce({
+    first_payment_time = "2018-01-01 01:23:45.678"
+})
+-- first_payment_time仍然为2018-01-01 01:23:45.678
+TDAnalytics.userSetOnce({
+    first_payment_time = "2018-12-31 01:23:45.678"
+})
+```
+
+### 3.3 userAdd
+当您要上传数值型的属性时，您可以调用 `userAdd` 来对该属性进行累加操作，如果该属性还未被设置，则会赋值 0 后再进行计算，可传入负值，等同于相减操作。此处以累计付费金额为例：
+```lua
+-- 此时total_revenue为30
+TDAnalytics.userAdd({
+    total_revenue = 30
+})
+-- 此时total_revenue为678
+TDAnalytics.userAdd({
+    total_revenue = 648
+})
+```
+
+<quote-container>
+设置的属性key为字符串，Value 只允许为数值。
+</quote-container>
+
+### 3.4 userAppend
+您可以调用 `userAppend()` 为 `Array` 类型的用户属性追加元素:
+```lua
+-- 追加列表型用户属性
+TDAnalytics.userAppend({
+    weapon = {"m41", "bulldog"}
+})
+```
+
+### 3.5 userUnset
+如果您需要重置用户的某个属性，可以调用 `userUnset()` 将该用户指定用户属性的值清空，此接口支持传入字符串类型的参数:
+```lua
+-- 清除指定用户属性
+TDAnalytics.userUnset("age")
+```
+
+<quote-container>
+传入值为被清空属性的 Key 值。
+</quote-container>
+
+### 3.6 userDelete
+如果您要删除某个用户，可以调用 `userDelete()` 将这名用户删除，您将无法再查询该名用户的用户属性，但该用户产生的事件仍然可以被查询到。
+```lua
+-- 删除用户
+TDAnalytics.userDelete()
+```
+
+## 四、其他功能
+### 4.1 获取设备ID
+SDK 在初始化完成后，会自动生成设备 ID，并记录在本地缓存，对于同一应用或游戏，一台设备的设备 ID 是不变的，可以调用 `getDeviceId()` 获取设备 ID：
+```lua
+-- 获取设备 ID
+TDAnalytics.getDeviceId()
+```

package/wiki/te-docs/raw//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/cocos2d-lua.md

@@ -0,0 +1,200 @@
+---
+code: cocos2d_lua_sdk_installation
+name: "Cocos2d-Lua"
+wikiToken: UDhNw7ShXiLkTukQ7GTcjKwGnge
+parentWikiToken: G5xvwevvSi8u93kR0RwcN52MnFc
+updateTime: 1776262569000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=zh-CN&code=cocos2d_lua_sdk_installation
+---
+
+::: tip 提示
+ 在接入前, 请先阅读[<text color="purple" underline="true">接入前准备</text>](https://thinkingdata.feishu.cn/wiki/OvpawZlw1idmxzkwiJWcxlfNnNc)。
+ Cocos2d-Lua SDK 支持在 iOS、Android 平台运行，大小约为 7.1M
+ :::
+**最新版本:** v2.0.2
+**更新时间:** 2024-01-19
+**资源下载**: [源码](https%3A%2F%2Fgithub.com%2FThinkingDataAnalytics%2Fcocos2d-lua-sdk%2Ftags)、[SDK下载](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2Frelease%2Fta_cocos2d_lua_sdk.zip)
+::: warning 注意
+当前文档适用于 v2.0.0 及以后的版本，历史版本请参考 [Cocos2d-Lua 接入指南（V1）](https%3A%2F%2Fdocs.thinkingdata.cn%2Fta-manual%2Fv4.1%2Finstallation%2Finstallation_menu%2Fclient_sdk%2Fgame_engine_sdk_installation%2Fcocos2d_lua_sdk_installation%2Fcocos2d_lua_sdk_installation.html)，[SDK下载（v1.0.1）](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FCocos2d-Lua%2Fta_cocos2d_lua_sdk_v1.0.1.zip)
+::: 
+## 一、集成SDK
+- **添加 Cocos2d-Lua 配置**
+  - 下载 [Cocos2d-Lua SDK](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2Frelease%2Fta_cocos2d_lua_sdk.zip) 资源文件，解压文件后把 `TDAnalytics``.lua` 添加到 `src` 文件夹
+- **添加 Android 配置**
+  - 在 `frameworks/runtime-src/proj.android/app` 目录下添加 `libs` 文件夹，把 `TDAnalytics.aar`、`TDCore.aar` 添加到 `libs` 文件夹
+  - 在 `frameworks/runtime-src/proj.android/app/src/org/cocos2dx/lua` 目录下添加 `TDAnalyticsProxy.java`
+  - 在 `CMakeLists.txt` 中加入如下配置
+```bash
+if(ANDROID)
+    list(APPEND GAME_SOURCE
+        # ... 添加以下代码
+        ${RUNTIME_SRC_ROOT}/proj.android/app/src/org/cocos2dx/lua/TDAnalyticsProxy.java
+        ${RUNTIME_SRC_ROOT}/proj.android/app/libs/TDCore.aar
+        ${RUNTIME_SRC_ROOT}/proj.android/app/libs/TDAnalytics.aar
+        )
+endif()
+```
+
+- 在 `frameworks/runtime-src/proj.android/app` 目录下的`build.gradle`中添加如下配置
+```groovy
+dependencies {
+    // 添加 .aar 引用
+    implementation fileTree(include: ['*.jar','*.aar'], dir: 'libs')
+}
+```
+
+- **添加 iOS 配置（****Cocos2d-Lua-Community 4.x****）**
+  - 把 `TDAnalyticsProxy.h`、`TDAnalyticsProxy.mm`、`ThinkingSDK.framework` 添加到 `frameworks/runtime-src/proj.ios_mac/ios` 目录
+  - 在 `CMakeLists.txt` 中加入如下配置
+```bash {wrap}
+if(APPLE)
+    if(IOS)
+        list(APPEND GAME_HEADER
+             # [TDAnalytics] 添加以下代码
+             ${RUNTIME_SRC_ROOT}/proj.ios_mac/ios/TDAnalyticsProxy.h
+             )
+        list(APPEND GAME_SOURCE
+             # [TDAnalytics] 添加以下代码
+             ${RUNTIME_SRC_ROOT}/proj.ios_mac/ios/TDAnalyticsProxy.mm
+             ${RUNTIME_SRC_ROOT}/proj.ios_mac/ios/ThinkingSDK.framework
+             )
+    endif()
+endif()
+
+if(IOS)
+    # [TDAnalytics] 添加以下代码
+    target_link_libraries(${APP_NAME} ${RUNTIME_SRC_ROOT}/proj.ios_mac/ios/ThinkingSDK.framework)
+endif()
+
+
+if(IOS)
+    # [TDAnalytics] 添加以下代码
+    set(CMAKE_EXE_LINKER_FLAGS -ObjC)
+endif()
+```
+
+- **添加 iOS 配置（Cocos2d-Lua-Community 3.x）**
+  - 使用 Xcode 打开 `iOS` 项目，直接拖拽 SDK 目录下的 `iOS` 文件夹放入 `Classes` 目录
+  - `Build Setting` -> `Other Linker Flags` 中的 `Debug` 和 `Release` 分别添加 `-force_load "$(SRCROOT)/``ios/``ThinkingSDK.framework/ThinkingSDK"`
+## 二、初始化
+```lua
+local TDAnalytics = require("TDAnalytics")
+TDAnalytics.init(APPID, SERVER_URL, TDAnalytics.debugModel.debugOff)
+```
+
+参数说明:
+- `APPID`: 是您的项目的 APPID，可通过在 AE 后台项目管理页面获取
+- `SERVER_URL`: 为数据上传的 URL
+  - 如果您对接的是云服务，填入: https://global-receiver-ta.thinkingdata.cn
+  - 如果您使用私有化部署版本，请为数据采集地址绑定域名，并配置 HTTPS 证书：https://数据采集地址绑定域名
+<quote-container>
+由于 Android 9.0+ 默认限制 HTTP 请求，因此请务必使用 HTTPS 协议
+</quote-container>
+
+## 三、常用功能
+在使用常用功能之前，建议你先了解[用户识别规则](https://thinkingdata.feishu.cn/wiki/AUyiw6XZsiF9EMk2fBScKjzunjd)；SDK默认会生成随机数作为访客ID，并持久化存储访客ID在本地；用户未登录之前，会以访客ID作为身份识别ID。注意:访客 ID 在用户重新安装 App 以及更换设备时将会变更。
+### 3.1 设置账号ID
+在用户进行登录时，可调用 `login` 来设置用户的账号 ID， AE 平台将会以账号 ID 作为身份识别 ID，并且设置的账号 ID 将会在调用 `logout` 之前一直保留。多次调用 `login` 将覆盖先前的账号 ID 。
+```lua
+--用户的登录唯一标识，此数据对应上报数据里的#account_id，此时#account_id的值为TA
+TDAnalytics.login("TA")
+```
+
+`login` 可以多次调用，每次调用会判断传入的账号 ID 与先前保存的 ID 是否一致，一致则忽略调用，不一致则会覆盖先前的 ID。
+<quote-container>
+**该方法不会上传登录事件**
+</quote-container>
+
+### 3.2 设置公共事件属性
+公共事件属性指的就是每个事件都会带有的属性，您可以调用 `setSuperProperties` 来设置公共事件属性，我们推荐您在发送事件前，先设置公共事件属性。对于一些重要的属性，譬如用户的会员等级、来源渠道等，这些属性需要设置在每个事件中，此时您可以将这些属性设置为公共事件属性。
+```lua
+local superProperties = {}
+superProperties["channel"] = "ta" -- 字符串
+superProperties["age"] = 1 -- 数字
+superProperties["isSuccess"] = true -- 布尔
+superProperties["birthday"] = os.date("%Y-%m-%d %H:%M:%S") -- 时间
+superProperties["object"] = { key="value" } -- 对象
+superProperties["object_arr"] = { { key="value" } } -- 对象组
+superProperties["arr"] = { "value" } -- 数组
+TDAnalytics.setSuperProperties(superProperties) -- 设置公共事件属性
+```
+
+公共事件属性将会被保存到缓存中，无需每次启动 App 时调用。如果调用 `setSuperProperties` 上传了先前已设置过的公共事件属性，则会覆盖之前的属性。
+- Key 为该属性的名称，为字符串类型，规定只能以字母开头，包含数字，字母和下划线 "_"，长度最大为 50 个字符，对字母大小写不敏感，AE 会统一转化为小写字母
+- Value 为该属性的值，支持字符串、数字、布尔、时间、对象、对象组、数组
+<quote-container>
+**事件属性、用户属性的要求与公共事件属性保持一致**
+</quote-container>
+
+### 3.3 开启自动采集
+以下代码示例开启安装、启动、关闭事件，如果您想详细了解SDK的自动采集能力，可以查看[自动采集功能详细介绍](https://thinkingdata.feishu.cn/wiki/DwalwrtebisQfXkjgdCcKS16nXE)
+```lua
+TDAnalytics.enableAutoTrack( {
+    appInstall = true, 
+    appStart = true, 
+    appEnd = true
+});
+```
+
+### 3.4 发送事件
+您可以调用 `track` 来上传事件，建议您根据先前梳理的埋点文档来设置事件的属性以及发送信息的条件，此处以用户购买某商品作为范例：
+```lua
+TDAnalytics.track("product_buy", {
+    product_name="商品名"
+});
+```
+
+事件的名称是字符串类型，只能以字母开头，可包含数字，字母和下划线 "_"，长度最大为 50 个字符。
+### 3.5 设置用户属性
+对于一般的用户属性，您可以调用 `userSet`来进行设置，使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例：
+```lua
+-- 此时username为TA
+TDAnalytics.userSet({
+    user_name = "TA"
+})
+-- 此时username为AE
+TDAnalytics.userSet({
+    user_name = "TE"
+})
+```
+
+## 四、最佳实践
+以下示例代码包含以上所有操作，我们推荐按照如下步骤使用:
+```lua
+-- 引入 TDAnalytics
+local TDAnalytics = require("TDAnalytics")
+
+if (授权隐私政策) {
+    -- 初始化SDK
+    TDAnalytics.init(APP_ID, SERVER_URL, TDAnalytics.debugModel.debugOff);
+    --开启自动采集事件
+    TDAnalytics.enableAutoTrack( {
+        appInstall = true, 
+        appStart = true, 
+        appEnd = true
+    });
+    --如果用户已登录，可以设置用户的账号ID作为身份唯一标识
+    TDAnalytics.login("TA")
+    
+    --设置公共事件属性以后，每个事件都会带有公共事件属性
+    local superProperties = {}
+    superProperties["channel"] = "ta" -- 字符串
+    superProperties["age"] = 1 -- 数字
+    superProperties["isSuccess"] = true -- 布尔
+    superProperties["birthday"] = os.date("%Y-%m-%d %H:%M:%S") -- 时间
+    superProperties["object"] = { key="value" } -- 对象
+    superProperties["object_arr"] = { { key="value" } } -- 对象组
+    superProperties["arr"] = { "value" } -- 数组
+    TDAnalytics.setSuperProperties(superProperties) -- 设置公共事件属性
+    
+    --发送事件
+    TDAnalytics.track("product_buy", {
+        product_name="商品名"
+    });
+    
+    --设置用户属性
+    TDAnalytics.userSet({
+        user_name = "TE"
+    })
+}
+```

package/wiki/te-docs/raw//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/egret//346/233/264/346/226/260/346/227/245/345/277/227.md

@@ -0,0 +1,83 @@
+---
+code: egret_sdk_release_note
+name: "更新日志"
+wikiToken: QwD9wtEMjibRAqk9099cxlvun6f
+parentWikiToken: TwNbwKODFiQ8UGkdWC5cyx7anZQ
+updateTime: 1774248011000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=zh-CN&code=egret_sdk_release_note
+---
+
+## v3.0.2
+**更新时间:  2024/02/09 **[**下载**](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FMPMG%2Fta_egret_sdk_v3.0.2.zip)
+**更新内容：**
+- 重构batch模式发送数据
+## v3.0.1
+**更新时间:  2023/11/24 **[**下载**](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FMPMG%2Fta_egret_sdk_v3.0.1.zip)
+**更新内容：**
+- 代码优化 
+## v3.0.0
+**更新时间:  2023/08/28 **[**下载**](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FMPMG%2Fta_egret_sdk_v3.0.0.zip)
+**更新内容：**
+- 代码优化 
+## v2.2.4
+**更新时间:  2023/07/28 **[**下载**](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FMPMG%2Fta_egret_sdk_v2.2.4.zip)
+**更新内容：**
+- 代码优化 
+## v2.2.0 
+**更新时间:  2022/08/15**
+**更新内容：**
+- 新增支持事件缓存 
+- 代码优化 
+## v2.1.0 
+**更新时间:  2022/06/28**
+**更新内容：**
+- 新增支持去重追加用户属性
+- Web平台支持ta_page_show/ta_page_hide事件
+- 新增支持数据加密上报
+- 代码优化
+## v2.0.3
+**更新时间:  2022/02/21**
+**更新内容：**
+- 自动采集事件支持自定义属性
+- 代码优化
+## v2.0.2
+**更新时间:  2021/12/31**
+**更新内容：**
+- 支持趣头条、Facebook、GooglePlay等小游戏
+- 代码优化
+## v2.0.1 
+**更新时间:  2021/11/15**
+**更新内容：**
+- 代码优化
+- 支持复杂数据类型
+## v2.0.0
+**更新时间:  2021/09/15**
+**更新内容：**
+- 支持 iOS/Android Native
+- 支持暂停/开始、停止/恢复数据上报
+- 支持事件黑名单
+- 代码优化
+## v1.8.2
+**更新时间:  2021/06/24**
+**更新内容：**
+- 支持预置属性获取
+- fix bug:原生/web平台运行时，断网重连导致的数据发送失败问题
+## v1.8.0
+**更新时间:  2020/11/20**
+**更新内容：**
+- 新增哔哩哔哩小游戏支持
+- 完善游戏引擎支持：支持 ts 项目接入
+- 完善游戏引擎支持：支持常见小游戏、快游戏平台(华为、小米、OPPO、VIVO)、H5 游戏
+- 其他代码细节层面的优化
+## v1.7.0
+**更新时间:  2020/08/24**
+**更新内容：**支持首次事件，可更新事件，可重写事件
+## v1.6.0
+**更新时间:  2020/06/10**
+**更新内容:**支持 debug 模式
+## v1.5.1
+**更新时间:  2020/03/21**
+**更新内容:**
+- 支持白鹭引擎小游戏平台：微信小游戏、百度小游戏、QQ 小游戏、VIVO 小游戏、OPPO 小游戏
+- 支持 LAYABOX 引擎小游戏平台：微信小游戏、百度小游戏、QQ 小游戏、VIVO 小游戏、OPPO 小游戏
+- 支持 CocosCreator 引擎小游戏平台：微信小游戏、百度小游戏、VIVO 小游戏、OPPO 小游戏

package/wiki/te-docs/raw//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/egret//350/277/233/351/230/266/346/214/207/345/215/227/native/346/224/257/346/214/201.md

@@ -0,0 +1,66 @@
+---
+code: egret_sdk_native
+name: "Native支持"
+wikiToken: JPB1w4spWidFSokTeNec4JRGnef
+parentWikiToken: IFBjwUhHviTPggkLtGZchaSonGd
+updateTime: 1774248009000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=zh-CN&code=egret_sdk_native
+---
+## 一、iOS Native支持
+**构建 iOS 平台应用，配置 iOS 工程**
+- 添加 iOS 工程依赖文件 
+  - `EgretProxyApi.h`
+  - `EgretProxyApi.mm`
+  - `ThinkingSDK.framework`
+- Build Settings 设置 
+  - `Other Linker Flags` 添加 `-ObjC`
+- 注册 Native 代理 
+  - 在 `AppDelegate.mm` 的 `application:didFinishLaunchingWithOptions:` 方法中注册 Native 代理，调用代码 `[EgretProxyApi registExternalInterface:_native]`
+## 二、Android Native支持
+**构建 Android 平台应用，配置 Android 工程**
+- 添加 Adnroid 工程依赖文件 
+  - `EgretProxyApi.java`
+- 在 `Project` 级别的 `build.gradle` 文件中添加如下配置依赖
+```plaintext
+buildscript {
+    repositories {
+        jcenter()
+        mavenCentral()
+    }
+}
+```
+
+- 在 `Module` 下的 `build.gradle`文件中添加依赖项
+```plaintext
+dependencies {
+    implementation 'cn.thinkingdata.android:ThinkingAnalyticsSDK:2.7.6.1'
+}
+```
+
+- 注册 Native 代理 
+  - 在 `MainActivity` 的 `onCreate` 方法中注册 Native 代理，调用代码 `EgretProxyApi.registExternalInterface(nativeAndroid,this)`
+## 三、开启 Native 支持
+初始化 SDK 时，在 `config` 中加入 `enableNative: true`，即可开启 Native 支持。
+```javascript
+// TA SDK 配置对象
+var config = {
+  appId: "YOUR_APPID", // 项目 APP ID
+  serverUrl: "YOUR_SERVER_URL", // 上报地址
+  enableNative: true, // 允许调用 Native 代码
+  autoTrack: {
+    appShow: true, // 自动采集 启动事件
+    appHide: true, // 自动采集 关闭事件
+    appClick: true, // 自动采集 点击事件（仅 native 生效）
+    appView: true, // 自动采集 页面浏览事件（仅 native 生效）
+    appCrash: true, // 自动采集 崩溃事件（仅 native 生效）
+    appInstall: true // 自动采集 安装事件（仅 native 生效）
+  }
+};
+
+// 初始化
+TDAnalytics.init(config);
+// 上报一个简单事件, 事件名为 test_event
+TDAnalytics.track({
+    eventName: 'test_event'
+});
+```

package/wiki/te-docs/raw//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/egret//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: egret_sdk_debug
+name: "实时调试"
+wikiToken: MJC3w59ltiFaVYkEN64ctW8WnUb
+parentWikiToken: IFBjwUhHviTPggkLtGZchaSonGd
+updateTime: 1776262614000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=zh-CN&code=egret_sdk_debug
+---
+
+在SDK接入过程中，您可以通过查看SDK在IDE控制台中的日志或者使用TA的Debug功能，进行实时调试。
+### 一、打印SDK日志
+```javascript
+var config = {
+  appid: "YOUR_APPID",
+  server_url: "YOUR_SERVER_URL",
+  enableLog:true//打开日志开关，默认是false
+};
+TDAnalytics.init(config);
+```
+
+<quote-container>
+打开日志后，可以在IDE中过滤 ThinkingAnalytics 相关的日志来观察 SDK 的数据上报。
+</quote-container>
+
+### 二、开启 Debug 模式
+开启Debug模式需要如下两步操作:
+1. 客户端开启Debug模式
+以下是客户端开启Debug模式的示例代码:
+```java
+/*
+设置运行模式为 Debug 模式
+none:数据会存入缓存，并依据一定的缓存策略上报,默认为NORMAL模式；建议在线上环境使用
+debug:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
+debugOnly:只对数据做校验，不会入库；不建议在线上环境使用
+ */
+var config = {
+  appid: "YOUR_APPID",
+  server_url: "YOUR_SERVER_URL",
+  debugMode: "debug"
+};
+TDAnalytics.init(config);
+```
+
+2. AE 后台添加Debug设备
+为了避免 Debug 模式在生产环境上线，规定只有指定的设备才能开启 Debug 模式。只有在客户端开启了 Debug 模式，并且设备 ID 在 AE 后台的"埋点管理"页的"Debug 数据"板块中配置了的设备才能开启 Debug 模式。
+<image token="VBKCbl8UsoBiAzxsWDtcTsngnDg" width="2309" height="857" align="center"/>
+
+设备 ID 可以通过以下三种方式获取：
+- AE 平台中事件数据中的 #device_id 属性
+- 客户端日志：SDK 初始化完成后会打印设备 DeviceId
+- 通过实例接口调用：[<text color="purple" underline="true">获取设备ID</text>](https://thinkingdata.feishu.cn/wiki/IFBjwUhHviTPggkLtGZchaSonGd)
+<quote-container>
+Debug 模式可能会影响数据采集质量和 App 的稳定性，只用于集成阶段数据验证，不要在线上环境使用。
+</quote-container>