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//344/270/211/346/226/271/346/225/260/346/215/256.md

@@ -0,0 +1,367 @@
+---
+code: android_sdk_thirdparty
+name: "三方数据"
+wikiToken: TL4NwhIrriKNZ8k7mbVcQDAenTb
+parentWikiToken: J7zFwvYawiv1E6k6TsYc5YzXnLc
+updateTime: 1750746373000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=android_sdk_thirdparty
+---
+# 三方数据
+
+<!-- unsupported block: 19 -->
+
+如果采集SDK的版本低于3.0.0，插件版本需要使用1.3.0，如果采集SDK的版本大于等于3.0.0，插件版本需要大于2.0.0
+
+```
+implementation 'cn.thinkingdata.android:TAThirdParty:2.0.2'
+```
+
+以下是同步多个平台数据的示例代码:
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*APPS_FLYER *| TDThirdPartyType.*ADJUST*);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.enableThirdPartySharing(TDThirdPartyType.APPS_FLYER or TDThirdPartyType.ADJUST)
+```
+
+:::
+
+::::
+
+<!-- unsupported block: 34 -->
+
+如果需要增加额外参数，可以使用`enableThirdPartySharing(int var1, Map<String, Object> var2)`，该API不支持位运算
+
+如果使用了 proguard，为了防止功能失效，需要在配置文件中加入以下内容：
+
+```
+-dontwarn cn.thinkingdata.thirdparty.**
+-keep class cn.thinkingdata.thirdparty.** { *; }
+-keep class cn.thinkingdata.module.routes.** { *; }
+```
+
+### 1. Appsflyer
+
+在AppsFlyer SDK调用start方法之前调用API:
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.enableThirdPartySharing(TDThirdPartyType.*APPS_FLYER*);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.enableThirdPartySharing(TDThirdPartyType.*APPS_FLYER*)
+```
+
+:::
+
+::::
+
+注册创角色之后(可选)： 
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.login("account_id")
+TDAnalytics.enableThirdPartySharing(TDThirdPartyType.*APPS_FLYER*);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.login("account_id")
+TDAnalytics.enableThirdPartySharing(TDThirdPartyType.*APPS_FLYER*)
+```
+
+:::
+
+::::
+
+每次调用了TE的`login`方法或者`identify`方法，您需要同步调用enableThirdPartySharing更新用户标识。
+
+注意:由于AppFlyer的setAdditionalData每次调用，会覆盖设置的用户标识。您可以通过我们提供的`enableThirdPartySharing`方法设置参数:
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+Map<String, Object> additionalData = new HashMap<>();
+additionalData.put("af_test_key1", "test1");
+additionalData.put("af_test_key2", "test2");
+TDAnalytics.enableThirdPartySharing(
+    TDThirdPartyType.*APPS_FLYER*,
+    additionalData
+)
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+val additionalData: MutableMap<String, Any> = HashMap()
+additionalData["af_test_key1"] = "test1"
+additionalData["af_test_key2"] = "test2"
+TDAnalytics.enableThirdPartySharing(
+    TDThirdPartyType.*APPS_FLYER*,
+    additionalData
+)
+```
+
+:::
+
+::::
+
+### 2. Adjust
+
+在Adjust SDK初始化之前调用: 
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.enableThirdPartySharing(TDThirdPartyType.*ADJUST*);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.enableThirdPartySharing(TDThirdPartyType.*ADJUST*)
+```
+
+:::
+
+::::
+
+注册创角色之后(可选):
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.login("accoount_id")
+TDAnalytics.enableThirdPartySharing(TDThirdPartyType.*ADJUST*);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.login("accoount_id")
+TDAnalytics.enableThirdPartySharing(TDThirdPartyType.*ADJUST*)
+```
+
+:::
+
+::::
+
+### 3. Branch
+
+在Branch initialize the session之前调用:
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*BRANCH*);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*BRANCH*)
+```
+
+:::
+
+::::
+
+注册创角色之后(可选):
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.login("accoount_id")
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*BRANCH*);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.login("accoount_id")
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*BRANCH*)
+```
+
+:::
+
+::::
+
+### 4. TopOn
+
+在ATSDK.*init之前调用:*
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*TOP_ON*);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*TOP_ON*)
+```
+
+:::
+
+::::
+
+多次调用TE的`login`或者`identify`，需要再次调用enableThirdPartySharing同步数据。
+
+注意:由于TopOn的initCustomMap每次调用，会覆盖设置的用户标识。您可以通过我们提供的`enableThirdPartySharing`方法设置参数:
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+Map<String, Object> customMap = new HashMap<>();
+customMap.put("key1", "value1");
+customMap.put("key2", "value2");
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*TOP_ON, customMap*);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+val customMap: MutableMap<String, Any> = HashMap()
+customMap["key1"] = "value1"
+customMap["key2"] = "value2"
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*TOP_ON, customMap*)
+```
+
+:::
+
+::::
+
+### 5. Tradplus
+
+在TradPlusSdk.*initSdk之前调用：*
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*TRAD_PLUS*);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*TRAD_PLUS*)
+```
+
+:::
+
+::::
+
+### 6. IronSource
+
+在IronSourceSdk初始化之后调用:
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*IRON_SOURCE*);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*IRON_SOURCE*)
+```
+
+:::
+
+::::
+
+### 7. AppLovin
+
+- 展示级别
+在AppLovinSdk初始化之前调用:
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*APPLOVIN_IMPRESSION*);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*APPLOVIN_IMPRESSION*)
+```
+
+:::
+
+::::
+
+- 用户级别
+如果要实现变现数据获取，您需要创建 `MaxAdRevenueListener`，并复写 `onAdRevenuePaid()` 方法，在该方法中获取变现数据并且通过 AE SDK 的`enableThirdPartySharing`进行数据上报，最后将该监听器传递给 setRevenueListener()，示例代码如下：
+
+```
+void onAdRevenuePaid(final MaxAd ad){
+    TDAnalytics.*enableThirdPartySharing*(TDThirdPartyType.*APPLOVIN_USER,ad*);
+}
+```

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//345/244/232/345/256/236/344/276/213.md

@@ -0,0 +1,117 @@
+---
+code: android_sdk_multi_appid
+name: "多实例"
+wikiToken: DqIVwMvuYioiREkZ6Vrcpu4AnVc
+parentWikiToken: J7zFwvYawiv1E6k6TsYc5YzXnLc
+updateTime: 1765178222000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=android_sdk_multi_appid
+---
+# 多实例
+
+### 一、功能介绍
+
+我们支持使用多个Appid，创建SDK实例，我们简称为多实例。通过多实例功能，您可以上报数据到不同的项目。
+
+### 二、创建多实例
+
+传入不同的 APP ID 完成 SDK 初始化，即可创建多个 SDK 实例：
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+// 初始化 SDK
+TDAnalytics.init(this, TA_APP_ID, TA_SERVER_URL);
+TDAnalyticsAPI.track("some_event",properties, TA_APP_ID);
+
+TDAnalytics.init(this, ANOTHER_TA_APP_ID, TA_SERVER_URL);
+TDAnalyticsAPI.track("some_event",properties, ANOTHER_TA_APP_ID)
+
+TDAnalytics.init(this, TA_APP_ID, TA_SERVER_URL, NAME);
+TDAnalyticsAPI.track("some_event",properties, NAME);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.init(this, TA_APP_ID, TA_SERVER_URL)
+TDAnalytics.init(this, ANOTHER_TA_APP_ID, TA_SERVER_URL)
+
+TDAnalyticsAPI.track("some_event",properties, TA_APP_ID)
+TDAnalyticsAPI.track("some_event",properties, ANOTHER_TA_APP_ID)
+```
+
+:::
+
+::::
+
+请注意多个 SDK 实例的 APP ID 必须不同，多实例之间的大多数数据是不共通的，详情可参考第四节“多实例间的数据、设置共享”。
+
+### 三、创建轻实例
+
+您可以通过轻实例的方式，创建同一个 APPID 下的多个实例
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+//首先创建一个SDK实例
+TDAnalytics.init(this, TA_APP_ID, TA_SERVER_URL);
+//通过之前创建的实例，调用*lightInstance*生成轻实例
+String uuid = TDAnalytics.*lightInstance*();
+TDAnalyticsAPI.login("anotherAccount",uuid);
+TDAnalyticsAPI.track("some_event",properties,uuid);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+//首先创建一个SDK实例
+TDAnalytics.init(this, TA_APP_ID, TA_SERVER_URL)
+//通过之前创建的实例，调用lightInstance生成轻实例
+val uuid = TDAnalytics.lightInstance()
+TDAnalyticsAPI.login("anotherAccount", uuid)
+TDAnalyticsAPI.track("some_event", properties, uuid)
+```
+
+:::
+
+::::
+
+子轻量实例与父实例的 APPID、上报地址以及部分设置一致，但其他信息不共享，详情可参考第四节“多实例间的数据、设置共享”。
+
+### 四、多实例间的数据共享
+
+大多数接口都是由实例对象所调用，因此绝大部分数据与设置在多 APPID 实例、父实例与轻量实例间是不共享的，但有部分数据与设置会对所有实例生效，以下是所有数据与设置在多实例间是否共享的详细说明：
+
+1. 账号相关信息
+- 系统默认生成的访客 ID`#distinct_id`：共享
+- 调用 `identify` 设置的访客 ID`#distinct_id`：不共享
+- 调用`login`设置的账号 ID`#account_id`：不共享
+1. 事件上报`track`与用户属性上报`user_set`、`user_setOnce`、`user_add`、`user_delete`：不共享
+1. 公共属性`setSuperProperties`和动态公共属性`setDynamicSuperPropertiesTracker`：不共享
+1. SDK 配置信息是否在多实例之间共享：
+- 上报策略相关（即上报的间隔时间与每批次数据量）：共享，由第一个实例化的 APPID 对应的项目数据决定
+- 上传的网络条件`setNetworkType`：共享
+- 打印上传数据 Log`EnableTrackLogging`：共享
+1. 自动采集事件
+- 建议只在一个实例上开启自动采集事件
+- 支持向多个 APP ID 上报自动采集事件
+- 自动采集事件的相关配置是否在多实例共享： 
+- 设置控件 ID`setViewID`：不共享
+- 自定义控件属性`setViewProperties`等：不共享
+- 忽略某个页面的自动采集事件`ignoreAutoTrackActivity`等：不共享
+- 忽略某个类型控件的点击事件`ignoreViewType`：不共享
+- 忽略某个控件`ignoreView`：不共享
+- 所有的注解：可以通过设置 appId 参数指定生效的实例。如果不设置，则所有实例共享该配置，如：
+```
+@ThinkingDataIgnoreTrackAppViewScreen(appId = "debug-appid")
+```
+
+1. 记录事件时长`timeEvent`：不共享

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//345/256/236/346/227/266/350/260/203/350/257/225.md

@@ -0,0 +1,96 @@
+---
+code: android_sdk_debug
+name: "实时调试"
+wikiToken: QQLhwKHMZi8vlZkccTbch9avn0e
+parentWikiToken: J7zFwvYawiv1E6k6TsYc5YzXnLc
+updateTime: 1745310860000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=android_sdk_debug
+---
+# 实时调试
+
+在SDK接入过程中，您可以通过查看SDK在IDE控制台中的日志或者使用 AE 的Debug功能，进行实时调试。
+
+### 一、打印SDK日志
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+TDAnalytics.enableLog(true);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+TDAnalytics.enableLog(true)
+```
+
+:::
+
+::::
+
+<!-- unsupported block: 34 -->
+
+打开日志后，可以在IDE中过滤 ThinkingAnalytics 相关的日志来观察 SDK 的数据上报。
+
+### 二、开启 Debug 模式
+
+开启Debug模式需要如下两步操作:
+
+1. 客户端开启Debug模式
+以下是客户端开启Debug模式的示例代码:
+
+:::: el-tabs
+
+::: el-tab-pane label=Java
+
+```
+// 获取 TDConfig 实例
+TDConfig config = TDConfig.getInstance(this, TA_APP_ID, TA_SERVER_URL);
+/*
+设置运行模式为 Debug 模式
+NORMAL模式:数据会存入缓存，并依据一定的缓存策略上报,默认为NORMAL模式；建议在线上环境使用
+Debug模式:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
+DebugOnly模式:只对数据做校验，不会入库；不建议在线上环境使用
+ */
+config.setMode(TDConfig.TDMode.DEBUG);
+// 初始化 SDK
+TDAnalytics.*init*(config);
+```
+
+:::
+
+::: el-tab-pane label=Kotlin
+
+```
+// 获取 TDConfig 实例
+val config = TDConfig.getInstance(this, TA_APP_ID, TA_SERVER_URL)
+/*
+设置运行模式为 Debug 模式
+NORMAL模式:数据会存入缓存，并依据一定的缓存策略上报,默认为NORMAL模式；建议在线上环境使用
+Debug模式:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
+DebugOnly模式:只对数据做校验，不会入库；不建议在线上环境使用
+ */
+config.setMode(TDConfig.TDMode.*DEBUG*)
+// 初始化 SDK
+TDAnalytics.init(config)
+```
+
+:::
+
+::::
+
+1. AE 后台添加Debug设备
+为了避免 Debug 模式在生产环境上线，规定只有指定的设备才能开启 Debug 模式。只有在客户端开启了 Debug 模式，并且设备 ID 在 AE 后台的"埋点管理"页的"Debug 数据"板块中配置了的设备才能开启 Debug 模式。
+
+设备 ID 可以通过以下三种方式获取：
+
+- AE 平台中事件数据中的 #device_id 属性
+- 客户端日志：SDK 初始化完成后会打印设备 DeviceId
+- 通过实例接口调用：获取设备ID
+<!-- unsupported block: 34 -->
+
+Debug 模式可能会影响数据采集质量和 App 的稳定性，只用于集成阶段数据验证，不要在线上环境使用。