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

@@ -0,0 +1,239 @@
+---
+code: javascript_sdk_release_note
+name: "更新日志"
+wikiToken: PC2RwDyl4irEV7kEdIyc5rosnod
+parentWikiToken: Ian8wU157i7or8kW1ORccuT8nWe
+updateTime: 1767751517000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=javascript_sdk_release_note
+---
+# 更新日志
+
+### v2.3.1
+
+**更新时间: 2026/01/07 **下载
+
+**更新内容:**
+
+- 新增getSDKVersion方法
+### v2.3.0
+
+**更新时间: 2025/12/23 **下载
+
+**更新内容:**
+
+- trackLink支持动态添加按钮
+### v2.2.1
+
+**更新时间: 2025/11/11 **下载
+
+**更新内容:**
+
+- 修复已知问题
+### v2.2.0
+
+**更新时间: 2025/11/04 **下载
+
+**更新内容:**
+
+- Batch模式增加UUID
+- 初始化时可以设置账号，访客，公共属性
+### v2.1.3
+
+**更新时间: 2025/09/23 **下载
+
+**更新内容:**
+
+- 修复已知问题
+### v2.1.2
+
+**更新时间: 2025/07/22 **下载
+
+**更新内容:**
+
+- 自动采集事件支持动态公共属性
+### v2.1.1
+
+**更新时间: 2025/02/24**** **下载
+
+**更新内容:**
+
+- 修复logout失效的问题
+### v2.1.0
+
+**更新时间: 2024/12/25**下载
+
+**更新内容:**
+
+- 修复Batch模式数据丢失问题
+- 修复系统语言在Android和iOS获取失败的问题
+- 支持预置属性屏蔽功能
+- 自动采集单页面中页面浏览事件
+- 支持yarn、pnpm方式集成
+- 修复表情乱码问题
+- 单页面中事件自动采
+- 支持禁用事件功能
+### v2.0.4
+
+**更新时间: 2024/09/12**下载
+
+**更新内容:**
+
+- 支持Flutter和ReactNative打通功能
+- 已知问题修复
+### v2.0.2
+
+**更新时间: 2024/07/17**下载
+
+**更新内容:**
+
+- 修复0时区不生效的问题
+### v2.0.1
+
+**更新时间: 2024/05/15**下载
+
+**更新内容:**
+
+- 修复获取系统语言预置属性问题
+- Batch模式发送数据重构
+### v2.0.0 
+
+**更新时间: 2023/11/08**下载
+
+**更新内容:**
+
+- 代码规范、注释规范
+- 增加image发送方式屏蔽控制台警告
+### v1.6.2
+
+**更新时间: 202****3****/04/13 **下载
+
+**更新内容:**
+
+- 代码规范
+- 已知bug修复
+### v1.6.1
+
+**更新时间: 2022/09/29**
+
+**更新内容:**
+
+- 支持跨域名页面账号体系的自动打通
+- 支持数据批量发送
+- 新增预置属性#ua、#utm、#system_language
+### v1.6.0 
+
+**更新时间: 2022/06/17**
+
+**更新内容:**
+
+- 增加ajax请求失败重试 
+- 增加ta_app_show和ta_app_hide事件 
+### v1.5.0 
+
+**更新时间: 2022/06/14**
+
+**更新内容:**
+
+- 支持数据传输加密 
+- 支持userUniqAppend 
+- 优化数据停止/暂停上报接口 
+- 自动采集事件支持自定义属性 
+- 支持自定义时区 
+- 用户使用时长超长，限制最大24小时 
+### v1.4.3
+
+**更新时间: 2021/11/19**
+
+**更新内容:**
+
+- 优化设置静态公共属性功能 
+- 代码优化 
+### v1.4.2
+
+**更新时间: 2021/08/23**
+
+**更新内容:**
+
+- 新增enableTracking接口
+- 新增optOutTracking接口
+- 新增optInTracking接口
+### v1.4.1
+
+**更新时间: 2021/06/24**
+
+**更新内容:**
+
+- 支持预置属性获取
+- 优化上报地址处理逻辑
+### v1.4.0 
+
+**更新时间: 2020/08/**
+
+**更新内容:**
+
+- 支持首次事件, 允许传入自定义的 ID 校验是否首次上报
+- 支持可更新、可重写的事件
+- 支持 DEBUG 模式，通过后台校验数据格式
+### v1.3.0 
+
+**更新时间: 2020/02/10**
+
+**更新内容:**
+
+- 支持 Array 类型
+- 新增 userAppend 接口
+- 去除本地数据格式校验
+### v1.2.0 
+
+**更新时间: 2019/10/22**
+
+**更新内容:**
+
+- 新增 userUnset 接口，可用于清空一个用户属性
+- 新增预置属性 #zone_offset，单位为小时。 默认情况下会将本地时区的偏移上报到服务端，该时间偏移会受夏令时影响。满足如下公式： 
+```
+utc_time + #zone_offset = #event_time
+```
+
+### v1.1.0 
+
+**更新时间: 2019/07/23**
+
+**更新内容:**
+
+- 默认使用 `localStorage` 缓存 `#device id`, `#distinct id`, `#account id` 等需要持久化的数据
+- 支持多实例: 多个实例之间原则上只有 `#device id` 是共享的. 其他的所有属性和配置都不共享，可以分别向不同的项目中上报各自的数据
+- 增加接口： 
+- `getDeviceId()`
+- `getDistinctId()`
+- `getPageProperty()`
+- `setSuperProperties(superProperties)`
+- `unsetSuperProperty(propertyName)`
+- `clearSuperProperties()`
+- `getSuperProperties()`
+- `setDynamicSuperProperties(function)`
+- `timeEvent(eventName)`
+- 增加属性合法性校验逻辑
+- 自动采集点击事件优化: 
+- 增加 `#element_type` 属性, 传入 `nodeName`
+- 增加页面属性，类似于`ta_pageview`
+- 优化自动采集逻辑，修复已知 BUG
+- 初始化参数中增加 `loaded` 参数, 可以传入回调函数。当初始化完成时，会回调此函数.
+- 其他优化： 
+- 修复 device id 未持久化 bug
+- 优化初始化逻辑
+- 预置属性增加 #os 采集 ua 中的操作系统信息
+### v1.0.7 
+
+**更新时间: 2019/05/31**
+
+**更新内容:**
+
+- 修复兼容性 Bug
+### v1.0.6 
+
+**更新时间: 2019/05/10**
+
+**更新内容:**
+
+- 支持 `identify` 接口

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/javascript//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,55 @@
+---
+code: javascript_sdk_multi_appid
+name: "多实例"
+wikiToken: Bex4w1r3EillTpksN2GcAooynVg
+parentWikiToken: XB4ywbB3LiMvFWkDUVDcRY0pnlm
+updateTime: 1763108982000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=javascript_sdk_multi_appid
+---
+# 多实例
+
+可以通过调用 `initInstance` 方法，可以创建子实例对象。其参数为子实例名称。之后您可以通过该名称调用子实例的接口。
+
+```
+// 创建一个名字为 newInstance 的实例
+ta.initInstance("newInstance");
+// 为子实例设置 distinct_id 并发送 test_event 的事件
+ta.newInstance.setDistinctId("new_distinct_id");
+ta.newInstance.track("test_event");
+```
+
+默认情况下，子实例与主实例采用相同的配置（`appId`, `serverUrl`等）。并且默认情况下，子实例不会开启本地缓存。
+
+如果需要为子实例单独配置参数，可以在初始化时传入配置信息，通过在配置信息中传入不同的 `appId` 值，可以达到向不同项目上报数据的功能:
+
+```
+// 定义子实例的配置参数
+var param = {
+  appId: "debug-appid",
+  serverUrl: "ANOTHER_SERVER_URL",
+  persistenceEnabled: true, // 开启子实例的本地缓存，子实例本地缓存根据子实例名称 name 区分
+  send_method: "image",
+  showLog: true
+};
+
+// 初始化子实例
+ta.initInstance("anotherInstance", param);
+
+//往主实例项目中上报数据
+ta.track("Event");
+
+//往子实例项目中上报数据
+ta.anotherInstance.track("Event");
+```
+
+主实例与子实例的 ID 体系不互通，公共属性不互通，可以单独为每个实例设置用户 ID，以下案例通过这一特性，为邀请好友这一事件的邀请者和被邀请者，分别上报了邀请成功和被邀请事件
+
+```
+//主实例是被邀请的新用户，子实例是邀请者
+ta.login("invitee");
+ta.anotherInstance.login("inviter");
+//新用户触发被邀请事件
+ta.track("be_invited");
+//邀请者触发邀请新用户事件
+ta.anotherInstance.track("invite_new_user");
+```

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/javascript//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: javascript_sdk_debug
+name: "实时调试"
+wikiToken: KeVkwOjFniin7jkfrQycAWIHnKe
+parentWikiToken: XB4ywbB3LiMvFWkDUVDcRY0pnlm
+updateTime: 1745310870000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=javascript_sdk_debug
+---
+# 实时调试
+
+在接入SDK期间，您可以通过查看SDK在控制台中的日志或者使用 AE 的Debug功能，进行实时调试。
+
+### 一、打印SDK日志
+
+可以在SDK初始化时设置showLog为true,打开SDK日志开关，打开后将会在浏览器控制台打印上报的数据。
+
+```
+var config = {
+    appId: "xxx",
+    serverUrl: "xxx",
+    showLog:true
+};
+```
+
+### 二、 Debug 模式
+
+开启Debug模式需要如下两步操作:
+
+1. 客户端开启Debug模式
+可以在SDK初始化时设置时开启Debug模式:
+
+```
+var config = {
+    appId: "xxx",
+    serverUrl: "xxx",
+    /*normal模式:数据会存入缓存，并依据一定的缓存策略上报,默认为NORMAL模式；建议在线上环境使用
+      debug模式:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
+      debug_only模式:只对数据做校验，不会入库；不建议在线上环境使用
+    */
+    mode:"debug"
+};
+```
+
+1. AE 后台添加Debug设备
+为了避免 Debug 模式在生产环境上线，规定只有指定的设备才能开启 Debug 模式。只有在客户端开启了 Debug 模式，并且设备 ID 在 AE 后台的"埋点管理"页的"Debug 数据"板块中配置了的设备才能开启 Debug 模式。
+
+设备 ID 可以通过以下三种方式获取：
+
+- AE 平台中事件数据中的 #device_id 属性
+- 客户端日志：SDK 初始化完成后会打印设备 DeviceId
+- 通过实例接口调用：获取设备ID
+<!-- unsupported block: 34 -->
+
+Debug 模式可能会影响数据采集质量和应用的稳定性，只用于集成阶段数据验证，不要在线上环境使用。

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/javascript//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,113 @@
+---
+code: javascript_sdk_autotrack
+name: "自动采集"
+wikiToken: M0bfwXKoSihigKk8UJecmbu6nWc
+parentWikiToken: XB4ywbB3LiMvFWkDUVDcRY0pnlm
+updateTime: 1763108735000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=javascript_sdk_autotrack
+---
+# 自动采集
+
+### 一、监控 HTML 元素点击事件
+
+如果您想要追踪页面上元素的点击事件，可以使用 `trackLink` 对 HTML 元素进行批量监控：
+
+```
+ta.trackLink(
+  {
+    tag: ["a", "button"], //HTML标签
+    class: ["class1", "class2"], //自定义的Class名称
+    id: ["id1", "id2"] //自定义的ID名称
+  }, //监控元素的规则
+  "click", //追踪事件的名称
+  {
+    production: "产品名",
+    name: "元素标识名"
+  } //事件的属性
+);
+```
+
+- 第一个参数是您需要监控的元素，类型是 JSON 对象，支持根据 HTML 标签、Class 以及 id 追踪需要监控的页面元素。对于满足规则的元素，会通过事件监听器的方式监控元素的点击事件，当监听元素被点击时，将会上报一个事件，事件名和事件属性取后续两个参数的值
+- 第二个参数是事件的名称，为 `string` 类型,必须填写
+- 第三个参数是事件的属性，类型是 JSON 对象，如果没有需要上报的属性，可传入空 JSON
+- 事件属性 `'name'`为元素的标识，如果参数三中没有设置事件属性 `'name'`，我们将会根据被监控元素的属性值作为元素标识。取值优先级如下:
+1.取值元素的自定义属性 `'td-name'`
+
+2.元素的 `innerHTML`
+
+3.元素的 value 
+
+4.如果都没有取到则传 `'未获取标识'`.
+
+<!-- unsupported block: 34 -->
+
+trackLink在被调用时会为符合规则的元素设置事件监听器.在调用接口后元素的标识发生变化，或者新生成了符合规则的元素，监听器上报的事件不会做出相应的改变。如果需要监控新生成元素，可在元素生成后调用trackLink。
+
+### 二、页面显示和隐藏事件
+
+- 开启方式
+- 从v1.6.0版本开始，增加`ta_page_show` 和 `ta_page_hide` 事件。
+- SDK默认是不采集这些事件，可以通过SDK初始化的config来配置。
+```
+var config = {
+    appId: 'xxx',
+    serverUrl: 'xxx',
+    autoTrack: {
+         //开启ta_page_show事件
+         pageShow: true,
+         //开启ta_page_hide事件
+         pageHide: true,
+         properties: { // 自动采集自定义属性
+             staticKey: 'staticValue'
+         }, 
+         callback: (eventType) => { // 自动采集回调
+              if (eventType === 'pageShow') {
+                  return { appShowKey: 'appShowValue' };
+              } else if (eventType === 'pageHide') {
+                  return { appHideKey: 'appHideValue' };
+              } else {
+                  return {};
+              }
+         }
+    }
+};
+```
+
+- 从v2.1.2版本开始，页面显示和隐藏事件支持自动采集自定义属性以及自动采集回调。
+- `ta_page_hide`事件会将页面本次展示到关闭的时长放到属性`#duration`中。
+- 如果需要第一个ta_page_show带上用户相关的信息，可以在初始化的时候传入。
+```
+var config = {
+    appId: 'appId',
+    serverUrl: 'serverUrl',
+    send_method: 'ajax',
+    accountId: 'xx',//设置账号ID
+    distinctId: 'xx',//设置访客ID
+    superProperties: {//设置静态公共属性
+        super1: 'xx',
+        super2: 'xx'
+    }
+};
+```
+
+### 三、页面浏览事件
+
+AE 提供自动采集页面浏览事件的接口。您只需使用以下代码，JS SDK 将会自动上传用户浏览页面的事件，事件名称为ta_pageview：
+
+```
+ta.quick("autoTrack");
+```
+
+从v1.6.0版本开始，可以支持自定义属性。
+
+```
+ta.quick('autoTrack', {
+    name: 'test_name',
+    time: new Date(),
+    pro: [1, 2, 3, 4],
+})
+```
+
+<!-- unsupported block: 34 -->
+
+该接口在调用时，会立即上报一次页面浏览事件