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

@@ -0,0 +1,108 @@
+---
+code: cpp_server_sdk_release_note
+name: "更新日志"
+wikiToken: U1zKwjnJUi7PYBksAWwcbn0cnMc
+parentWikiToken: D4KBwgaZjiQA3Nklwdtc9z1EnGf
+updateTime: 1745309928000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cpp_server_sdk_release_note
+---
+# 更新日志
+
+### v2.0.0
+
+**更新时间: 2023/11/30**
+
+**更新内容：**
+
+- 发布正式版本
+### v2.0.0-beta.1
+
+**更新时间: 2023/10/08**
+
+**更新内容：**
+
+- 启用新的 API，类名添加 TD 前缀
+- 不兼容旧版 SDK，需手动修改类名以及命名空间
+- 添加日志打印类
+### v1.2.8-beta.2
+
+**更新时间: 2023/06/02**
+
+**更新内容：**
+
+- Bugfix: 迭代器添加边缘值检测
+### v1.2.8-beta.1
+
+**更新时间: 2023/05/30**
+
+**更新内容：**
+
+- 提升采集性能
+### v1.2.7
+
+**更新时间: 2023/04/07**
+
+**更新内容：**
+
+- 提升平台兼容性
+- 更新 uuid 算法
+### v1.2.6
+
+**更新时间: 2023/03/14**
+
+**更新内容：**
+
+- 优化SDK代码
+### v1.2.5
+
+**更新时间: 2023/02/24**
+
+**更新内容：**
+
+- 优化SDK代码
+### v1.2.4
+
+**更新时间: 2023/02/21**
+
+**更新内容：**
+
+- 修复平台兼容性问题
+- 优化SDK代码
+### v1.2.3
+
+**更新时间: 2023/02/16**
+
+**更新内容：**
+
+- 优化SDK代码
+### v1.2.2
+
+**更新时间: 2023/02/05**
+
+**更新内容：**
+
+- 修复平台兼容性问题
+- 优化SDK代码
+### v1.2.1
+
+**更新时间: 2023/01/11**
+
+**更新内容：**
+
+- Bugfix: bufferSize 引起的上报延迟问题
+### v1.2.0 
+
+**更新时间: 2022/11/01**
+
+**更新内容：**
+
+- 支持debug consumer 
+- 支持batch consumer
+### v1.0.0 
+
+**更新时间: 2022/05/20**
+
+**更新内容：**
+
+- 支持debug_consumer 
+- 支持log_consumer

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

@@ -0,0 +1,114 @@
+---
+code: c_sdk_release_note
+name: "更新日志"
+wikiToken: VFNgwQb5riW62skImHScBrxHn0c
+parentWikiToken: SLlQwuOYRifeDVkRAxTc08pVnMg
+updateTime: 1745309871000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=c_sdk_release_note
+---
+# 更新日志
+
+### v2.0.0
+
+**更新时间: 2023/11/30**
+
+**更新内容：**
+
+- 升级为正式版
+### v2.0.0-beta.1
+
+**更新时间: 2023/10/08**
+
+**更新内容：**
+
+- 启用新的 API，函数采用 td_ 前缀标识
+- 不直接兼容旧版 SDK，提供桥接文件对旧版项目进行兼容
+- 新增日志开关
+### v1.3.7-beta.2
+
+**更新时间: 2023/06/14**
+
+**更新内容：**
+
+- Bugfix: 属性添加空数组时报错
+### v1.3.7-beta.1
+
+**更新时间: 2023/04/24 ****下载**
+
+**更新内容：**
+
+- 提升兼容性
+- 支持 Debug 模式
+- 修改 CMakeLists.txt 编写方式
+### v1.3.6 
+
+**更新时间: 2022/06/22**
+
+**更新内容：**
+
+- 提升稳定性 
+### v1.3.5 
+
+**更新时间: 2022/05/16**
+
+**更新内容：**
+
+- 支持debug_consumer 
+- 支持async_batch_consumer 
+- 新增ta_user_uniq_append方法 
+### v1.3.4
+
+**更新时间: 2022/03/03**
+
+**更新内容：**
+
+- 支持复杂数据类型 
+### v1.3.3
+
+**更新时间: 2022/02/08**
+
+**更新内容：**
+
+- 修复 snprintf 可能导致的重名问题 
+### v1.3.2
+
+**更新时间: 2021/11/23**
+
+**更新内容：**
+
+- 优化 windows 平台里的 snprintf 方法 
+### v1.3.1
+
+**更新时间: 2021/11/10**
+
+**更新内容：**
+
+- malloc失败时不再直接exit 
+### v1.3.0
+
+**更新时间: 2021/10/13**
+
+**更新内容：**
+
+- 增加支持batch consumer 
+### v1.2.3
+
+**更新时间: 2021/09/23**
+
+**更新内容：**
+
+- 修复#first_check_id无法正常处理的问题 
+### v1.2.2
+
+**更新时间: 2021/07/01**
+
+**更新内容：**
+
+- 适配windows环境
+### v1.2.1 
+
+**更新时间: 2021/06/09**
+
+**更新内容：**
+
+- 不再使用stdbool库

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/c//350/277/233/351/230/266/346/214/207/345/215/227//345/256/236/346/227/266/350/260/203/350/257/225-LEb9wx.md

@@ -0,0 +1,46 @@
+---
+code: cpp_server_sdk_debug
+name: "实时调试"
+wikiToken: LEb9wxLpRikCsskAnMJcLdqTn7u
+parentWikiToken: Jc1dwkLMQig05LkYr3ecVw4knuz
+updateTime: 1745309926000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cpp_server_sdk_debug
+---
+# 实时调试
+
+::: warning 注意
+
+SDK Debug 模式仅供接入调试时使用，严禁应用在生产环境。
+
+:::
+
+#### 开启日志打印
+
+```
+TDLog::enable = true;
+```
+
+#### 使用 TDDebugConsumer
+
+在SDK接入过程中，您可以通过使用TE的Debug功能，进行实时调试。使用Debug功能需要如下两步操作:
+
+1. 使用TDDebugConsumer
+以下使用TDDebugConsumer的示例代码:
+
+```
+string deviceId = "123456789";
+TDDebugConsumer debugConsumer("appId", "serverUrl", "", deviceId);
+TDAnalytics te(debugConsumer);
+
+TDPropertiesNode event_properties;
+event_properties.SetString("name", "value");
+// track事件
+te.track("accountId", "distinctId", "eventName", event_properties);
+```
+
+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/c//350/277/233/351/230/266/346/214/207/345/215/227//345/256/236/346/227/266/350/260/203/350/257/225-TfR3wg.md

@@ -0,0 +1,46 @@
+---
+code: csharp_sdk_debug
+name: "实时调试"
+wikiToken: TfR3wgSBWiiQNkkEjZYcqtm4nzd
+parentWikiToken: YGuuwcqPEi07zxkBBPScb6aJneh
+updateTime: 1745309875000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=csharp_sdk_debug
+---
+# 实时调试
+
+::: warning 注意
+
+SDK Debug 模式仅供接入调试时使用，严禁应用在生产环境。
+
+:::
+
+### 开启日志打印
+
+```
+TDLog.Enable = true;
+```
+
+### 使用TDDebugConsumer
+
+在SDK接入过程中，您可以通过使用TE的Debug功能，进行实时调试。使用Debug功能需要如下两步操作:
+
+1. 使用TDDebugConsumer
+以下使用TDDebugConsumer的示例代码:
+
+```
+/*
+DebugConsumer:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
+ */
+TDAnalytics te = new(new TDDebugConsumer("serverUrl", "appId", false, deviceId: "123456789"));
+Dictionary<string, object> properties= new Dictionary<string, object>();
+properties.Add("name", "test");
+//上报带有自定义属性的事件数据，同样account_id 和 distinct_id 必须至少设置其中一个
+te.Track("accountId", "distinctId", "Payment", properties);
+```
+
+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/c//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,93 @@
+---
+code: c_sdk_debug
+name: "实时调试"
+wikiToken: XNdhwqAY8izwXOkx8UicSgIcnDf
+parentWikiToken: TDQVw9hTRi2KYjkieoScuelXnIh
+updateTime: 1745309868000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=c_sdk_debug
+---
+# 实时调试
+
+::: warning 注意
+
+SDK Debug 模式仅供接入调试时使用，严禁应用在生产环境。
+
+:::
+
+### 开启日志打印
+
+```
+td_enableLog(1);
+```
+
+### 使用 DebugConsumer
+
+在SDK接入过程中，您可以通过使用TE的Debug功能，进行实时调试。使用Debug功能需要如下两步操作:
+
+1. 使用DebugConsumer
+- 打包 .a 文件，包含 debugConsumer 的功能，`CMakeLists.txt` 修改示例如下：
+```
+# Debug Library: debug consumer
+if(WIN32)
+    add_compile_definitions(USE_WIN)
+    set(CMAKE_C_FLAGS "-std=c99 -pedantic-errors -m64")
+else()
+    add_compile_definitions(USE_POSIX)
+    set(CMAKE_C_FLAGS "-std=c99")
+endif()
+SET(TE_LIB_NAME thinkingDataDebug)
+add_library(${TE_LIB_NAME} src/thinkingdata.c src/td_json.c src/td_list.c src/td_util.c src/td_debug_consumer.c src/td_http_client.c)
+if(WIN32)
+    add_compile_definitions(BUILDING_LIBCURL)
+    include_directories(thirdparty/pcre/include thirdparty/curl/include)
+    link_directories(thirdparty/pcre/lib thirdparty/curl/lib)
+    target_link_libraries(${TE_LIB_NAME} pcre_x64 libcurl)
+else()
+    target_link_libraries(${TE_LIB_NAME} curl)
+endif()
+```
+
+- 以下使用DebugConsumer的示例代码:
+```
+struct TDAnalytics* ta = NULL;
+struct TDConsumer* consumer = NULL;
+/*
+ * DebugConsumer:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
+ */
+TDConfig *config = td_init_config();
+// debug_mode,0入库，否则不入库
+TD_ASSERT(*TD_OK *== td_add_int("debug_mode", 0, config));
+// AE 后台测试设备的id: 123456789
+TD_ASSERT(*TD_OK *== td_add_string("device_id", "123456789", strlen("123456789"), config));
+// 配置appid和url
+char* appid = "APPID";
+char* serverURL = "SERVER_URL";
+TD_ASSERT(*TD_OK *== td_add_string("push_url", serverURL, strlen(serverURL), config));
+TD_ASSERT(*TD_OK *== td_add_string("appid", appid, strlen(appid), config));
+
+//生成SDK实例
+if (*TD_OK *!= td_init_consumer(&consumer, config)) {
+    fprintf(stderr, "Failed to initialize the consumer.");
+    return 1;
+}
+td_free_properties(config);
+if (*TD_OK *!= td_init(consumer, &ta)) {
+    fprintf(stderr, "Failed to initialize the SDK.");
+    return 1;
+}
+
+// 生成自定义属性
+TDProperties *properties = td_init_properties();
+// 添加设备ID属性,设备ID值为td_device_id
+TD_ASSERT(*TD_OK *== td_add_string("#device_id", "td_device_id", strlen("td_device_id"), properties));
+//上报带有自定义属性的事件数据，同样account_id 和 distinct_id 必须至少设置其中一个
+TD_ASSERT(*TD_OK *== td_track("account_id", "distinct_id", "test", properties, ta));
+td_free_properties(properties);
+```
+
+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/c//350/277/233/351/230/266/346/214/207/345/215/227//351/242/204/347/275/256/345/261/236/346/200/247-U1Qvwk.md

@@ -0,0 +1,75 @@
+---
+code: cpp_server_sdk_preset_properties
+name: "预置属性"
+wikiToken: U1QvwkKFQi9WbbkvWYPcvr6Wnec
+parentWikiToken: Jc1dwkLMQig05LkYr3ecVw4knuz
+updateTime: 1745309927000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cpp_server_sdk_preset_properties
+---
+# 预置属性
+
+以下预置属性，是 C++ 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 的版本

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/c//350/277/233/351/230/266/346/214/207/345/215/227//351/242/204/347/275/256/345/261/236/346/200/247-X08Fw7.md

@@ -0,0 +1,75 @@
+---
+code: csharp_sdk_preset_properties
+name: "预置属性"
+wikiToken: X08Fw7d9siO37okZYEVcj3KinHc
+parentWikiToken: YGuuwcqPEi07zxkBBPScb6aJneh
+updateTime: 1745309877000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=csharp_sdk_preset_properties
+---
+# 预置属性
+
+以下预置属性，是 C# 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 的版本

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/c//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: c_sdk_preset_properties
+name: "预置属性"
+wikiToken: YNONwip2XimrrTk8M7qcK3OUnvh
+parentWikiToken: TDQVw9hTRi2KYjkieoScuelXnIh
+updateTime: 1745309869000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=c_sdk_preset_properties
+---
+# 预置属性
+
+以下预置属性，是 C 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 的版本