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

@@ -0,0 +1,128 @@
+---
+code: openharmony_sdk_release_note
+name: "更新日志"
+wikiToken: G4qCwzl1Fil0G8kdyOScn0jjnRe
+parentWikiToken: CdewwjvM9irVHckq2lvctVPNnhf
+updateTime: 1767580357000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=openharmony_sdk_release_note
+---
+# 更新日志
+
+### v1.7.6
+
+**更新时间: 2026/01/05 **下载
+
+**更新内容：**
+
+- 已知问题修复
+### v1.7.5
+
+**更新时间: 2025/09/23 **下载
+
+**更新内容：**
+
+- 已知问题修复
+### v1.7.4
+
+**更新时间: 2025/08/29**
+
+**更新内容：**
+
+- 使用发布证书签名
+### v1.7.3
+
+**更新时间: 2025/08/12 **下载
+
+**更新内容：**
+
+- 已知问题修复
+### v1.7.1
+
+**更新时间: 2025/03/15**
+
+**更新内容：**
+
+- 更改为正式签名
+### v1.7.0
+
+**更新时间: 2025/03/10**
+
+**更新内容：**
+
+- SDK签名、混淆、字节码打包
+### v1.6.0
+
+**更新时间: 2025/01/20**
+
+**更新内容：**
+
+- 支持自动采集控件点击事件
+- 支持自动采集Router页面浏览事件
+- 设备号卸载之后保持不变
+### v1.5.0
+
+**更新时间: 2024/12/30**
+
+**更新内容：**
+
+- 提供获取账号ID接口
+- 解决API调用时序问题
+- 自动采集事件支持自定义属性
+- 预置属性开关
+- H5页面数据打通
+- 代码优化
+### v1.4.0
+
+**更新时间: 2024/10/10**
+
+**更新内容：**
+
+- 支持在work线程中调用
+### v1.3.0
+
+**更新时间: 2024/06/07**
+
+**更新内容：**
+
+- 修复userUnset带时间无效的问题
+- userDelete支持带时间
+- 初始化、timeEvent、calibrateTime去除await
+### v1.2.1
+
+**更新时间: 2024/05/15**
+
+**更新内容：**
+
+- 指定http协议为1.1解决部分手机上报数据失败问题
+### v1.2.0
+
+**更新时间: 2024/04/12**
+
+**更新内容：**
+
+- 增加数据缓存和批量发送功能
+- 支持自动采集
+- 支持数据存储和上报加密
+- 支持自定义时区
+- 支持事件上报带时区
+- 数据上报策略-支持WIFI、ALL
+### v1.1.0
+
+**更新时间: 2024/01/11**
+
+**更新内容：**
+
+- 适配ArkTS
+- 解决获取访客ID为空的问题
+### v1.0.0
+
+**更新时间: 2023/10/23**
+
+**更新内容：**
+
+- 支持事件和用户属性上报
+- 支持首次、更新、重写事件的上报
+- 支持 访客 ID 和 用户账号 的设置
+- 支持静态公共属性和动态公共属性设置
+- 支持Debug和DebugOnly模式上报数据
+- 支持时间校准功能

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

@@ -0,0 +1,60 @@
+---
+code: openharmony_sdk_multi_appid
+name: "多实例"
+wikiToken: CBaFwyEqMigN7Lkz0lacouVLnrf
+parentWikiToken: Ci0xwEVoxiX0GSkkVPLc7bZRnQf
+updateTime: 1745309681000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=openharmony_sdk_multi_appid
+---
+# 多实例
+
+### 一、功能介绍
+
+我们支持使用多个Appid，创建SDK实例，我们简称为多实例。通过多实例功能，您可以上报数据到不同的项目。
+
+### 二、创建多实例
+
+传入不同的 APP ID 完成 SDK 初始化，即可创建多个 SDK 实例：
+
+```
+//初始化配置1
+var config_1 = {
+  appId: "app-id-1", 
+  serverUrl: "https://youserverurl.1.com"
+};
+TDAnalytics.init(config_1);
+
+//初始化配置2
+var config_2 = {
+  appId: "app-id-2", 
+  serverUrl: "https://youserverurl.2.com"
+};
+TDAnalytics.init(config_2);
+
+//上报事件到配置1（不传app-id，默认上报到配置1）
+TDAnalytics.track({
+    eventName: 'event_from_appid_1'
+});
+//上报事件到配置1（指定app-id-1）
+TDAnalytics.track({
+    eventName: 'event_from_appid_1'
+}, 'app-id-1');
+//上报事件到配置2（指定app-id-2）
+TDAnalytics.track({
+    eventName: 'event_from_appid_2'
+}, 'app-id-2');
+```
+
+请注意多个 SDK 实例的 APP ID 必须不同，多实例之间的大多数数据是不共通的，详情可参考第四节“多实例间的数据、设置共享”。
+
+### 三、多实例间的数据共享
+
+大多数接口都是由实例对象所调用，因此绝大部分数据与设置在多 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. 记录事件时长`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/openharmony//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: openharmony_sdk_debug
+name: "实时调试"
+wikiToken: ONWgwY8Ytijp8ska1dtcsStunBd
+parentWikiToken: Ci0xwEVoxiX0GSkkVPLc7bZRnQf
+updateTime: 1745310867000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=openharmony_sdk_debug
+---
+# 实时调试
+
+在SDK接入过程中，您可以通过查看SDK在IDE控制台中的日志或者使用 AE 的Debug功能，进行实时调试。
+
+### 一、打印SDK日志
+
+```
+TDAnalytics.enableLog(true)
+```
+
+<!-- unsupported block: 34 -->
+
+打开日志后，可以在IDE中来观察 SDK 的数据上报。
+
+### 二、开启 Debug 模式
+
+开启Debug模式需要如下两步操作:
+
+1. 客户端开启Debug模式
+以下是客户端开启Debug模式的示例代码:
+
+```
+/*
+设置运行模式为 Debug 模式
+TDMode.NORMAL:数据会存入缓存，并依据一定的缓存策略上报,默认为NORMAL模式；建议在线上环境使用
+TDMode.DEBUG:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
+TDMode.DEBUG_ONLY:只对数据做校验，不会入库；不建议在线上环境使用
+ */
+let config = new TDConfig()
+config.appId = 'appID'
+config.serverUrl = 'serverUrl'
+config.mode = TDMode.DEBUG
+await TDAnalytics.initWithConfig(this.context, config)
+```
+
+1. TA后台添加Debug设备
+为了避免 Debug 模式在生产环境上线，规定只有指定的设备才能开启 Debug 模式。只有在客户端开启了 Debug 模式，并且设备 ID 在 TA 后台的"埋点管理"页的"Debug 数据"板块中配置了的设备才能开启 Debug 模式。
+
+设备 ID 可以通过以下三种方式获取：
+
+- TA 平台中事件数据中的 #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/openharmony//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,121 @@
+---
+code: android_sdk_autotrack
+name: "自动采集"
+wikiToken: CSyTwo8RhiMLtVk5ZshcxA6YnYc
+parentWikiToken: Ci0xwEVoxiX0GSkkVPLc7bZRnQf
+updateTime: 1745309677000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=android_sdk_autotrack
+---
+# 自动采集
+
+OpenHarmony SDK 支持包括安装、启动、关闭等在内事件的自动采集。
+
+### 一、介绍
+
+AE 系统提供自动化收集数据的接口，您可根据业务需求自行选择需要自动收集的数据。
+
+目前支持的自动采集事件类型有：
+
+1. 安装事件：记录 APP 被安装的行为
+1. 启动事件：包括打开 APP 和从后台打开APP
+1. 关闭事件：包括关闭 APP 和App进入后台
+1. 浏览事件：用户在 APP 中浏览页面（Ability）
+1. 点击事件：用户在 APP 中点击控件
+1. 崩溃事件：APP 发生崩溃时记录崩溃信息（native层的崩溃暂不支持）
+接下来将会详细介绍每种数据的采集方法
+
+### 二、开启自动采集
+
+您可以调用`enableAutoTrack`，打开自动采集功能：
+
+```
+//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)
+```
+
+<!-- unsupported block: 19 -->
+
+enableAutoTrack需要在主线程中调用，如果需要在work线程中初始化SDK，可参考下面的代码
+
+```
+**const **workerInstance = **new **worker.ThreadWorker("./workers/worker.ets");
+TDAnalytics.enableAutoTrack(**this**.context,
+  TDAutoTrackEventType.APP_START | TDAutoTrackEventType.APP_INSTALL | TDAutoTrackEventType.APP_END |
+  TDAutoTrackEventType.APP_VIEW_SCREEN | TDAutoTrackEventType.APP_CRASH |
+  TDAutoTrackEventType.APP_CLICK,
+  (command: string, params: Object, appId?: string) => {
+    //这里会将需要触发的自动采集事件回调出来，需要将消息发送到work线程去处理
+    workerInstance.postMessage({
+      type: command,
+      params: params
+    })
+  })
+```
+
+```
+**const **workerPort = worker.workerPort;
+
+workerPort.onmessage = (d: MessageEvents): void => {
+  **if **(d.data.type === 'track') {
+    TDAnalytics.track(d.data.params);
+  } **else if **(d.data.type === 'timeEvent') {
+    TDAnalytics.timeEvent(d.data.params);
+  } **else if **(d.data.type === 'flush') {
+    TDAnalytics.flush()
+  }
+}
+```
+
+### 三、详细介绍
+
+##### 3.1 安装事件
+
+APP 安装事件将会记录 APP 的实际安装，在 APP 启动时上报，事件触发时间是 APP 安装后首次启动的时间，APP 升级并不会触发安装事件，而删除重装后会上报安装事件。
+
+- 事件名：ta_app_install
+##### 3.2 启动事件
+
+APP 启动事件将会在用户开启 APP，或从后台唤醒 APP 时触发，详细的事件介绍如下：
+
+- 事件名：ta_app_start
+- 预置属性：`#resume_from_background`，布尔型，表示 APP 是用户开启还是从后台唤醒，取值为 true 表示从后台唤醒，false 为直接开启。
+- 通过ApplicationStateChangeCallback中的onApplicationForeground回调来触发
+##### 3.3 关闭事件
+
+APP 关闭事件将会在用户关闭 APP，或将 APP 调至后台时触发，详细的事件介绍如下：
+
+- 事件名：ta_app_end
+- 预置属性：`#duration`，数值型，表示该次 APP 访问（自启动至结束）的时长，单位是秒。
+- 通过ApplicationStateChangeCallback中的onApplicationBackground回调来触发
+##### 3.4 浏览页面事件
+
+APP 浏览页面事件会在用户浏览页面（`Ability`）时触发，详细的事件介绍如下：
+
+- 事件名：ta_app_view
+- 预置属性：
+`#screen_name`，字符串型，为`Ability`的简单类名
+
+##### 3.5 点击事件
+
+APP 控件点击事件将会在用户点击控件（view）时触发
+
+- 事件名：ta_app_click
+- 预置属性：
+`#screen_name`，字符串型，为控件所属`Activity`的包名.类名
+
+`#element_type`，字符串型，为控件的类型
+
+`#element_id`，字符串型，为控件的 ID
+
+##### 3.6 崩溃事件
+
+当 APP 出现未捕获异常时，会上报 APP 崩溃事件
+
+- 事件名：ta_app_crash
+- 预置属性：`#app_crashed_reason`，字符型，记录崩溃时的堆栈轨迹
+- 通过ErrorObserver的onUnhandledException来监听，暂不支持native的崩溃采集。

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//351/242/204/347/275/256/345/261/236/346/200/247.md

@@ -0,0 +1,286 @@
+---
+code: openharmony_sdk_preset_properties
+name: "预置属性"
+wikiToken: Y7OVwynlEiOxL1ktH4jcCODFnKc
+parentWikiToken: Ci0xwEVoxiX0GSkkVPLc7bZRnQf
+updateTime: 1766487536000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=openharmony_sdk_preset_properties
+---
+# 预置属性
+
+### 一、 所有事件带有的预置属性
+
+以下预置属性，是 OpenHarmony SDK 中所有事件（包括自动采集事件）都会带有的预置属性
+
+**属性名**
+
+**中文名**
+
+**属性类型**
+
+**采集时机**
+
+**说明**
+
+#ip
+
+IP 地址
+
+文本
+
+服务端采集
+
+用户的 IP 地址，AE 将以此获取用户的地理位置信息
+
+#country
+
+国家
+
+文本
+
+服务端采集
+
+用户所在国家，根据 IP 地址生成
+
+#country_code
+
+国家代码
+
+文本
+
+服务端采集
+
+用户所在国家的国家代码(ISO 3166-1 alpha-2，即两位大写英文字母)，根据 IP 地址生成
+
+#province
+
+省份
+
+文本
+
+服务端采集
+
+用户所在省份，根据 IP 地址生成
+
+#city
+
+城市
+
+文本
+
+服务端采集
+
+用户所在城市，根据 IP 地址生成
+
+#os_version
+
+操作系统版本
+
+文本
+
+初始化时采集一次
+
+iOS 11.2.2、Android 8.0.0 等
+
+#manufacturer
+
+设备制造商
+
+文本
+
+初始化时采集一次
+
+用户设备的制造商，如 Apple，vivo 等
+
+#os
+
+操作系统
+
+文本
+
+初始化时采集一次
+
+如 Android、iOS、HarmonyOS 等
+
+#device_id
+
+设备 ID
+
+文本
+
+初始化时采集一次
+
+用户的设备 ID，iOS 取用户的 IDFV 或 UUID，Android 取 androidID
+
+#screen_height
+
+屏幕高度
+
+数值
+
+初始化时采集一次
+
+用户设备的屏幕高度，如 1920 等
+
+#screen_width
+
+屏幕宽度
+
+数值
+
+初始化时采集一次
+
+用户设备的屏幕高度，如 1080 等
+
+#device_model
+
+设备型号
+
+文本
+
+初始化时采集一次
+
+用户设备的型号，如 iPhone 8 等
+
+#device_type
+
+设备类型
+
+文本
+
+初始化时采集一次
+
+设备类型，如 "Tablet"、"Phone"
+
+#app_version
+
+APP 版本
+
+文本
+
+初始化时采集一次
+
+您的 APP 的版本
+
+#bundle_id
+
+应用唯一标识
+
+文本
+
+初始化时采集一次
+
+应用包名或进程名
+
+#lib
+
+SDK 类型
+
+文本
+
+初始化时采集一次
+
+您接入 SDK 的类型，如 Android，iOS 等
+
+#lib_version
+
+SDK 版本
+
+文本
+
+初始化时采集一次
+
+您接入 SDK 的版本
+
+#network_type
+
+网络状态
+
+文本
+
+初始化时采集一次，网络状态变化时采集
+
+上传事件时的网络状态，如 WIFI、3G、4G 等
+
+#carrier
+
+网络运营商
+
+文本
+
+初始化时采集一次
+
+用户设备的网络运营商，如中国移动，中国电信等
+
+#zone_offset
+
+时区偏移
+
+数值
+
+事件发生时采集
+
+数据时间相对 UTC 时间的偏移小时数
+
+#install_time
+
+程序安装时间
+
+时间
+
+初始化时采集一次
+
+用户安装应用的时间，值来源于系统
+
+#system_language
+
+系统语言
+
+文本
+
+初始化时采集一次
+
+用户设备的系统语言(ISO 639-1，即两位小写英文字母)，如 zh, en 等
+
+### 二、获取预置属性
+
+可以调用 `getPresetProperties()` 方法获取预置属性。
+
+服务端埋点需要 App 端的一些预置属性时，可以通过此方法获取 App 端的预置属性，再传给服务端。
+
+```
+TDAnalytics.getPresetProperties()
+
+/**
+{
+    "#os": "HarmonyOS",
+    "#os_version": 10,
+    "#bundle_id": "com.example.tdharmonyosdemo",
+    "#install_time": "2023-10-19 18:46:00.105",
+    "#manufacturer": "HUAWEI",
+    "#device_model": "NOH-AN00",
+    "#device_type": "phone",
+    "#screen_width": 1344,
+    "#screen_height": 2772,
+    "#system_language": "zh-Hans",
+    "#carrier": "中国电信",
+    "#app_version": "1.0.1",
+    "#device_id": "9811b90b-ee24-45c1-950a-77ee0ffc7a1c",
+    "#zone_offset": 8
+}
+*/
+
+```
+
+### 三、关闭预置属性
+
+在某些场景下，出于合规、实际业务需求等的考量，您也许期望禁止某些预置属性的采集。您可以在SDK初始化的时候配置`disablePresetProperties` 参数，用于配置需要禁用采集的属性数组。示例代码如下：
+
+```
+**let **config = **new **TDConfig()
+config.appId = 'appId'
+config.serverUrl = 'url'
+config.disablePresetProperties =["#lib", "#lib_version", "#os", "#os_version", "#bundle_id", "#install_time", "#manufacturer", "#device_model",
+"#device_type", "#screen_width", "#screen_height","#system_language","#carrier","#app_version","#device_id","#network_type","#ip"]
+TDAnalytics.initWithConfig(context, config)
+```