ae-tracking 0.1.0

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//346/234/215/345/212/241/347/253/257-sdk/golang.md

@@ -0,0 +1,193 @@
+---
+code: golang_sdk_installation
+name: "Golang"
+wikiToken: LopRwvKpWiKdXdkB9YSck9ImnVf
+parentWikiToken: O3YxwgHGiiEnvYkHCcIcX51inkf
+updateTime: 1745310918000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=golang_sdk_installation
+---
+# Golang
+
+::: tip 提示
+
+ 在接入前, 请先阅读接入前准备。
+
+ :::
+
+**最新版本为**：v2.1.0
+
+**更新时间为**：2024-12-19
+
+**资源下载:**源代码
+
+::: warning 注意
+
+当前文档适用于 v2.0.0 及以后的版本，历史版本请参考 Go SDK 接入指南（V1）
+
+::: 
+
+### 一、集成SDK
+
+1. 我们提供两种方案集成SDK：
+方案一: 执行以下命令获取最新版 Golang SDK
+
+```
+# 获取 SDK
+go get github.com/ThinkingDataAnalytics/go-sdk/v2
+
+# 更新 SDK
+go get -u github.com/ThinkingDataAnalytics/go-sdk/v2
+```
+
+方案二: Module模式
+
+```
+//在代码文件开头引入thinkingdata
+import "github.com/ThinkingDataAnalytics/go-sdk/v2/src/thinkingdata"
+
+# 拉取最新SDK模块
+go mod tidy
+```
+
+1. 安装LogBus
+我们推荐使用SDK+LogBus的形式，完成服务端数据的采集上报.您可以参考以下文档完成Logbus的安装:LogBus使用指南 
+
+### 二、初始化
+
+以下是SDK初始化的示例代码:
+
+```
+// 创建 LogConfig 配置文件
+config := thinkingdata.TDLogConsumerConfig {
+    FileNamePrefix: "test_prefix", // log file prefix
+    Directory: "LOG_DIRECTORY", // 事件采集的文件路径
+}
+// 初始化 logConsumer
+consumer, _ := thinkingdata.NewLogConsumerWithConfig(config)
+// 创建 te 对象
+te := thinkingdata.New(consumer)
+```
+
+`LOG_DIRECTORY`为写入本地的文件夹地址。您只需将 LogBus 的监听文件夹地址设置为此处的地址，即可使用 LogBus 进行数据的监听上传
+
+### 三、常用功能
+
+为了保证访客 ID 与账号 ID 能够顺利进行绑定，如果您的游戏中会用到访客 ID 与账号 ID，我们极力建议您同时上传这两个 ID，否则将会出现账号无法匹配的情况，导致用户重复计算，具体的 ID 绑定规则可参考用户识别规则一章。
+
+#### 3.1 发送事件
+
+您可以调用`track`来上传事件，建议您根据先前梳理的文档来设置事件的属性以及发送信息的条件，以下是发送事件的示例代码:
+
+```
+accountId := "te_account_id"
+distinctId := "te_distinct_id"//accountId和distinctId不能全部为空
+properties := map[string]interface{}{
+   //设置用户的ip地址，TE系统会根据IP地址解析用户的地理位置信息
+   "#ip":       "123.123.123.123",
+   "channel":   "te",       // 字符串
+   "age":       1,          // 数字
+   "is_success": true,       // 布尔
+   "birthday":  time.Now(), // 时间
+   // 对象
+   "object": map[string]interface{}{
+      "key": "value",
+   }, 
+   //对象组
+   "objectArr": []interface{}{
+      map[string]interface{}{
+         "key": "value",
+      },
+   },
+   "arr":     []string{"value"}, // 数组
+}
+// track事件
+err := te.Track(accountId, distinctId, "payment", properties)
+```
+
+- 事件的名称是字符串类型，只能以字母开头，可包含数字，字母和下划线 "_"，长度最大为 50 个字符。
+- Key 为该属性的名称，为字符串类型，规定只能以字母开头，包含数字，字母和下划线 "_"，长度最大为 50 个字符，对字母大小写不敏感,TE会统一转化为小写字母
+- Value 为该属性的值，支持字符串、数字、布尔、时间、对象、对象组、数组
+<!-- unsupported block: 34 -->
+
+**用户属性的要求与事件属性保持一致**
+
+#### 3.2 设置用户属性
+
+对于一般的用户属性，您可以调用`UserSet`来进行设置，使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例：
+
+```
+// 此时username为TA
+err := te.UserSet("accountId", "distinctId", map[string]interface{}{
+   "user_name": "TA",
+})
+// 此时username为TE
+err = te.UserSet("accountId", "distinctId", map[string]interface{}{
+   "user_name": "TE",
+})
+```
+
+#### 3.3 数据上报
+
+使用 TDLogConsumer 时，SDK 会实时的将采集到的数据写入磁盘。
+
+`TDAnalytics` 对象的 `Flush()` 方法内部是将文件系统中默认的内存缓存实时同步到磁盘。一般不需要手动调用 `Flush()` 方法。
+
+#### 3.4 关闭SDK
+
+```
+// 关闭并退出 SDK
+te.Close()
+```
+
+<!-- unsupported block: 34 -->
+
+关闭并退出 sdk，请在关闭服务器前调用本接口，以避免缓存内的数据丢失
+
+### 四、最佳实践
+
+以下示例代码包含以上所有操作，我们推荐按照如下步骤使用:
+
+```
+// 创建 LogConfig 配置文件
+config := thinkingdata.TDLogConsumerConfig {
+    Directory: "./log_directory", // 事件采集的文件路径
+}
+// 初始化 logConsumer
+consumer, _ := thinkingdata.NewLogConsumerWithConfig(config)
+// 创建 te 对象
+te := thinkingdata.New(consumer)
+
+accountId := "te_account_id"
+distinctId := "te_distinct_id"//accountId和distinctId不能全部为空
+properties := map[string]interface{}{
+    //设置用户的ip地址，TE系统会根据IP地址解析用户的地理位置信息
+    "#ip":       "123.123.123.123",
+    "channel":   "te",       // 字符串
+    "age":       1,          // 数字
+    "isSuccess": true,       // 布尔
+    "birthday":  time.Now(), // 时间
+    // 对象
+    "object": map[string]interface{}{
+       "key": "value",
+    },
+    //对象组
+    "objectArr": []interface{}{
+       map[string]interface{}{
+          "key": "value",
+       },
+    },
+    "arr":     []string{"value"}, // 数组
+}
+// 上传事件
+err := te.Track(accountId, distinctId, "payment", properties)
+if err != nil {
+    fmt.Println(err)
+}
+//设置用户属性
+err = te.UserSet("accountId", "distinctId", map[string]interface{}{
+    "user_name": "TE",
+})
+if err != nil {
+    fmt.Println(err)
+}
+```

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//346/234/215/345/212/241/347/253/257-sdk/java//346/233/264/346/226/260/346/227/245/345/277/227.md

@@ -0,0 +1,138 @@
+---
+code: java_sdk_release_note
+name: "更新日志"
+wikiToken: SlDKwJ91fiRb3cky4xScql7Sn0b
+parentWikiToken: SMGDw5xMCiGynekTD0ccp9OJnQd
+updateTime: 1767774082000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=java_sdk_release_note
+---
+# 更新日志
+
+### v3.0.4-beta.1
+
+**更新时间：2026/01/07**
+
+**更新内容：**
+
+- 不再支持 fastjson1
+- 不再支持 lzo、lz4 加密
+### v3.0.2
+
+**更新时间：2025/01/15**
+
+**更新内容：**
+
+- 升级为正式版
+### v3.0.2-beta.2
+
+**更新时间：2024/08/09**
+
+**更新内容：**
+
+- 提升 SDK 稳定性
+### v3.0.2-beta.1
+
+**更新时间：2024/06/06**
+
+**更新内容：**
+
+- 全部替换为 fastjson2 的 api
+### v3.0.1
+
+**更新时间：2024/05/21**
+
+**更新内容：**
+
+- Debug 模式验证 json 数据的完整性
+### v3.0.0
+
+**更新时间：2023/11/29**
+
+**更新内容：** 
+
+- 升级为正式版
+### v3.0.0-beta.1
+
+**更新时间：2023/10/07**
+
+**更新内容：** 
+
+- 启用新的 API，旧的 API 标记为过期
+- Package name 修改为 cn.thinkingdata.analytics
+### v2.1.2
+
+**更新时间：2023/09/19**
+
+**更新内容：** 
+
+- 升级为正式版
+### v2.1.2-beta.2
+
+**更新时间：2023/04/24**
+
+**更新内容：** 
+
+- 整理测试代码结构
+### v2.1.1
+
+**更新时间：2022/11/15**
+
+**更新内容：** 
+
+- 支持 Debug 模式
+- 升级 fastjson 到 1.2.83
+### v2.1.0 
+
+**更新时间: 2022/08/08**
+
+**更新内容：**
+
+- LoggerConsumer,BatchConsumer模式下，默认不校验属性的正确性 
+- 新增日志开关 
+- 代码优化 
+### v2.0.1 
+
+**更新时间: 2022/05/10**
+
+**更新内容：**
+
+- 支持动态公共属性设置 setDynamicSuperPropertiesTracker 
+- 支持去重用户属性追加 user_unique_append 
+- 支持首次事件上报 track_first 
+### v1.9.1 
+
+**更新时间****：2021/12/20**
+
+**更新内容：**
+
+- 修复连接池的连接异常关闭的问题 
+### v1.9.0 
+
+**更新时间****：****2021/12/03**
+
+**更新内容：**
+
+- 增加支持上传object和object list数据 
+### v1.8.2 
+
+**更新时间: 2021/08/31**
+
+**更新内容：**
+
+- 修复一处链接异常关闭的错误
+### v1.8.1
+
+**更新时间: 2021/06/17**
+
+**更新内容：**
+
+- 更新httpclient版本
+- 增加异常日志
+### v1.8.0 
+
+**更新时间: 2021/03/22**
+
+**更新内容：**
+
+- 新增缓存池，用于存储因网络原因发送的数据，在后续发送时重试
+- LoggerConsumer增加支持#app_id属性

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//346/234/215/345/212/241/347/253/257-sdk/java//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,52 @@
+---
+code: java_sdk_debug
+name: "实时调试"
+wikiToken: KgdswDtrViSyzTkNzSBcVLiTnrb
+parentWikiToken: YWaKwdZQ1irX0gkvF5pcq6HanBg
+updateTime: 1745309854000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=java_sdk_debug
+---
+# 实时调试
+
+::: warning 注意
+
+SDK Debug 模式仅供接入调试时使用，严禁应用在生产环境。
+
+:::
+
+在SDK接入过程中，您可以通过查看SDK在IDE控制台中的日志或者使用TE的Debug功能，进行实时调试。
+
+### 一、打印SDK日志
+
+```
+TDAnalytics.*enableLog*(true);
+```
+
+### 二、开启 Debug 模式
+
+开启Debug模式需要如下两步操作:
+
+1. 使用TDDebugConsumer
+以下使用TDDebugConsumer的示例代码:
+
+```
+/*
+TDDebugConsumer:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
+ */
+TDAnalytics te = new TDAnalytics(new TDDebugConsumer("serverUrl","appId","deviceId"));
+//设置事件属性
+Map<String,Object> properties = new HashMap<String,Object>();
+properties.put("name", "shoes");
+try {
+     te.track("account_id","distinct_id","payment",properties);
+} catch (Exception e) {
+     System.out.println("except:"+e);
+}
+```
+
+1. TE后台添加Debug设备
+为了避免 Debug 模式在生产环境上线，规定只有指定的设备才能开启 Debug 模式。只有在客户端开启了 Debug 模式，并且设备 ID 在 AE 后台的"埋点管理"页的"Debug 数据"板块中配置了的设备才能开启 Debug 模式。
+
+<!-- unsupported block: 34 -->
+
+Debug 模式可能会影响数据采集质量和 App 的稳定性，只用于集成阶段数据验证，不要在线上环境使用。

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//346/234/215/345/212/241/347/253/257-sdk/java//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,75 @@
+---
+code: java_sdk_preset_properties
+name: "预置属性"
+wikiToken: BJvlw4Iu5iSrY3kvQEscqG3enyc
+parentWikiToken: YWaKwdZQ1irX0gkvF5pcq6HanBg
+updateTime: 1745309855000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=java_sdk_preset_properties
+---
+# 预置属性
+
+以下预置属性，是 Java SDK 中所有事件都会带有的预置属性。
+
+**属性名**
+
+**中文名**
+
+**属性类型**
+
+**说明**
+
+#ip
+
+IP 地址
+
+文本
+
+用户的 IP 地址，需要进行手动设置，AE 将以此获取用户的地理位置信息
+
+#country
+
+国家
+
+文本
+
+用户所在国家，根据 IP 地址生成
+
+#country_code
+
+国家代码
+
+文本
+
+用户所在国家的国家代码(ISO 3166-1 alpha-2，即两位大写英文字母)，根据 IP 地址生成
+
+#province
+
+省份
+
+文本
+
+用户所在省份，根据 IP 地址生成
+
+#city
+
+城市
+
+文本
+
+用户所在城市，根据 IP 地址生成
+
+#lib
+
+SDK 类型
+
+文本
+
+您接入 SDK 的类型，如 Java 等
+
+#lib_version
+
+SDK 版本
+
+文本
+
+您接入 SDK 的版本