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/openharmony//350/277/233/351/230/266/346/214/207/345/215/227.md

@@ -0,0 +1,408 @@
+---
+code: openharmony_sdk_advanced
+name: "进阶指南"
+wikiToken: Ci0xwEVoxiX0GSkkVPLc7bZRnQf
+parentWikiToken: CdewwjvM9irVHckq2lvctVPNnhf
+updateTime: 1763466408000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=openharmony_sdk_advanced
+---
+# 进阶指南
+
+### 一、设置用户标识
+
+SDK 实例默认会使用随机 UUID 作为每个用户的默认访客 ID，该 ID 将会作为用户在未登录状态下身份识别 ID。需要注意的是，访客 ID 在用户重新安装 App 以及更换设备时将会变更。
+
+#### 1.1 设置访客 ID
+
+::: tip 提示
+
+ 一般情况下，您不需要自定义访客 ID. 请确保已经理解用户识别规则，再进行访客 ID 的设置。
+
+如果您需要替换访客 ID，则应当在初始化 SDK 结束之后立即进行调用，请勿多次调用，以免产生无用的账号
+
+ :::
+
+如果您的 App 对每个用户有自己的访客 ID 管理体系，则您可以调用*`setDistinctId`* 来设置访客 ID：
+
+```
+// 将访客ID设置为Thinker
+TDAnalytics.setDistinctId("Thinker");
+```
+
+如果需要获得当前访客 ID，可以调用 `getDistinctId` 获取：
+
+```
+//返回访客ID
+let distinctId = TDAnalytics.getDistinctId();
+```
+
+#### 1.2 设置账号ID
+
+在用户进行登录时，可调用 `login` 来设置用户的账号 ID， AE 平台将会以账号 ID 作为身份识别 ID，并且设置的账号 ID 将会在调用 `logout` 之前一直保留。多次调用 `login` 将覆盖先前的账号 ID 。
+
+```
+//用户的登录唯一标识，此数据对应上报数据里的#account_id，此时#account_id的值为TA
+TDAnalytics.login("TA");
+```
+
+<!-- unsupported block: 34 -->
+
+**该方法不会上传登录事件**
+
+#### 1.3 清除账号 ID
+
+在用户产生登出行为之后，可调用 `logout` 来清除账号 ID，在下次调用 `login` 之前，将会以访客 ID 作为身份识别 ID。
+
+```
+// 去除上报数据里的 "#account_id"，之后的数据将不带有 "#account_id"
+TDAnalytics.logout();
+```
+
+我们推荐您在显性的登出事件时调用 `logout`，比如用户产生了注销账号这一行为时才调用，而不需要在关闭 App 时调用。
+
+<!-- unsupported block: 34 -->
+
+**该方法不会上传登出事件**
+
+### 二、发送事件
+
+在 SDK 初始化完成之后，您就可以进行数据埋点，收集用户的的行为信息。一般情况下普通事件即可满足业务需求，您也可以根据自己的实际业务场景使用首次、可更新等事件。
+
+#### 2.1 普通事件
+
+ 您可以调用 `track` 来上传事件，建议您根据先前梳理的文档来设置事件的属性，此处以用户购买某商品作为范例：
+
+```
+TDAnalytics.track({
+    eventName: "product_buy", // 事件名称
+    properties: {
+        product_name: "商品名"
+    } //事件属性
+});
+```
+
+#### 2.2 首次事件
+
+首次事件是指针对某个设备或者其他维度的 ID，只会记录一次的事件。例如在一些场景下，您可能希望记录在某个设备上的激活事件，则可以用首次事件来上报数据。
+
+```
+TDAnalytics.trackFirst({
+    eventName: "device_activation",
+    properties: { key: "value" }
+});
+```
+
+如果您希望以设备以外的其他维度来判断是否首次，则可以为首次事件自定义first_check_id:
+
+```
+// 将用户ID设置为首次事件的first_check_id，实现用户首次激活事件的采集
+TDAnalytics.trackFirst({
+  eventName: "account_activation",
+  firstCheckId: "TA",
+  properties: { key: "value" }
+});
+```
+
+<!-- unsupported block: 34 -->
+
+注意：由于在服务端完成对是否首次的校验，首次事件默认会延时 1 小时入库。
+
+#### 2.3 可更新事件
+
+您可以通过可更新事件实现特定场景下需要修改事件数据的需求。可更新事件需要指定标识该事件的 ID，并在创建可更新事件对象时传入。AE 将根据事件名和事件 ID 来确定需要更新的数据。
+
+```
+// 示例： 上报可被更新的事件，假设事件名为 UPDATABLE_EVENT
+// 上报后事件属性 status 为 3, price 为 100
+TDAnalytics.trackUpdate({
+  eventName: "UPDATABLE_EVENT",
+  properties: { status: 3, price: 100 },
+  eventId: "test_event_id"
+});
+
+// 上报后事件属性 status 被更新为 5, price 不变
+TDAnalytics.trackUpdate({
+  eventName: "UPDATABLE_EVENT",
+  properties: { status: 5 },
+  eventId: "test_event_id"
+});
+```
+
+#### 2.4 可重写事件
+
+可重写事件与可更新事件类似，区别在于可重写事件会用最新的数据完全覆盖历史数据，从效果上看相当于删除前一条数据，并入库最新的数据。AE 将根据事件名和事件 ID 来确定需要更新的数据。
+
+```
+// 示例： 上报可被重写的事件，假设事件名为 OVERWRITE_EVENT
+// 上报后事件属性 status 为 3, price 为 100
+TDAnalytics.trackOverwrite({
+  eventName: "OVERWRITE_EVENT",
+  properties: { status: 3, price: 100 },
+  eventId: "test_event_id"
+});
+
+// 上报后事件属性 status 被更新为 5, price 属性被删除
+TDAnalytics.trackOverwrite({
+  eventName: "OVERWRITE_EVENT",
+  properties: { status: 5 },
+  eventId: "test_event_id"
+});
+```
+
+#### 2.5 公共事件属性
+
+对于一些重要的属性，譬如用户的设备 ID、来源渠道、用户状态等，这些属性需要设置在每个事件中，此时您可以将这些属性设置为公共属性，即每个事件中都带有的属性。我们推荐您在发送事件前，先设置公共属性。
+
+##### 2.5.1 静态公共事件属性
+
+对于一些重要的属性，譬如用户的渠道、昵称、ID 等，这些属性需要设置在每个事件中，您可以调用`setSuperProperties` 来设置静态公共事件属性，静态公共事件属性会对全局生效。
+
+```
+// 设置公共事件属性，所有数据事件中都会带有这些属性
+TDAnalytics.setSuperProperties({
+     channel: "渠道名",
+     user_name: "用户名"
+});
+```
+
+ 除了属性设置，我们也提供其他API来操作静态公共事件属性，满足日常的业务需求。
+
+```
+// 获取静态公共事件属性
+let superProperties = TDAnalytics.getSuperProperties();
+// 清除一条静态公共事件属性，比如将之前设置 'channel' 属性清除，之后的数据将不会该属性
+TDAnalytics.unsetSuperProperty("channel");
+// 清除所有静态公共事件属性
+TDAnalytics.clearSuperProperties();
+```
+
+##### 2.5.2 动态公共事件属性
+
+通过 `setDynamicSuperProperties` 设置动态公共属性的回调函数，SDK 将会在事件上报时触发回调函数，并把返回 JSON 对象加入到事件属性中。`setDynamicSuperProperties` 的参数是一个函数，函数需要返回一个 JSON 对象。
+
+```
+// 设置动态公共属性，在事件上报时触发回调函数，并把返回的JSON对象加入到事件属性中
+TDAnalytics.setDynamicSuperProperties(() => {
+  return {
+    dy_name: 'xxx',
+    dy_age: 18
+  }
+})
+```
+
+#### 2.6 记录事件时长
+
+如果您需要记录某个事件的持续时长，可以调用 `timeEvent` 来开始计时。配置您想要计时的事件名称，当您上传该事件时，将会自动在您的事件属性中加入 `#duration` 这一属性来表示记录的时长，单位为秒。需要注意的是，同一个事件名只能有一个在计时的任务。
+
+```
+//以下示例，完成用户在某个商品页面停留时长的统计
+TDAnalytics.timeEvent("stay_shop");
+/**do someting
+    .......
+**/
+//用户离开商品页面，计时结束，"stay_shop" 这一事件中将会带有表示事件时长的属性#duration
+TDAnalytics.track({
+    eventName: "stay_shop",
+    properties: {
+        product_name: "商品名"
+    }
+});
+```
+
+### 三、用户属性
+
+TA 平台支持的用户属性设置API有: `userSet`、`userSetOnce`、`userAdd`、`userUnset`、`userDelete`、`userAppend`、`userUniqAppend`。
+
+#### 3.1 userSet
+
+对于一般的用户属性，您可以调用 `userSet` 来进行设置。使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例：
+
+```
+// username为TA
+TDAnalytics.userSet({
+    properties: {
+        username: "TA" 
+    }
+});
+//username为TE
+TDAnalytics.userSet({
+    properties: {
+        username: "TE" 
+    }
+});
+```
+
+#### 3.2 userSetOnce
+
+如果您要上传的用户属性只要设置一次，则可以调用 `userSetOnce` 来进行设置，当该属性之前已经有值的时候，将会忽略这条信息，以设置首次付费时间来为例：
+
+```
+//first_payment_time为2018-01-01 01:23:45.678
+TDAnalytics.userSetOnce({
+    properties: {
+        first_payment_time: "2018-01-01 01:23:45.678" 
+    }
+});
+//first_payment_time仍然为2018-01-01 01:23:45.678
+TDAnalytics.userSetOnce({
+    properties: {
+        first_payment_time: "2018-12-31 01:23:45.678" 
+    }
+});
+```
+
+#### 3.3 userAdd
+
+当您要上传数值型的属性时，您可以调用 `userAdd` 来对该属性进行累加操作，如果该属性还未被设置，则会赋值 0 后再进行计算。如果传入负值，等同于减法操作。
+
+```
+//此时total_revenue为30
+TDAnalytics.userAdd({
+    properties: {
+        total_revenue: 30
+    }
+});
+//此时total_revenue为678
+TDAnalytics.userAdd({
+    properties: {
+        total_revenue: 648
+    }
+});
+```
+
+#### 3.4 userUnset
+
+当您要清空用户的用户属性值时，您可以调用 `userUnset` 来对指定属性进行清空操作，如果该属性还未在集群中被创建，则 `userUnset` **不会**创建该属性
+
+```
+// 清空该用户属性名为 userPropertykey 的用户属性值，即设置成 NULL
+TDAnalytics.userUnset({
+    property: "userPropertykey"
+});
+```
+
+#### 3.5 userDelete
+
+如果您要删除某个用户，可以调用 `userDelete` 将这名用户删除，您将无法再查询该名用户的用户属性，但该用户产生的事件仍然可以被查询到。
+
+```
+TDAnalytics.userDelete();
+```
+
+#### 3.6 userAppend
+
+您可以调用 `userAppend` 对数组类型的用户数据追加元素。
+
+```
+TDAnalytics.userAppend({
+    properties: {
+        user_list: ["apple", "ball"]
+    }
+});
+```
+
+#### 3.7 userUniqAppend
+
+您可以调用 `userUniqAppend` 对 Array (List) 类型的用户数据追加唯一元素。调用 `userUniqAppend` 接口会对追加的用户属性进行去重， `userAppend` 接口不做去重，用户属性可存在重复。
+
+```
+//此时user_list的属性值为["apple"，"ball"]
+TDAnalytics.userAppend({
+    properties: {
+        user_list: ["apple", "ball"]
+    }
+});
+//此时user_list的属性值为["apple","apple","ball","cube"]
+TDAnalytics.userAppend({
+    properties: {
+        user_list: ["apple", "cube"]
+    }
+});
+//此时user_list的属性值为["apple"，"ball","cube"]
+TDAnalytics.userUniqAppend({
+    properties: {
+        user_list: ["apple", "cube"]
+    }
+});
+```
+
+### 四、加密功能
+
+SDK 支持使用AES+RSA加密数据。数据加密功能需要客户端和服务端配合完成，具体使用方法请咨询客户成功人员。
+
+```
+**let **config = **new **TDConfig()
+config.appId = 'app_id'
+config.serverUrl = 'server_url'
+//开启加密功能 设置公钥信息
+config.enableEncrypt(1,'publicKey')
+TDAnalytics.initWithConfig(context, config)
+```
+
+### 五、开启与 H5 页面的打通
+
+如果需要与采集 H5 页面数据的 JavaScript SDK 进行打通，在初始化 `WebView` 时调用如下接口
+
+```
+controller: webview.WebviewController = **new **webview.WebviewController();
+TDAnalytics.setJsBridge(controller)
+```
+
+### 六、其他功能
+
+#### 5.1 获取设备ID
+
+您可以调用 `getDeviceId()` 获取设备 ID。
+
+```
+let deviceId = TDAnalytics.getDeviceId();
+```
+
+<!-- unsupported block: 34 -->
+
+**设备 ID 会保存在缓存中，用户清理缓存，设备ID会被重置。**
+
+#### 5.2 校准时间
+
+SDK 默认会使用本机时间作为事件发生时间，如果用户手动修改设备时间会影响到您的业务分析，此时可以通过校准时间操作保证事件发生时间的准确性。我们提供`时间戳、自动`两种时间校准方式。
+
+- 您可以使用从服务端获取的当前时间戳对 SDK 的时间进行校准。此后，所有未指定时间的调用，包括事件数据和用户属性设置操作，都会使用校准后的时间作为发生时间。
+```
+// 1585633785954 为当前 unix 时间戳，单位为毫秒，对应北京时间 2020-03-31 13:49:45
+TDAnalytics.calibrateTime(1585633785954)
+```
+
+- 您也可以设置自动时间校准，之后 SDK 会尝试从 config接口中获取当前时间，并对 SDK 时间进行校准。如果未获取正确的返回结果，后续将使用本地时间上报数据。
+```
+let config = new TDConfig()
+config.appId = 'appId'
+config.serverUrl = 'serverUrl'
+//设置为true开启自动时间校准
+config.enableAutoCalibrated = true
+TDAnalytics.initWithConfig(context, config)
+```
+
+#### 5.3 设置默认时区
+
+默认情况下,SDK 会使用本机时间作为事件发生时间。您也可以通过设置默认时区接口，指定时区，这样所有的事件都将按照您设置的时区来对齐事件时间：
+
+```
+**import **I18n **from **'@ohos.i18n';
+**let **config = **new **TDConfig()
+config.appId = 'appId'
+config.serverUrl = 'serverUrl'
+config.defaultTimeZone = I18n.getTimeZone('Australia/Sydney')
+TDAnalytics.initWithConfig(this.context, config)
+```
+
+<!-- unsupported block: 34 -->
+
+用指定时区对齐事件时间，会丢掉设备本机时区信息。如果需要保留设备本机时区信息，目前需要您自己为事件添加相关属性。
+
+#### 5.4 立即上报数据
+
+在某些业务场景下，如果您期望数据立即上报到 AE 服务器，可以通过调用`flush`接口完成
+
+```
+TDAnalytics.flush();
+```

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

@@ -0,0 +1,209 @@
+---
+code: openharmony_sdk_installation
+name: "OpenHarmony"
+wikiToken: CdewwjvM9irVHckq2lvctVPNnhf
+parentWikiToken: FTcTwinIOi3OiRkK4MPc2Ex7neg
+updateTime: 1768296999000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=openharmony_sdk_installation
+---
+# OpenHarmony
+
+::: tip 提示
+
+ 在接入前, 请先阅读接入前准备。
+
+SDK 要求最低系统版本为 API 10
+
+SDK ( har 格式) 大小约为 56 KB
+
+SDK名称：数数科技SDK
+
+开发者：数数信息科技(上海)有限公司
+
+版本号：1.7.6
+
+功能：SDK采用事件、用户属性的方式收集客户端日志，具有统计日活、使用时长、留存行为分析等方面的能力。
+
+隐私声明：数数科技SDK隐私声明
+
+合规指南：数数科技SDK合规指南
+
+ :::
+
+**最新版本:** 1.7.6
+
+**资源下载: **SDK下载  
+
+**SDK包名：**@thinkingdata/analytics
+
+**MD5值：**1b29126f457d46724e4287fecb0e4cdc
+
+**更新时间:** 2026-01-05
+
+### 一、集成 SDK
+
+1. 引入SDK
+- 执行以下命令
+```
+ohpm i @thinkingdata/analytics
+```
+
+- 手动在oh-packages.json5中dependencies下添加依赖，然后IDE会提示ohpm install，点击安装
+```
+"dependencies": {
+  "@thinkingdata/analytics": "1.7.6",
+}
+```
+
+### 二、 初始化
+
+```
+import { TDAnalytics, TDConfig, TDMode } from '@thinkingdata/analytics';
+
+//方式一
+TDAnalytics.init(context, "appId", "serverUrl")
+
+//方式二
+let config = new TDConfig()
+config.appId = 'appId'
+config.serverUrl = 'serverUrl'
+config.mode = TDMode.NORMAL
+config.enableAutoCalibrated = true
+TDAnalytics.initWithConfig(context, config)
+```
+
+SDK初始化的时候会收集操作系统版本、设备制造商、操作系统、屏幕分辨率、设备型号、APP 版本、网络状态、网络运营商、应用安装时间、系统语言等信息，用于统计分析功能。
+
+参数说明:
+
+- `APPID`: 您的项目的 APPID，可通过在 AE 项目管理页面获取
+- `SERVER_URL`: 数据上传的 URL
+- 如果您对接的是云服务，请在项目管理->接入配置中查看上报地址。
+- 如果您使用私有化部署版本,您可以自定义数据采集地址。
+- `mode`: SDK上报模式，默认为Normal模式。
+- `enableAutoCalibrated` : 自动开启时间校准。
+### 三、 常用功能
+
+在使用常用功能之前，建议你先了解用户识别规则；SDK默认会生成随机数作为访客ID，并持久化存储访客ID在本地；用户未登录之前，会以访客ID作为身份识别ID。注意:访客 ID 在用户重新安装 App 以及更换设备时将会变更。
+
+#### 3.1 设置账号ID
+
+在用户进行登录时，可调用 `login` 来设置用户的账号 ID， AE 平台将会以账号 ID 作为身份识别 ID，并且设置的账号 ID 将会在调用 `logout` 之前一直保留。多次调用 `login` 将覆盖先前的账号 ID 。
+
+```
+// 用户的登录唯一标识，此数据对应上报数据里的#account_id，此时#account_id的值为TA
+TDAnalytics.login("TA");
+```
+
+<!-- unsupported block: 34 -->
+
+**该方法不会上传登录事件**
+
+#### 3.2 设置公共事件属性
+
+公共事件属性指的就是每个事件都会带有的属性，您可以调用 `setSuperProperties` 来设置公共事件属性，我们推荐您在发送事件前，先设置公共事件属性。对于一些重要的属性，譬如用户的会员等级、来源渠道等，这些属性需要设置在每个事件中，此时您可以将这些属性设置为公共事件属性。
+
+```
+let superProperties = {};
+superProperties["channel"] = "ta";//字符串
+superProperties["age"] = 1;//数字
+superProperties["isSuccess"] = true;//布尔
+superProperties["birthday"] = new Date();//时间
+superProperties["object"] = {key:"value"};//对象
+superProperties["object_arr"] = [{key:"value"}];//对象组
+superProperties["arr"] = ["value"];//数组
+TDAnalytics.setSuperProperties(superProperties)
+```
+
+公共事件属性将会被保存到缓存中，无需每次启动 App 时调用。如果调用 `setSuperProperties` 上传了先前已设置过的公共事件属性，则会覆盖之前的属性。
+
+#### 3.3 开启自动采集
+
+建议enableAutoTrack在onWindowStageCreate之后开启，以下代码示例开启所有自动采集事件：
+
+```
+//APP安装事件 TDAutoTrackEventType.APP_INSTALL
+//APP启动事件 TDAutoTrackEventType.APP_START
+//APP关闭事件 TDAutoTrackEventType.APP_END
+//APP浏览页面事件 TDAutoTrackEventType.APP_VIEW_SCREEN
+//APP点击控件事件 TDAnalytics.TDAutoTrackEventType.*APP_CLICK*
+//APP崩溃事件 TDAutoTrackEventType.APP_CRASH
+TDAnalytics.enableAutoTrack(context,TDAutoTrackEventType.APP_START | TDAutoTrackEventType.APP_INSTALL | TDAutoTrackEventType.APP_END | TDAutoTrackEventType.APP_VIEW_SCREEN | TDAutoTrackEventType.APP_CLICK | TDAutoTrackEventType.APP_CRASH)
+```
+
+#### 3.4 发送事件
+
+您可以调用 `track` 来上传事件，建议您根据先前梳理的埋点文档来设置事件的属性，此处以用户购买某商品作为范例：
+
+```
+TDAnalytics.track({
+  eventName: 'product_buy'，
+  properties：{
+      product_name:"商品名"
+  }
+})
+```
+
+事件的名称是字符串类型，只能以字母开头，可包含数字，字母和下划线 "_"。
+
+#### 3.5 设置用户属性
+
+对于一般的用户属性，您可以调用 `userSet` 来进行设置，使用该接口上传的属性将会覆盖原有的属性值；如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例：
+
+```
+// username为TA
+TDAnalytics.userSet({
+  properties: {
+    username: "TA"
+  }
+})
+//username为TE
+TDAnalytics.userSet({
+  properties: {
+    username: "TE"
+  }
+})
+```
+
+### 四、最佳实践
+
+以下示例代码包含以上所有操作，我们推荐按照如下步骤使用:
+
+```
+import { TDAnalytics, TDConfig, TDMode } from '@thinkingdata/analytics';
+let config = new TDConfig()
+config.appId = 'appId'
+config.serverUrl = 'serverUrl'
+config.enableAutoCalibrated = true
+config.mode = TDMode.NORMAL
+// 初始化
+TDAnalytics.initWithConfig(this.context, config)
+//开启自动采集
+TDAnalytics.enableAutoTrack(context,TDAutoTrackEventType.APP_START | TDAutoTrackEventType.APP_INSTALL | TDAutoTrackEventType.APP_END | TDAutoTrackEventType.APP_VIEW_SCREEN | TDAutoTrackEventType.APP_CLICK | TDAutoTrackEventType.APP_CRASH)
+// 用户的登录唯一标识，此数据对应上报数据里的#account_id，此时#account_id的值为TA
+TDAnalytics.login("TA");
+//设置公共事件属性
+let superProperties = {
+    channel : "ta", //字符串
+    age : 1,//数字
+    isSuccess : true,//布尔
+    birthday :  new Date(),//对象
+    object : { key : "value" },//对象
+    object_arr : [ { key : "value" } ],//对象组
+    arr : [ "value" ]//数组
+};
+TDAnalytics.setSuperProperties(superProperties);
+//发送事件
+TDAnalytics.track({
+    eventName: "product_buy", // 事件名称
+    properties: {
+        product_name: "商品名"
+    } //事件属性
+});
+//设置用户属性
+TDAnalytics.userSet({
+    properties: { 
+        username: "TE" 
+    }
+});
+```

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//345/256/242/346/210/267/347/253/257-sdk-/345/270/270/350/247/201/351/227/256/351/242/230.md

@@ -0,0 +1,72 @@
+---
+code: client_sdk_faq
+name: "客户端 SDK 常见问题"
+wikiToken: D6YFwXxCPitOj1k7rLRcx3aYnzg
+parentWikiToken: FTcTwinIOi3OiRkK4MPc2Ex7neg
+updateTime: 1761535340000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=client_sdk_faq
+---
+# 客户端 SDK 常见问题
+
+### 客户端 SDK 上报策略是什么？
+
+原生客户端 SDK (包括 Unity、Unreal、Flutter 等) 数据会首先缓存在本地数据库，并在以下情况触发数据上报：
+
+- App进入后台
+- 30S上报一次（可以在 AE 后台设置）
+- 缓存数据超过 30 条触发上报（可以在 AE 后台设置）
+- 主动调用 flush 接口
+小程序、小游戏 SDK，以及 JavaScript SDK 会实时上报，没有本地缓存。
+
+### 设备 ID 的取值逻辑是什么？
+
+原生客户端 SDK (包括 Unity、Unreal、Flutter 等) 的设备 ID 取值逻辑如下：
+
+- Android: 取 Android ID
+对于 Android 8.0 以下的系统，Android ID 是设备唯一标识。重新刷机或者恢复出厂设置才会变更。所有应用共享。Android 8.0 及之后的系统，应用签署密钥、用户和设备的每个组合都具有唯一的 ANDROID_ID 值。因此，在相同设备上运行但具有不同签署密钥的应用将不会再看到相同的 Android ID（即使对于同一用户来说，也是如此）。一个特殊情况：如果用户安装 APP 设备是 8.0 以下，后来卸载了，升级到 8.0 之后又重装了应用，Android ID 会跟之前不一样；如果没有重装，那么 Android ID 不会变更。
+
+- iOS：先取 IDFV，如果取不到就用随机 UUID。首次取的 设备 ID 值将存入钥匙串中，不再改变，即使 后续 IDFV 发生变化。
+小程序、小游戏和 JavaScript 接口无法取得类似的设备号，使用一个随机生成的 ID 作为设备 ID。如果用户删除了缓存，该设备 ID 将会发生变化。
+
+### 客户端 SDK 支持的最低系统版本是多少？
+
+客户端 SDK 支持的最低版本是 Android 4.0 和 iOS 8.0
+
+### 如何排查上报问题？
+
+一般问题可以通过客户端日志很快定位，我们在各个接入指南中都介绍了如何开启客户端日志。
+
+在 Android 中，您可以通过调用 `enableTrackLog` 接口来开启客户端日志。您可以通过 `Thinking``Data` 来过滤 Android SDK 的日志。
+
+```
+TDAnalytics.enableTrackLog(true);
+```
+
+在 iOS 中，您可以通过调用 `setLogLevel` 接口来开启日志打印，并通过 `THINKING` 来过滤 iOS SDK 的日志。
+
+```
+[TDAnalytics setLogLevel:TDLoggingLevelDebug]
+```
+
+在打开日志后，您可以将日志发给我们的技术支持工程师，协助定位问题 。
+
+如果您不确定上报地址是否正确，可以通过检查检查接口来检测上报地址的可达性。 访问 https://YOUR_RECEIVER_URL/health-check，页面返回 ok 表示接收端地址配置正确。
+
+除此之外，通过埋点方案模块的功能，也可以方便的定位到数据上报过程中的问题。
+
+### 通过 Unity SDK 上报数据有哪些注意事项？
+
+1. 我们的 SDK 的初始化是在 Awake() 中完成的，因此调用不可以在 Awake 中触发
+1. 默认情况下所有接口只能在主线程中调用。
+1. 我们是通过 Android 系统的组件生命周期来判断 APP 是否进入前台或者退到后台的。但是 Unity 中无法保证在程序最开始就初始化 SDK，所以可能会在退到后台的时候才能判断初次启动事件。目前我们会在第一次退到后台的时候补一个 ta_app_start（上报略晚，但是事件时间 #event_time 是正确的，不影响后续分析）
+### 崩溃事件包括哪些内容？如何采集崩溃事件
+
+客户端 SDK 支持部分崩溃日志的采集。需要在初始化 SDK 之后，开启 APP Crash 的自动采集。崩溃事件对应的事件名为：ta_app_crash。
+
+触发崩溃事件采集的情况：
+
+- Android 平台：虚拟机中出现未捕获异常
+- iOS 平台： 
+- Unix 信号异常 包括：SIGABRT, SIGILL, SIGSEGV, SIGFPE, SIGBUS
+- NSException 异常
+- Unity引擎中C#异常的采集