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

@@ -0,0 +1,1126 @@
+---
+code: android_sdk_advanced
+name: "进阶指南"
+wikiToken: J7zFwvYawiv1E6k6TsYc5YzXnLc
+parentWikiToken: EnSPwbQvsi8Vm4km9JqcbhQ6nv2
+updateTime: 1773027712000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=android_sdk_advanced
+---
+# 进阶指南
+
+### 一、设置用户标识
+
+SDK 实例默认会使用随机 UUID 作为每个用户的默认访客 ID，该 ID 将会作为用户在未登录状态下身份识别 ID。需要注意的是，访客 ID 在用户重新安装 App 以及更换设备时将会变更。
+
+#### 1.1 设置访客 ID
+
+::: tip 提示
+
+ 一般情况下，您不需要自定义访客 ID. 请确保已经理解用户识别规则，再进行访客 ID 的设置。
+
+如果您需要替换访客 ID，则应当在初始化 SDK 结束之后立即进行调用，请勿多次调用，以免产生无用的账号
+
+ :::
+
+如果您的 App 对每个用户有自己的访客 ID 管理体系，则您可以调用*`setDistinctId`* 来设置访客 ID：
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+// 将访客ID设置为Thinker
+TDAnalytics.*setDistinctId*("Thinker");
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+// 将访客ID设置为Thinker
+TDAnalytics.setDistinctId("Thinker")
+```
+
+:::
+
+::::
+
+如果需要获得当前访客 ID，可以调用 `getDistinctId` 获取：
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+//返回访客ID
+String distinctId = TDAnalytics.*getDistinctId*();
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+//返回访客ID
+val distinctId = TDAnalytics.getDistinctId()
+```
+
+:::
+
+::::
+
+#### 1.2 设置账号ID
+
+在用户进行登录时，可调用 `login` 来设置用户的账号 ID， AE 平台将会以账号 ID 作为身份识别 ID，并且设置的账号 ID 将会在调用 `logout` 之前一直保留。多次调用 `login` 将覆盖先前的账号 ID 。
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+// 用户的登录唯一标识，此数据对应上报数据里的#account_id，此时#account_id的值为TA
+TDAnalytics.*login*("TA");
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+// 用户的登录唯一标识，此数据对应上报数据里的#account_id，此时#account_id的值为TA
+TDAnalytics.*login*("TA")
+```
+
+:::
+
+::::
+
+<!-- unsupported block: 34 -->
+
+**该方法不会上传登录事件**
+
+#### 1.3 清除账号 ID
+
+在用户产生登出行为之后，可调用 `logout` 来清除账号 ID，在下次调用 `login` 之前，将会以访客 ID 作为身份识别 ID。
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.*logout*();
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.*logout*()
+```
+
+:::
+
+::::
+
+我们推荐您在显性的登出事件时调用 `logout`，比如用户产生了注销账号这一行为时才调用，而不需要在关闭 App 时调用。
+
+<!-- unsupported block: 34 -->
+
+**该方法不会上传登出事件**
+
+### 二、发送事件
+
+在 SDK 初始化完成之后，您就可以进行数据埋点，收集用户的的行为信息。一般情况下普通事件即可满足业务需求，您也可以根据自己的实际业务场景使用首次、可更新等事件。
+
+#### 2.1 普通事件
+
+ 您可以调用 `track` 来上传事件，建议您根据先前梳理的文档来设置事件的属性，此处以用户购买某商品作为范例：
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+//商店购买事件
+try {
+    JSONObject properties = new JSONObject();
+    properties.put("product_name","商品名");
+    TDAnalytics.*track*("product_buy",properties);
+} catch (JSONException e) {
+    e.printStackTrace();
+}
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+//商店购买事件
+val properties = JSONObject()
+properties.put("product_name", "商品名")
+TDAnalytics.track("product_buy", properties)
+```
+
+:::
+
+::::
+
+#### 2.2 首次事件
+
+首次事件是指针对某个设备或者其他维度的 ID，只会记录一次的事件。例如在一些场景下，您可能希望记录在某个设备上的激活事件，则可以用首次事件来上报数据。
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+JSONObject properties = new JSONObject();
+try {
+    properties.put("key", "value");
+} catch (JSONException e) {
+    e.printStackTrace();
+}
+
+TDAnalytics.*track*(new TDFirstEventModel("device_activation", properties));
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+val properties = JSONObject()
+properties.put("key", "value")
+TDAnalytics.track(TDFirstEventModel("device_activation", properties))
+```
+
+:::
+
+::::
+
+如果您希望以设备以外的其他维度来判断是否首次，则可以为首次事件自定义first_check_id:
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+// 将用户ID设置为首次事件的first_check_id，实现用户首次激活事件的采集
+TDFirstEventModel model = new TDFirstEventModel("device_activation", properties);
+model.setFirstCheckId("TA");
+TDAnalytics.*track*(model);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+// 将用户ID设置为首次事件的first_check_id，实现用户首次激活事件的采集
+val model = TDFirstEventModel("device_activation", properties)
+model.setFirstCheckId("TA")
+TDAnalytics.track(model)
+```
+
+:::
+
+::::
+
+<!-- unsupported block: 34 -->
+
+注意：由于在服务端完成对是否首次的校验，首次事件默认会延时 1 小时入库。
+
+#### 2.3 可更新事件
+
+您可以通过可更新事件实现特定场景下需要修改事件数据的需求。可更新事件需要指定标识该事件的 ID，并在创建可更新事件对象时传入。AE 将根据事件名和事件 ID 来确定需要更新的数据。
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+// 示例： 上报可被更新的事件，假设事件名为 UPDATABLE_EVENT
+// 上报后事件属性 status 为 3, price 为 100
+JSONObject properties = new JSONObject();
+try {
+    properties.put("status", 3);
+    properties.put("price", 100);
+} catch (JSONException e) {
+    e.printStackTrace();
+}
+TDAnalytics.*track*(new TDUpdatableEventModel("UPDATABLE_EVENT", properties, "test_event_id"));
+// 上报后事件属性 status 被更新为 5, price 不变
+JSONObject properties_new = new JSONObject();
+try {
+    properties_new.put("status", 5);
+} catch (JSONException e) {
+    e.printStackTrace();
+}
+TDAnalytics.*track*(new TDUpdatableEventModel("UPDATABLE_EVENT", properties_new, "test_event_id"));
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+// 示例： 上报可被更新的事件，假设事件名为 UPDATABLE_EVENT
+// 上报后事件属性 status 为 3, price 为 100
+val properties = JSONObject()
+properties.put("status", 3)
+properties.put("price", 100)
+TDAnalytics.track(TDUpdatableEventModel("UPDATABLE_EVENT", properties, "test_event_id"))
+// 上报后事件属性 status 被更新为 5, price 不变
+val properties_new = JSONObject()
+properties_new.put("status", 5)
+TDAnalytics.track(TDUpdatableEventModel("UPDATABLE_EVENT", properties_new, "test_event_id"))
+```
+
+:::
+
+::::
+
+#### 2.4 可重写事件
+
+可重写事件与可更新事件类似，区别在于可重写事件会用最新的数据完全覆盖历史数据，从效果上看相当于删除前一条数据，并入库最新的数据。AE 将根据事件名和事件 ID 来确定需要更新的数据。
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+// 示例： 上报可被重写的事件，假设事件名为 OVERWRITE_EVENT
+// 上报后事件属性 status 为 3, price 为 100
+JSONObject properties = new JSONObject();
+try {
+    properties.put("status", 3);
+    properties.put("price", 100);
+} catch (JSONException e) {
+    e.printStackTrace();
+}
+TDAnalytics.*track*(new TDOverWritableEventModel("OVERWRITE_EVENT", properties, "test_event_id"));
+// 上报后事件属性 status 被更新为 5, price 属性被删除
+JSONObject properties_new = new JSONObject();
+try {
+    properties_new.put("status", 5);
+} catch (JSONException e) {
+    e.printStackTrace();
+}
+TDAnalytics.*track*(new TDOverWritableEventModel("OVERWRITE_EVENT", properties_new, "test_event_id"));
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+// 示例： 上报可被重写的事件，假设事件名为 OVERWRITE_EVENT
+// 上报后事件属性 status 为 3, price 为 100
+val properties = JSONObject()
+properties.put("status", 3)
+properties.put("price", 100)
+TDAnalytics.track(TDOverWritableEventModel("OVERWRITE_EVENT", properties, "test_event_id"))
+// 上报后事件属性 status 被更新为 5, price 属性被删除
+val properties_new = JSONObject()
+properties_new.put("status", 5)
+TDAnalytics.track(TDOverWritableEventModel("OVERWRITE_EVENT", properties_new, "test_event_id"))
+```
+
+:::
+
+::::
+
+#### 2.5 公共事件属性
+
+公共事件属性指的就是每个事件都会上传的属性。根据属性更新频率，公共事件属性分为`静态公共事件属性`和`动态公共事件属性`。您可以根据具体的业务场景需求，选择不同的公共事件属性设置方法；我们推荐您在发送事件前，先设置公共事件属性。针对同一事件，当公共事件属性、事件自定义属性、预置属性的Key相同时，我们会按照如下优先级进行赋值:`自定义属性>动态公共事件属性>静态公共事件属性>预置属性`。
+
+##### 2.5.1 静态公共事件属性
+
+ 静态公共事件属性是低频变化且每个事件都会带有的属性，如用户会员等级。通过`setSuperProperties`设置静态公共事件属性之后，SDK将会在事件采集时获取设置的公共事件属性作为事件的属性。
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+//设置公共事件属性
+try {
+    JSONObject superProperties = new JSONObject();
+    superProperties.put("vip_level",2);
+    TDAnalytics.*setSuperProperties*(superProperties);
+} catch (JSONException e) {
+    e.printStackTrace();
+}
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+//设置公共事件属性
+val superProperties = JSONObject()
+superProperties.put("vip_level", 2)
+TDAnalytics.setSuperProperties(superProperties)
+```
+
+:::
+
+::::
+
+静态公共事件属性将会被保存到缓存中，无需每次启动 App 时调用。如果该属性已存在，重新设置的属性将会覆盖原有属性值;如果之前不存在该属性，则会新建属性。除了属性设置，我们也提供其他API来管理静态公共事件属性，满足日常的业务需求。
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+//清除某个公共事件属性
+TDAnalytics.*unsetSuperProperty*("Channel");
+//清除所有公共事件属性
+TDAnalytics.*clearSuperProperties*();
+//获取所有公共事件属性
+TDAnalytics.*getSuperProperties*();
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+//清除某个公共事件属性
+TDAnalytics.*unsetSuperProperty*("Channel")
+//清除所有公共事件属性
+TDAnalytics.*clearSuperProperties*()
+//获取所有公共事件属性
+TDAnalytics.*getSuperProperties*()
+```
+
+:::
+
+::::
+
+##### 2.5.2 动态公共事件属性
+
+动态公共事件属性是高频变化且每个事件都会带有的属性，如用户的金币数量。通过 `setDynamicSuperPropertiesTracker` 设置动态公共属性类之后，SDK 将会在事件采集时自动获取 `getDynamicSuperProperties` 中的属性，并添加到触发的事件中。
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+int coin = 0;    
+TDAnalytics.*setDynamicSuperProperties*(new TDAnalytics.TDDynamicSuperPropertiesHandler() {
+    @Override
+    public JSONObject getDynamicSuperProperties() {
+        JSONObject dynamicSuperProperties = new JSONObject();
+        coin++;//金币数目频繁更新
+        try {
+            dynamicSuperProperties.put("coin",coin);
+        } catch (JSONException e) {
+            e.printStackTrace();
+        }
+        return dynamicSuperProperties;
+    }
+});
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+var coin = 0
+TDAnalytics.setDynamicSuperProperties(object :TDDynamicSuperPropertiesHandler{
+    override fun getDynamicSuperProperties(): JSONObject {
+        val dynamicSuperProperties = JSONObject()
+        coin++ //金币数目频繁更新
+        dynamicSuperProperties.put("coin", coin)
+        return dynamicSuperProperties
+    }
+})
+```
+
+:::
+
+::::
+
+#### 2.6 记录事件时长
+
+如果您需要记录某个事件的持续时长，可以调用 `timeEvent` 来开始计时。配置您想要计时的事件名称，当您上传该事件时，将会自动在您的事件属性中加入 `#duration` 这一属性来表示记录的时长，单位为秒。需要注意的是，同一个事件名只能有一个在计时的任务。
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+//以下示例，完成用户在某个商品页面停留时长的统计
+try {
+    //用户进入商品页面，开始计时
+    TDAnalytics.*timeEvent*("stay_shop");
+    /**do someting
+    .......
+    **/
+    //用户离开商品页面，计时结束，"stay_shop" 这一事件中将会带有表示事件时长的属性#duration
+    TDAnalytics.*track*("stay_shop");
+} catch (JSONException e) {
+    e.printStackTrace();
+}
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+//以下示例，完成用户在某个商品页面停留时长的统计
+//用户进入商品页面，开始计时
+TDAnalytics.timeEvent("stay_shop")
+*/**do someting*
+* * .......*
+* */*
+//用户离开商品页面，计时结束，"stay_shop" 这一事件中将会带有表示事件时长的属性#duration
+TDAnalytics.track("stay_shop")
+```
+
+:::
+
+::::
+
+### 三、用户属性
+
+TE支持的用户属性设置API有: `userSet`、`userSetOnce`、`userAdd`、`userUnset`、`userDelete`、`userAppend`、`userUniqAppend`
+
+#### 3.1 userSet
+
+对于一般的用户属性，您可以调用`userSet`来进行设置。使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例：
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+try {
+    //此时username为TA
+    JSONObject properties = new JSONObject();
+    properties.put("username","TA");
+    TDAnalytics.*userSet*(properties);
+    //此时userName为TE
+    JSONObject newProperties = new JSONObject();
+    newProperties.put("username","TE");
+    TDAnalytics.*userSet*(newProperties);
+} catch (JSONException e) {
+    e.printStackTrace();
+}
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+//此时username为TA
+val properties = JSONObject()
+properties.put("username", "TA")
+TDAnalytics.userSet(properties)
+//此时userName为TE
+val newProperties = JSONObject()
+newProperties.put("username", "TE")
+TDAnalytics.userSet(newProperties)
+```
+
+:::
+
+::::
+
+#### 3.2 userSetOnce
+
+如果您要上传的用户属性只要设置一次，则可以调用 `userSetOnce` 来进行设置，当该属性之前已经有值的时候，将会忽略这条信息，以设置首次付费时间来为例：
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+try {
+    //first_payment_time为2018-01-01 01:23:45.678
+    JSONObject properties = new JSONObject();
+    properties.put("first_payment_time","2018-01-01 01:23:45.678");
+    TDAnalytics.*userSetOnce*(properties);
+    
+    //first_payment_time仍然为2018-01-01 01:23:45.678
+    JSONObject newProperties = new JSONObject();
+    newProperties.put("first_payment_time","2018-12-31 01:23:45.678");
+    TDAnalytics.*userSetOnce*(newProperties); 
+       
+} catch (JSONException e) {
+    e.printStackTrace();
+}
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+//first_payment_time为2018-01-01 01:23:45.678
+val properties = JSONObject()
+properties.put("first_payment_time", "2018-01-01 01:23:45.678")
+TDAnalytics.userSetOnce(properties)
+
+//first_payment_time仍然为2018-01-01 01:23:45.678
+val newProperties = JSONObject()
+newProperties.put("first_payment_time", "2018-12-31 01:23:45.678")
+TDAnalytics.userSetOnce(newProperties)
+```
+
+:::
+
+::::
+
+#### 3.3 userAdd
+
+当您要上传数值型的属性进行累加操作时，您可以调用`userAdd`。如果该属性还未被设置，则会赋值 0 后再进行计算，可传入负值，等同于相减操作。此处以累计付费金额为例：
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+try {
+    //此时total_revenue为30
+    JSONObject properties = new JSONObject();
+    properties.put("total_revenue",30);
+    TDAnalytics.*userAdd*(properties);
+    
+    //此时total_revenue为678
+    JSONObject newProperties = new JSONObject();
+    newProperties.put("total_revenue",648);
+    TDAnalytics.*userAdd*(newProperties);
+} catch (JSONException e) {
+    e.printStackTrace();
+}
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+//此时total_revenue为30
+val properties = JSONObject()
+properties.put("total_revenue", 30)
+TDAnalytics.userAdd(properties)
+
+//此时total_revenue为678
+val newProperties = JSONObject()
+newProperties.put("total_revenue", 648)
+TDAnalytics.userAdd(newProperties)
+```
+
+:::
+
+::::
+
+#### 3.4 userUnset
+
+当您要清空用户的用户属性值时，您可以调用` userUnset`来对指定属性进行清空操作，如果该属性还未在集群中被创建，则 `userUnset`**不会**创建该属性
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+// 重置单个用户属性
+TDAnalytics.*userUnset*("key1");
+// 重置多个用户属性
+TDAnalytics.*userUnset*("key1", "key2", "key3");
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+// 重置单个用户属性
+TDAnalytics.*userUnset*("key1")
+// 重置多个用户属性
+TDAnalytics.*userUnset*("key1", "key2", "key3")
+```
+
+:::
+
+::::
+
+#### 3.5 userDelete
+
+ 如果您要删除某个用户，可以调用 `userDelete`将这名用户删除，您将无法再查询该名用户的用户属性，但该用户产生的事件仍然可以被查询到。
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.*userDelete*();
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.*userDelete*()
+```
+
+:::
+
+::::
+
+#### 3.6 userAppend
+
+您可以调用`userAppend`对数组类型的用户属性进行追加操作。
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+try {
+    // list 为用户属性 user_list 的值，JSONArray 类型
+    JSONArray list = new JSONArray("[\"apple\", \"ball\"]");
+    JSONObject properties = new JSONObject();
+    properties.put("user_list", list);
+    // 调用 user_append 为用户属性 user_list 追加元素。如果不存在，会新建该元素
+    TDAnalytics.*userAppend*(properties);
+} catch (JSONException e) {
+    e.printStackTrace();
+}
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+// list 为用户属性 user_list 的值，JSONArray 类型
+val list = JSONArray("[\"apple\", \"ball\"]")
+val properties = JSONObject()
+properties.put("user_list", list)
+// 调用 user_append 为用户属性 user_list 追加元素。如果不存在，会新建该元素
+TDAnalytics.userAppend(properties)
+```
+
+:::
+
+::::
+
+#### 3.7 userUniqAppend
+
+您可以调用 `userUniqAppend` 对 数组类型的用户属性进行追加操作。调用 `userUniqAppend`接口会对追加的用户属性进行去重， userAppend 接口不做去重，用户属性可存在重复。
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+try {
+    // list 为用户属性 user_list 的值，JSONArray 类型
+    //此时user_list的属性值为["apple"，"ball"]
+    JSONArray list = new JSONArray("[\"apple\", \"ball\"]");
+    JSONObject properties = new JSONObject();
+    properties.put("user_list", list);
+    TDAnalytics.*userAppend*(properties);
+    
+    
+    //此时user_list的属性值为["apple","apple","ball","cube"]
+    JSONArray list1 = new JSONArray("[\"apple\", \"cube\"]");
+    JSONObject properties1 = new JSONObject();
+    properties1.put("user_list", list1);
+    TDAnalytics.*userAppend*(properties1);
+    
+    //此时user_list的属性值为["apple"，"ball","cube"]
+    TDAnalytics.*userUniqAppend*(properties1);
+    
+} catch (JSONException e) {
+    e.printStackTrace();
+}
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+// list 为用户属性 user_list 的值，JSONArray 类型
+//此时user_list的属性值为["apple"，"ball"]
+val list = JSONArray("[\"apple\", \"ball\"]")
+val properties = JSONObject()
+properties.put("user_list", list)
+TDAnalytics.userAppend(properties)
+
+//此时user_list的属性值为["apple","apple","ball","cube"]
+val list1 = JSONArray("[\"apple\", \"cube\"]")
+val properties1 = JSONObject()
+properties1.put("user_list", list1)
+TDAnalytics.userAppend(properties1)
+
+//此时user_list的属性值为["apple"，"ball","cube"]
+TDAnalytics.userUniqAppend(properties1)
+```
+
+:::
+
+::::
+
+### 四、加密功能
+
+从 v2.8.0 版本开始，SDK 支持使用AES+RSA加密数据。数据加密功能需要客户端和服务端配合完成，具体使用方法请咨询客户成功人员。
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDConfig config = TDConfig.getInstance(mContext,TA_APP_ID,TA_SERVER_URL);
+//开启加密功能 设置公钥信息
+config.enableEncrypt(1,"publicKey")
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+val config = TDConfig.getInstance(mContext,TA_APP_ID,TA_SERVER_URL)
+//开启加密功能 设置公钥信息
+config.enableEncrypt(1,"publicKey")
+```
+
+:::
+
+::::
+
+### 五、开启与 H5 页面的打通
+
+如果需要与采集 H5 页面数据的 JavaScript SDK 进行打通，在初始化 `WebView` 时调用如下接口，详情请参考H5 与 APP SDK 打通一节
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+// 打通 H5 页面数据
+TDAnalytics.setJsBridge(webView);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+// 打通 H5 页面数据
+TDAnalytics.setJsBridge(webView)
+```
+
+:::
+
+::::
+
+### 六、其他功能
+
+#### 6.1 获取设备 ID
+
+您可以通过调用 `getDeviceId` 来获取设备 ID：
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+String deviceID = TDAnalytics.*getDeviceId*();//设备ID取值Android ID
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+val deviceID = TDAnalytics.getDeviceId() //设备ID取值Android ID
+```
+
+:::
+
+::::
+
+#### 6.2 设置默认时区
+
+默认情况下,SDK 会使用本机时间作为事件发生时间。您也可以通过设置默认时区接口，指定时区，这样所有的事件都将按照您设置的时区来对齐事件时间：
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+// 获取 TDConfig 实例
+TDConfig config = TDConfig.getInstance(this, TA_APP_ID, TA_SERVER_URL);
+// 设置默认时区为 UTC
+config.setDefaultTimeZone(TimeZone.getTimeZone("UTC"));
+// 初始化 SDK
+TDAnalytics.*init*(config);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+// 获取 TDConfig 实例
+val config = TDConfig.getInstance(this, TA_APP_ID, TA_SERVER_URL)
+// 设置默认时区为 UTC
+config.*defaultTimeZone *= TimeZone.getTimeZone("UTC")
+// 初始化 SDK
+TDAnalytics.init(config)
+```
+
+:::
+
+::::
+
+<!-- unsupported block: 34 -->
+
+用指定时区对齐事件时间，会丢掉设备本机时区信息。如果需要保留设备本机时区信息，目前需要您自己为事件添加相关属性。
+
+#### 6.3 校准时间
+
+SDK 默认会使用本机时间作为事件发生时间，如果用户手动修改设备时间会影响到您的业务分析，此时可以通过校准时间操作保证事件发生时间的准确性。我们提供`时间戳、NTP`两种时间校准方式。
+
+- 您可以使用从服务端获取的当前时间戳对 SDK 的时间进行校准。此后，所有未指定时间的调用，包括事件数据和用户属性设置操作，都会使用校准后的时间作为发生时间。
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+// 1585633785954 为当前 unix 时间戳，单位为毫秒，对应北京时间 2020-03-31 13:49:45
+TDAnalytics.calibrateTime(1585633785954);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+// 1585633785954 为当前 unix 时间戳，单位为毫秒，对应北京时间 2020-03-31 13:49:45
+TDAnalytics.calibrateTime(1585633785954)
+```
+
+:::
+
+::::
+
+- 您也可以设置NTP服务器地址，之后 SDK 会尝试从传入的 NTP 服务地址中获取当前时间，并对 SDK 时间进行校准。如果在默认的超时时间（3 秒）之内，未获取正确的返回结果，后续将使用本地时间上报数据。
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+// 使用苹果公司 NTP 服务对时间进行校准
+TDAnalytics.calibrateTimeWithNtp("time.apple.com");
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+// 使用苹果公司 NTP 服务对时间进行校准
+TDAnalytics.calibrateTimeWithNtp("time.apple.com")
+```
+
+:::
+
+::::
+
+<!-- unsupported block: 34 -->
+
+1、使用 NTP 服务进行时间校准存在一定的不确定性，建议您优先考虑用时间戳校准的方式
+
+2、您需要谨慎地选择您的 NTP 服务器地址，以保证网络状况良好的情况下，用户设备可以很快的获取到服务器时间
+
+#### 6.4 立即上报数据
+
+在某些业务场景下，如果您期望数据立即上报到 AE 服务器，可以通过调用`flush`接口完成
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.flush();
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.flush()
+```
+
+:::
+
+::::
+
+#### 6.5 获取国家/地区代码
+
+在某些业务场景下，如果您需要知道用户设备的国家/地区代码，可以通过`getLocalRegion`来获取
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.getLocalRegion();
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.getLocalRegion()
+```
+
+:::
+
+::::
+
+#### 6.6 禁止AndroidID获取
+
+如果您不需要项目中出现安卓ID采集的代码，可以利用插件来实现敏感属性(如AndroidID)的代码隔离。
+
+安卓分析SDK版本
+
+插件版本
+
+[oldest - 3.0.0)
+
+1.2.0
+
+[3.0.0 - 3.1.0]
+
+2.1.0
+
+(3.1.0 - latest]
+
+2.2.0
+
+```
+  buildscript {
+     repositories {
+         google()
+         jcenter()
+     }
+     dependencies {
+         classpath 'cn.thinkingdata.android:android-gradle-plugin2:2.2.0'
+      }
+}
+// Configure disableAndroidID to true in the project build.gradle file
+apply plugin: 'cn.thinkingdata.android'
+android {}
+ThinkingAnalytics {
+    debug = true
+    sdk{
+        disableAndroidID = true
+     }
+}
+```
+
+参数详解：
+
+- debug ：是否打开编译日志，true为打开编译日志，默认为false。
+- exclude ：排除扫描某个路径下的类，可以通过设置exclude = ['cn.thinkingdata.android','android.support']。
+- useInclude 、include：只想扫描某个路径下的类，可以设置useInclude = true，include= ['cn.thinkingdata.android','android.support']。
+- disableAndroidID ：是否禁用调用系统API获取AndroidID，从插件V2.1.0版本开始，可通过设置disableAndroidID = true来配置。
+#### 6.7 支持IP上报数据
+
+为了预防或解决因DNS劫持导致客户端数据无法正常上报到服务器问题，SDK通过解析ServerUrl获取IP，然后通过IP直接上报数据至服务器。具体开启示例如下：
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDConfig config = TDConfig.getInstance(this, APPID, TE_SERVER_URL);
+List<TDConfig.TDDNSService> list = new ArrayList<>();
+list.add(TDConfig.TDDNSService.*CLOUD_ALI*);
+list.add(TDConfig.TDDNSService.*CLOUD_FLARE*);
+list.add(TDConfig.TDDNSService.*CLOUD_GOOGLE*);
+config.enableDNSService(list);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+val config = TDConfig.getInstance(this, APPID, TE_SERVER_URL)
+val list: MutableList<TDDNSService> = ArrayList()
+list.add(TDDNSService.*CLOUD_ALI*)
+list.add(TDDNSService.*CLOUD_FLARE*)
+list.add(TDDNSService.*CLOUD_GOOGLE*)
+config.enableDNSService(list)
+```
+
+:::
+
+::::
+
+#### 6.8 支持sdk错误回调
+
+<!-- unsupported block: 19 -->
+
+需要安卓SDK版本>=3.2.0
+
+在某些场景下，您有可能想在网络请求失败时自定义操作，这就可以注册errorCallback，具体开启事例如下:
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.*registerErrorCallback*(new TDAnalytics.TDSendDataErrorCallback() {
+    @Override
+    public void onSDKErrorCallback(int code, String errorMsg, String ext) {
+        // *todo*
+*    *}
+});
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.registerErrorCallback(object : TDAnalytics.TDSendDataErrorCallback {
+    override fun onSDKErrorCallback(code: Int, errorMsg: String?, ext: String?) {
+        // *todo*
+*    *}
+})
+```
+
+:::
+
+::::
+
+code错误码
+
+错误码
+
+描述
+
+1001
+
+网络请求失败