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/c.md

@@ -0,0 +1,253 @@
+---
+code: client_cpp_sdk_installation
+name: "C++"
+wikiToken: E8ekwJ170iMfb8ktBPfcYxE4nq0
+parentWikiToken: FTcTwinIOi3OiRkK4MPc2Ex7neg
+updateTime: 1760169183000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=client_cpp_sdk_installation
+---
+# C++
+
+::: tip 提示
+
+ 在接入前, 请先阅读接入前准备。
+
+您可以在 GitHub 获取C++ SDK 源码。
+
+C++ SDK 支持在Mac、Windows平台运行，支持C++ 11以上版本，大小约为 144KB
+
+ :::
+
+**最新版本****:** v1.5.3
+
+**更新时间:** 2025-10-11
+
+**资源下载:**** **SDK源码
+
+### 一、集成 SDK
+
+#### 1.1 下载SDK
+
+下载SDK源码，解压后进入cpp-client/cpp文件夹。
+
+include 为 SDK 的头文件、src 为 SDK 源代码文件、thirdparty 为依赖的三方库。
+
+#### 1.2 添加依赖
+
+C++ SDK 依赖 sqlite、curl、zlib 、openssl库，由于平台特性的差异，库的格式也有所不同。可使用数数编译好的库，也可以自行编译库。
+
+##### 1.2.1 使用数数编译的库
+
+库是在 windows 平台的编译器生成的库，将 thirdparty 文件夹中编译好的库配置到项目中。（.dll 为动态库，.lib 为静态库）
+
+##### 1.2.2 自行编
+
+这里以window平台为例：
+
+下载curl库，https://github.com/curl/curl/releases/tag/curl-7_61_1，解压后，切换至winbuild 目录，并编译，编译命令如下， 编译结果在 curl 目录 builds 下。
+
+```
+nmake /f Makefile.vc mode=static ENABLE_IDN=no
+```
+
+下载zlib库，https://github.com/madler/zlib/releases/tag/v1.2.11，解压后，执行编译命令，编译结果在 zlib 目录下。
+
+```
+nmake -f win32/Makefile.msc
+```
+
+下载sqlite库，https://www.sqlite.org/download.html，选择指定平台的库。
+
+<!-- unsupported block: 19 -->
+
+除了命令行的方式，也可以使用 IDE（集成开发环境） ，如 Visual Studio 、Clion 等来生成对应平台的库。
+
+下载openssl库，https://github.com/openssl/openssl，自行编译指定平台的库。
+
+#### 1.3 集成SDK
+
+##### 1.3.1 使用 CMake 集成
+
+使用 CMake 来集成 C++ SDK，将cpp文件夹拷贝到项目中，在`CMakeLists.txt`文件中分别为Windows 和 Mac 添加如下配置：
+
+设置C++ 的版本：
+
+```
+set(CMAKE_CXX_STANDARD 11)
+```
+
+引入头文件：
+
+```
+include_directories(cpp/include)
+```
+
+添加 Windows 平台配置：
+
+```
+if(WIN32)
+    if(CMAKE_SIZEOF_VOID_P EQUAL 8) # x64平台
+        include_directories(cpp/thirdparty/x64/curl/include cpp/thirdparty/x64/zlib/include cpp/thirdparty/x64/sqlite/include cpp/thirdparty/x64/openssl/include)
+        link_directories(cpp/thirdparty/x64/curl/lib cpp/thirdparty/x64/zlib/lib cpp/thirdparty/x64/sqlite/lib cpp/thirdparty/x64/openssl/lib)
+    else() # Win32平台
+        include_directories(cpp/thirdparty/x86/curl/include cpp/thirdparty/x86/zlib/include cpp/thirdparty/x86/sqlite/include cpp/thirdparty/x86/openssl/include)
+        link_directories(cpp/thirdparty/x86/curl/lib cpp/thirdparty/x86/zlib/lib cpp/thirdparty/x86/sqlite/lib cpp/thirdparty/x86/openssl/lib)
+    endif()
+    add_library(thinkingdata SHARED cpp/src/ta_analytics_sdk.cpp cpp/src/ta_cpp_helper.cpp cpp/src/ta_cpp_network.cpp cpp/src/ta_cpp_utils.cpp cpp/src/ta_sqlite.cpp cpp/src/ta_timer.cpp cpp/src/ta_event_task.cpp cpp/src/ta_cpp_send.cpp cpp/src/ta_json_object.cpp cpp/src/ta_cJSON.c cpp/src/ta_encrypt.cpp cpp/src/ta_calibrated_time.cpp cpp/src/ta_flush_task.cpp)
+    target_link_libraries(thinkingdata libcurl sqlite3 zlibwapi libssl libcrypto)
+endif()
+```
+
+添加 Mac 平台配置：
+
+```
+if (CMAKE_HOST_APPLE)
+    find_library(COCOA Cocoa)
+    find_library(IOKIT IOKit)
+    find_package(OpenSSL REQUIRED)
+    include_directories(${OPENSSL_INCLUDE_DIR})
+    link_directories(${OPENSSL_LIBRARIES})
+    add_library(thinkingdata SHARED cpp/src/ta_analytics_sdk.cpp cpp/src/ta_cpp_helper.cpp cpp/src/ta_cpp_network.cpp cpp/src/ta_cpp_utils.cpp cpp/src/ta_sqlite.cpp cpp/src/ta_timer.cpp cpp/src/ta_event_task.cpp cpp/src/ta_cpp_send.cpp cpp/src/ta_json_object.cpp cpp/src/ta_cJSON.c cpp/src/ta_mac_tool.mm cpp/src/ta_encrypt.cpp cpp/src/ta_calibrated_time.cpp cpp/src/ta_flush_task.cpp)
+    target_link_libraries(thinkingdata curl z sqlite3 ${OPENSSL_LIBRARIES} ${COCOA} ${IOKIT})
+endif()
+```
+
+##### 1.3.2 自行编译
+
+可使用 IDE（集成开发环境）自行编译数数的库
+
+1. 下载好SDK 代码，cd到cmakelist文件目录下
+1. 执行以下命令
+```
+//windows平台 利用visual studio来编译
+//x86
+cmake -S . -B build -G "Visual Studio 17 2022" -A Win32
+ //x64
+cmake -S . -B build -G "Visual Studio 17 2022" -A x64
+```
+
+```
+//Mac平台
+// arm64平台 m1
+arch -arm64 cmake -B build
+arch -arm64 cmake --build build
+
+//x86_64平台  intel
+arch -x86_64 cmake -B build
+arch -x86_64 cmake --build build
+```
+
+##### 1.3.3 使用源码集成
+
+在完成步骤1.2的三方依赖配置之后，将 include 和 src 文件夹添加至项目中。
+
+##### 1.3.4 使用数数编译好的库
+
+SDK下载
+
+下载解压好，可以找到x64和x86平台相应的dll文件，可直接使用。
+
+### 二、 初始化SDK
+
+```
+#include "ta_analytics_sdk.h"
+#include "ta_json_object.h"
+
+using namespace thinkingdata;
+
+ThinkingAnalyticsAPI::Init(SERVER_URL, APPID);
+```
+
+参数说明:
+
+- `APPID`: 您的项目的 APPID，可通过在 AE 后台项目管理页面获取
+- `SERVER_URL`: 数据上传的 URL
+- 如果您对接的是云服务，填入: https://global-receiver-ta.thinkingdata.cn
+- 如果您使用私有化部署版本，请为数据采集地址绑定域名，并配置 HTTPS 证书：https://数据采集地址绑定域名
+### 三、常用功能
+
+在使用常用功能之前，建议你先了解用户识别规则；SDK默认会生成随机数作为访客ID，并持久化存储访客ID在本地；用户未登录之前，会以访客ID作为身份识别ID。注意:访客 ID 在用户重新安装 App 以及更换设备时将会变更。
+
+#### 3.1 设置账号ID
+
+在用户进行登录时，可调用 `Login` 来设置用户的账号 ID， AE 平台将会以账号 ID 作为身份识别 ID，并且设置的账号 ID 将会在调用` Logout` 之前一直保留。多次调用 `Login` 将覆盖先前的账号 ID 。
+
+```
+// 用户的登录唯一标识，此数据对应上报数据里的#account_id，此时#account_id的值为TA
+ThinkingAnalyticsAPI::Login("TA");
+```
+
+`Login` 可以多次调用，每次调用会判断传入的账号 ID 与先前保存的 ID 是否一致，一致则忽略调用，不一致则会覆盖先前的 ID。
+
+<!-- unsupported block: 34 -->
+
+**该方法不会上传登录事件**
+
+#### 3.2 发送事件
+
+您可以调用 `track` 来上传事件，建议您根据先前梳理的埋点文档来设置事件的属性以及发送信息的条件，此处以用户购买某商品作为范例：
+
+```
+TDJSONObject event_properties;
+event_properties.SetString("name1", "name1");//字符串
+event_properties.SetNumber("test_number_int", 3);//数字
+event_properties.SetBool("test_bool", **true**);//bool
+event_properties.SetDateTime("test_time1", time(**NULL**), 0);//时间
+std::vector<std::string> test_list;
+test_list.push_back("item11");
+test_list.push_back("item21");
+event_properties.SetList("test_list1", test_list);//数组
+ThinkingAnalyticsAPI::Track("CPP_event", event_properties);
+```
+
+- 事件的名称是字符串类型，只能以字母开头，可包含数字，字母和下划线 "_"，长度最大为 50 个字符。
+- 事件属性是 `TDJSONObject` 类型，其中每个元素代表一个属性；
+- 事件属性 `Key` 为属性名称，为字符串类型，规定只能以字母开头，包含数字，字母和下划线 "_"，长度最大为 50 个字符，对字母大小写不敏感；
+- 属性值支持字符串、数字、布尔、数组、时间类型。
+<!-- unsupported block: 34 -->
+
+**用户属性的要求与事件属性保持一致**
+
+#### 3.3 设置用户属性
+
+对于一般的用户属性，您可以调用`UserSet` 来进行设置，使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例：
+
+```
+TDJSONObject userProperties;
+userProperties.SetString("user_name", "TA");
+ThinkingAnalyticsAPI::UserSet(userProperties);
+```
+
+### 四、最佳实践
+
+以下示例代码包含以上所有操作，我们推荐按照如下步骤使用:
+
+```
+#include "ta_analytics_sdk.h"
+using namespace thinkingdata;
+//初始化SDK
+ThinkingAnalyticsAPI::Init(SERVER_URL, APPID);
+ //如果用户已登录，可以设置用户的账号ID作为身份唯一标识
+ThinkingAnalyticsAPI::Login("TA");
+//发送事件
+TDJSONObject event_properties;
+event_properties.SetString("name1", "name1");//字符串
+event_properties.SetNumber("test_number_int", 3);//数字
+event_properties.SetBool("test_bool", **true**);//bool
+event_properties.SetDateTime("test_time1", time(**NULL**), 0);//时间
+std::vector<std::string> test_list;
+test_list.push_back("item11");
+test_list.push_back("item21");
+event_properties.SetList("test_list1", test_list);//数组
+ThinkingAnalyticsAPI::Track("CPP_event", event_properties);;
+//设置用户属性
+TDJSONObject userProperties;
+userProperties1.SetString("user_name", "TA");
+ThinkingAnalyticsAPI::UserSet(userProperties);
+```
+
+#### 
+
+### 
+
+####

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/h5-/344/270/216-app-sdk-/346/211/223/351/200/232.md

@@ -0,0 +1,179 @@
+---
+code: h5_app_integrate
+name: "H5 与 APP SDK 打通"
+wikiToken: AQADwTQ9jisoGSkiyZycSLAInlt
+parentWikiToken: FTcTwinIOi3OiRkK4MPc2Ex7neg
+updateTime: 1745309847000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=h5_app_integrate
+---
+# H5 与 APP SDK 打通
+
+### 一、方案介绍
+
+在 APP 当中，可能会有一些页面是由 H5 页面所构成的，此时 APP SDK 无法对 H5 页面进行数据采集，需要搭配使用 JavaScript SDK 对用户在 H5 页面的行为进行采集，为了保证 JavaScript SDK 与 APP SDK 的数据保持一致，在新版本 SDK 中加入了数据打通功能：
+
+H5 页面使用 JavaScript SDK 进行数据采集，采集到数据后不直接发送，而是通过 APP SDK（即 Android SDK 、 iOS SDK、 Flutter SDK、 ReactNative SDK）发送到服务器。APP SDK 会对 JavaScript SDK 采集的数据进行调整，规则如下：
+
+1. 保留 JavaScript SDK 传入的 `#time`，即事件的时间以触发埋点的时间为准
+1. 使用 APP SDK 的`#account_id` 与 `#distinct_id`，以 APP SDK 维护的用户为准
+1. 加入 APP SDK 的预置属性，如果与 JavaScript 的预置属性冲突，则 APP SDK 的预置属性将覆盖冲突值，比如`#lib`字段，APP SDK 的值会覆盖 JavaScript SDK 的值
+1. APP SDK 的公共属性：如果与 JavaScript 传入的属性冲突，则丢弃原生公共属性值；如果 JavaScript SDK 没有该属性，则加入到上报数据中
+1. APP SDK 中的`timeEvent` 接口可以对 JavaScript SDK 采集的事件生效
+1. JavaScript SDK 中的 login、logout、identify 接口无法修改 APP SDK 中的用户 ID，在 H5 与 APP SDK 打通的情况下，在 JavaScript SDK 中通过上述接口无法对数据的用户 ID 进行修改
+1. 当开启 H5 与 APP SDK 打通的开关后，如果运行环境中并不存在 APP SDK，则 JavaScript SDK 将会直接上报数据，等同于未开启打通的状态。
+### 二、使用方法
+
+如需开启 H5 与 APP SDK 打通功能，需要在 JavaScript SDK 与 APP SDK 进行如下配置，**请注意 SDK 的适用版本**，请使用历史版本的用户升级至最新版本。
+
+#### 2.1 Android SDK 使用方法
+
+**Android SDK 需要使用 1.2.0 及之后的版本**
+
+在初始化 `WebView` 时调用`setJsBridge`：
+
+```
+TDAnalytics.setJsBridge(WebView webView);
+```
+
+如果需要支持腾讯的`X5Webview`，需要 Android SDK 需要使用 2.0.1 及之后的版本，调用`setJsBridgeForX5WebView`：
+
+```
+TDAnalytics.setJsBridgeForX5WebView(webView);
+```
+
+#### 2.2 iOS SDK 使用方法
+
+**iOS SDK 需要使用 1.1.1 及之后的版本**
+
+##### WKWebView
+
+在 iOS 17 之后的系统，废弃了使用 NSUserDefaults 设置全局 UserAgent 的方式。需要你手动给 WKWebView 对象添加上数数 SDK 特有的 UserAgent。否则不能实现 H5 与原生应用的打通。
+
+添加方式如下
+
+```
+WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc] init];
+config.applicationNameForUserAgent = [NSString stringWithFormat:@"%@ %@", config.applicationNameForUserAgent ?: @"", @"/td-sdk-ios"]; 
+WKWebView *webView = [[WKWebView alloc] initWithFrame:self.view.bounds configuration:config];
+```
+
+在 WKWebView 的代理方法： decidePolicyForNavigationAction 中添加下列代码
+
+```
+- (**void**)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(**void** (^)(WKNavigationActionPolicy))decisionHandler {
+    **if** ([TDAnalytics showUpWebView:webView withRequest:navigationAction.request]) {
+        decisionHandler(WKNavigationActionPolicyCancel);
+        **return**;
+    }
+    
+    decisionHandler(WKNavigationActionPolicyAllow);
+}
+```
+
+##### UIWebView
+
+1.在初始化完 SDK 之后，调用`addWebViewUserAgent`：
+
+```
+[TDAnalytics addWebViewUserAgent];
+```
+
+2.在初始化 `WebView` 时，根据`WebView`的类型做如下调用：
+
+```
+- (**BOOL**)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType {
+    **if** ([TDAnalytics showUpWebView:webView withRequest:request]) {
+        **return** **NO**;
+    }
+    /*
+        other code
+    */
+    **return** **YES**;
+}
+```
+
+#### 2.3 Flutter SDK 使用方法
+
+**Flutter SDK 需要使用 3.1.0-beta.1 及之后的版本**
+
+在初始化 `WebView` 时调用`addJavaScriptChannel`，在`onMessageReceived`方法会调用中调用`TDAnalytics.h5ClickHandler();`
+
+```
+controller = WebViewController();
+controller.addJavaScriptChannel("ThinkingData_APP_Flutter_Bridge", onMessageReceived: (JavaScriptMessage message){
+    TDAnalytics.h5ClickHandler(message.message);
+});
+```
+
+#### 2.4 ReactNative SDK 使用方法
+
+**ReactNative SDK 需要使用 3.1.0-beta.1 及之后的版本**
+
+在初始化 `WebView` 时调用`injectedJavaScript`方法注入js，在`onMessage`方法会调用中调用`TDAnalytics.h5ClickHandler();`
+
+```
+<WebView
+  ref={webViewRef}
+  source={localHtmlFile}
+  onMessage={ event => {
+    console.log(event.nativeEvent.data);
+    TDAnalytics.h5ClickHandler(event.nativeEvent.data);
+  }}
+  javaScriptEnabled={true}
+  injectedJavaScript='window.ThinkingData_APP_ReactNative_Bridge = function(data) { window.ReactNativeWebView.postMessage(data); };'
+/>
+```
+
+#### 2.5 JavaScript SDK 使用方法
+
+**JavaScript SDK 需要使用 ****2****.0.****4**** 及之后的版本**
+
+- 在初始化参数配置中加入 `useAppTrack: true`，示例如下：
+```
+(function(param) {
+  var p = param.sdkUrl,
+    n = param.name,
+    w = window,
+    d = document,
+    s = "script",
+    x = null,
+    y = null;
+  w["ThinkingDataAnalyticalTool"] = n;
+  w[n] =
+    w[n] ||
+    function(a) {
+      return function() {
+        (w[n]._q = w[n]._q || []).push([a, arguments]);
+      };
+    };
+  var methods = [
+    "track",
+    "quick",
+    "login",
+    "logout",
+    "trackLink",
+    "userSet",
+    "userSetOnce",
+    "userAdd",
+    "userDel",
+    "setPageProperty"
+  ];
+  for (var i = 0; i < methods.length; i++) {
+    w[n][methods[i]] = w[n].call(null, methods[i]);
+  }
+  if (!w[n]._t) {
+    (x = d.createElement(s)), (y = d.getElementsByTagName(s)[0]);
+    x.async = 1;
+    x.src = p;
+    y.parentNode.insertBefore(x, y);
+    w[n].param = param;
+  }
+})({
+  appId: "APP_ID", //系统分配的APPID
+  name: "ta", //全局的调用变量名，可以任意设置，后续的调用使用该名称即可
+  sdkUrl: "http://www.a.com/thinkingdata.js", //统计脚本URL
+  serverUrl: "https://global-receiver-ta.thinkingdata.cn:9080", //数据上传的URL
+  send_method: "image", //数据上传方式
+  useAppTrack: true // 打通 APP 与 H5
+});
+```

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/ios//345/220/210/350/247/204/346/214/207/345/215/227.md

@@ -0,0 +1,37 @@
+---
+code: ios_sdk_compliance
+name: "合规指南"
+wikiToken: MJgTw2HV5i4MaikVmlwcVL4wn2b
+parentWikiToken: RCJRwHveBi4YRBk2AqncI0VqncS
+updateTime: 1745309663000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=ios_sdk_compliance
+---
+# 合规指南
+
+### 一. 隐私政策中填写 SDK 相关内容
+
+#### 1.1 收集和获取
+
+在《隐私政策》中收集和获得您的个人信息栏目中根据实际情况填写以下内容。
+
+当您在激活使用时，我们会通过ThinkingAnalytics-SDK收集您的设备信息（IDFV、AndroidID、操作系统、设备型号、设备制造商、系统版本、应用进程信息等）用于统计分析您在 App 内的使用效果。
+
+#### 1.2 与授权合作伙伴共享
+
+在《隐私政策》中的与授权合作伙伴共享栏目中根据实际情况填写以下内容。
+
+ThinkingAnalytics-SDK：收集您的设备信息（IDFV、AndroidID、操作系统、设备型号、设备制造商、系统版本、应用进程信息等）、联网信息用于数据分析，从而改进我们的产品和服务。
+
+### 二. SDK合规步骤
+
+ThinkingData SDK需要在用户同意 《隐私政策》后初始化
+
+```
+// 根据隐私协议判断是否开启数据采集
+if (授权隐私政策) {
+    // SDK needs to be initialized on the main thread
+    NSString *appid = @"APPID";
+    NSString *url = @"SERVER_URL";
+    [TDAnalytics startAnalyticsWithAppId:appid serverUrl:url];
+}
+```