@thinkingai/ae-cli 1.0.30 → 6.0.16-1

package/wiki/te-docs/raw/data-ingestion-guide/server-sdk/c-V2W3wv.md

@@ -0,0 +1,131 @@
+---
+code: csharp_sdk_installation
+name: "C#"
+wikiToken: V2W3wvcfkiGW3lk9rrDcnosAnqi
+parentWikiToken: IKVPwn4NfiIhijk5EcAcMf6pn7e
+updateTime: 1774252015000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=csharp_sdk_installation
+---
+
+::: tip
+Before you begin, please read [<text color="purple" underline="true">Preparation before Data Ingestion</text>](https://thinkingdata.feishu.cn/wiki/OhD8we9iai6Xk5kM1QNc8ITRnQe).
+ :::
+**Latest version**: v2.0.3
+**Update time**: 2025-09-03
+**Resource download: **[source code](https%3A%2F%2Fgithub.com%2FThinkingDataAnalytics%2Fcsharp-sdk)
+::: warning Notice 
+Current documentation applies to v2.0.0 and later. For historical versions, see [Data Ingestion Guide - C# (V1)](https%3A%2F%2Fdocs.thinkingdata.cn%2Fta-manual%2Fv4.1%2Fen%2Finstallation%2Finstallation_menu%2Fserver_sdk%2Fcsharp_sdk_installation%2Fcsharp_sdk_installation.html) 
+:::
+## **SDK**** Integration**
+### Method 1: NuGet Integration
+1. Search for the ThinkingDataAnalytics library in NuGet and install it into your project.
+1. When you install the ThinkingDataAnalytics library, the Newtonsoft.Json library will be automatically installed as well.
+### Method 2: Integrate the DLL file
+1. Download the SDK source code.
+1. Open the solution in the source code and manually compile the DLL file of the SDK.
+1. Import the DLL file of the ThinkingDataAnalytics SDK into your project.
+1. The SDK depends on the Newtonsoft.Json framework for JSON parsing. Please manually add the Newtonsoft.Json library to your project.
+### Logbus Integration
+We recommend using SDK+LogBus to track and report data on server. You can refer to the following documents to complete the installation of Logbus:[ LogBus User Guide](https://thinkingdata.feishu.cn/wiki/SlE6wOEK3isQvukzEbnc5V0inNa)
+## **Initialization**
+The following is the sample code for SDK initialization:
+```csharp
+using ThinkingData.Analytics
+
+TDAnalytics te = new TDAnalytics(new TDLoggerConsumer("LOG_DIRECTORY"));
+```
+
+`LOG_DIRECTORY` is the local folder path.
+## **Common Features**
+In order to ensure that the distinct ID and account ID can be bound smoothly, if your game uses the distinct ID and account ID, we strongly recommend that you upload these two IDs at the same time, otherwise the account will not match, causing users to double count. For specific ID binding rules, please refer to the chapter on [User Identification Rules](https://thinkingdata.feishu.cn/wiki/Pov9wECdsi2QQsk4NN9cEPsvnyc).
+### 3.1 **Sending Events**
+ You can call `Track` to upload events. It is suggested that you set event properties based on the data tracking plan drafted previously. Here is an example of a user buying an item:
+```csharp
+Dictionary<string, object> properties = new Dictionary<string, object>();
+properties.Add("#ip", "123.123.123.123");
+properties.Add("channel", "TE");
+properties.Add("age", 1);
+properties.Add("is_success", true);
+
+List<string> list = new List<string>();
+list.Add("value");
+properties.Add("array", list);
+
+Dictionary<string, Object> objectTest = new Dictionary<string, object>();
+objectTest.Add("key", "vale");
+properties.Add("object", objectTest);
+
+List<Object> object_arr = new List<Object>();
+object_arr.Add(objectTest);
+properties.Add("object_arr", object_arr);
+
+te.Track("accountId", "distinctId", "Payment", properties);
+```
+
+- Key is the name of the property and refers to the string type. It must start with a character, and contain numbers, characters (insensitive to case, and upper cases would be transformed into lower cases by TE) and underscores "_", with a maximum length of 50 characters. 
+- Value, the value of the property, supports string, numbers, Boolean, time, object, array object, and array
+<quote-container>
+**The requirements for event properties and user properties are the same as that for super properties**
+</quote-container>
+
+### 3.2 **User Properties**
+You can set general user properties by calling `UserSet` API. The original properties would be replaced by the properties uploaded via this API. If no user properties are set before, user properties will be newly created. The type of newly-created user properties must conform to that of the uploaded properties. User name setting is taken as the example here: 
+```csharp
+Dictionary<string, object> properties= new Dictionary<string, object>();
+properties.Add("user_name","TA");
+te.UserSet("accountId","distinctId", properties);
+
+Dictionary<string, object> newProperties= new Dictionary<string, object>();
+newProperties.Add("user_name","TE");
+te.UserSet("accountId","distinctId", newProperties);
+```
+
+### 3.3 Reported data
+With `TDLoggerConsumer`, the captured events are encoded as json strings and then added to the cache. Data is written to disk only when the string length in the cache exceeds the set length. The default maximum length is 8192.
+You can call the `flush()` api to report data to the TE  immediately under certain service scenarios. However, frequent calls to `flush()` can result in degraded service performance.
+```csharp
+te.Flush();
+```
+
+### 3.4 Close  SDK
+```csharp
+te.Close();
+```
+
+<quote-container>
+Close and exit the SDK. Please call this api before closing the server to avoid data loss in the cache
+</quote-container>
+
+## **Best Practice**
+The following sample code covers all the above-mentioned operations. It is recommended that the codes be used in the following steps:
+```csharp
+using ThinkingData.Analytics
+
+TDAnalytics te = new TDAnalytics(new TDLoggerConsumer("LOG_DIRECTORY"));
+
+Dictionary<string, object> properties = new Dictionary<string, object>();
+properties.Add("#ip", "123.123.123.123");
+properties.Add("channel", "TE");
+properties.Add("age", 1);
+properties.Add("is_success", true);
+
+List<string> list = new List<string>();
+list.Add("value");
+properties.Add("array", list);
+
+Dictionary<string, Object> objectTest = new Dictionary<string, object>();
+objectTest.Add("key", "vale");
+properties.Add("object", objectTest);
+
+List<Object> object_arr = new List<Object>();
+object_arr.Add(objectTest);
+properties.Add("object_arr", object_arr);
+
+te.Track("accountId", "distinctId", "Payment", properties);
+
+Dictionary<string, object> userProperties = new Dictionary<string, object>();
+userProperties.Add("user_name", "TA");
+te.UserSet("accountId", "distinctId", userProperties);
+
+te.Flush();
+```

package/wiki/te-docs/raw/data-ingestion-guide/server-sdk/c-Zf9Jwl.md

@@ -0,0 +1,179 @@
+---
+code: cpp_server_sdk_installation
+name: "C++"
+wikiToken: Zf9Jwl81biGtrbkmBhackD1Fn3c
+parentWikiToken: IKVPwn4NfiIhijk5EcAcMf6pn7e
+updateTime: 1774252019000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=cpp_server_sdk_installation
+---
+
+::: tip
+Before you begin, please read [<text color="purple" underline="true">Preparation before Data Ingestion</text>](https://thinkingdata.feishu.cn/wiki/OhD8we9iai6Xk5kM1QNc8ITRnQe).
+C++ 11 is required. The g++ version needs to be greater than 5.1.0
+ :::
+**Latest version**: v2.0.0
+**Update time**: 2023-11-30
+**Resource download: **[**Source Code**](https%3A%2F%2Fgithub.com%2FThinkingDataAnalytics%2Fcpp-server-sdk)
+::: warning Notice 
+Current documentation applies to v2.0.0 and later. For historical versions, see [Data Ingestion Guide - C++ (V1)](https%3A%2F%2Fdocs.thinkingdata.cn%2Fta-manual%2Fv4.1%2Fen%2Finstallation%2Finstallation_menu%2Fserver_sdk%2Fcpp_server_sdk_installation%2Fcpp_server_sdk_installation.html) 
+:::
+## **SDK**** Integration**
+**1.1**** Build **`**libthinkingdata.a**`** file**
+1. TE SDK relies on [rapidjson ](https%3A%2F%2Fgithub.com%2FTencent%2Frapidjson)parsing library, you need to download `rapidjson` library.
+2. Download the SDK source code, modify the `CMakeLists.txt` file in the SDK, and select the data consumers you need for packaging (details can refer to the `CMakeLists.txt` file in the SDK source code). Here is an example of the most common `logconsumer`:
+```bash
+cmake_minimum_required(VERSION 3.12)
+project(ThinkingData)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_STANDARD 11)
+
+message(STATUS "[${PROJECT_NAME}] current cmake version: ${CMAKE_MAJOR_VERSION}.${CMAKE_MINOR_VERSION}.${CMAKE_PATCH_VERSION}")
+message(STATUS "[${PROJECT_NAME}] CMAKE_HOST_SYSTEM: ${CMAKE_HOST_SYSTEM} ")
+
+if(NOT CMAKE_BUILD_TYPE)
+    set(CMAKE_BUILD_TYPE release CACHE STRING "Build Type" FORCE)
+endif()
+
+message(STATUS "[${PROJECT_NAME}] Build type:${CMAKE_BUILD_TYPE}")
+
+message(STATUS "[${PROJECT_NAME}] Debug configuration:${CMAKE_CXX_FLAGS_DEBUG}")
+
+message(STATUS "[${PROJECT_NAME}] release configuration:${CMAKE_CXX_FLAGS_RELEASE}")
+
+message(STATUS "[${PROJECT_NAME}] release configuration with debug info:${CMAKE_CXX_FLAGS_RELWITHDEBINFO}")
+
+message(STATUS "[${PROJECT_NAME}] minimal release configuration:${CMAKE_CXX_FLAGS_MINSIZEREL}")
+
+include_directories(include)
+
+ #
+ # log consumer. Recommended for production environments
+ #
+ set(TE_LIB_NAME thinkingdata)
+ add_library(${TE_LIB_NAME} src/TDAnalytics.cpp src/TDUtils.cpp src/TDLoggerConsumer.cpp src/TDConsumer.cpp)
+ if(UNIX)
+   find_package(Threads REQUIRED)
+   target_link_libraries(${TE_LIB_NAME} Threads::Threads)
+ endif()
+```
+
+3. The `rapidjson` library contains only header files.
+  1. Put the `rapidjson` in the following path if your project has not included the `rapidjson` library before:
+
+<image token="A0uybVQmOoqIRfxshGNcdvObnig" width="222" height="201" align="center"/>
+
+2. The contents of the `TDJsonParse.h` file need to be modified if your project has previously included the `rapidjson` library. You don't need to import `rapidjson` again:
+
+<image token="J9LLbZLR0oI26KxgcUfcHyFWndc" width="294" height="149" align="center"/>
+
+
+**1.2 ****Logbus**** Integration**
+We recommend using SDK+LogBus to track and report data on server. You can refer to the following documents to complete the installation of Logbus:[ LogBus User Guide](https://thinkingdata.feishu.cn/wiki/SlE6wOEK3isQvukzEbnc5V0inNa)
+## **Initialization**
+The following is the sample code for SDK initialization:
+```cpp
+#include "../include/TDAnalytics.h"
+#include "../include/TDLoggerConsumer.h"
+#include "../include/TDDebugConsumer.h"
+#include "../include/TDBatchConsumer.h"
+
+using namespace thinkingDataAnalytics;
+
+int main(int argc, char *argv[]) {
+    TDLoggerConsumer::Config config = TDLoggerConsumer::Config("LOG_DIRECTORY", 20, 500, TDLoggerConsumer::HOURLY);
+    config.fileNamePrefix = "te";
+    config.rotateMode = TDLoggerConsumer::HOURLY;
+
+    TDConsumer *consumer = new TDLoggerConsumer(config);
+    TDAnalytics te(*consumer, false);
+}
+```
+
+`LOG_DIRECTORY` is the local folder path.
+## **Common Features**
+In order to ensure that the distinct ID and account ID can be bound smoothly, if your game uses the distinct ID and account ID, we strongly recommend that you upload these two IDs at the same time, otherwise the account will not match, causing users to double count. For specific ID binding rules, please refer to the chapter on [User Identification Rules](https://thinkingdata.feishu.cn/wiki/Pov9wECdsi2QQsk4NN9cEPsvnyc).
+### 3.1 **Sending Events**
+ You can call `track` to upload events. It is suggested that you set event properties based on the data tracking plan drafted previously. Here is an example of a user buying an item:
+```cpp
+TDPropertiesNode event_properties;
+event_properties.SetString("name1", "XZ_debug");
+event_properties.SetString("name2", "logbugs");
+event_properties.SetString("name3", "name3");
+event_properties.SetString("#uuid", "1234567890");
+event_properties.SetNumber("test_number_int", 3);
+event_properties.SetNumber("test_number_double", 3.14);
+event_properties.SetBool("test_bool", true);
+std::string test_string = "test_string";
+event_properties.SetString("test_stl_string1", test_string);
+event_properties.SetDateTime("test_time1", time(nullptr), 0);
+timeb t = {};
+ftime(&t);
+event_properties.SetDateTime("#time", t.time, t.millitm);
+std::vector<std::string> test_list;
+test_list.emplace_back("item11");
+test_list.emplace_back("item21");
+event_properties.SetList("test_list1", test_list);
+
+// track event
+te.track("accountId", "distinctId", "eventName", event_properties);
+```
+
+- Key is the name of the property and refers to the string type. It must start with a character, and contain numbers, characters (insensitive to case, and upper cases would be transformed into lower cases by TE) and underscores "_", with a maximum length of 50 characters. 
+- Value, the value of the property, supports string, numbers, Boolean, time, object, array object, and array
+<quote-container>
+**The requirements for event properties and user properties are the same as that for super properties**
+</quote-container>
+
+### 3.2** User Properties**
+You can set general user properties by calling `user_set` API. The original properties would be replaced by the properties uploaded via this API. If no user properties are set before, user properties will be newly created. The type of newly-created user properties must conform to that of the uploaded properties. User name setting is taken as the example here: 
+```cpp
+// user_set
+TDPropertiesNode userSet_properties;
+userSet_properties.SetString("userName", "test");
+te.user_set("accountId", "distinctId", userSet_properties);
+```
+
+### 3.3 Reported data
+When using `TDLoggerConsumer`, the captured events are converted to json strings and then added to the cache array. Data is written to disk only when the number of array elements exceeds the set capacity. The default capacity is 20.
+You can call the `flush()` api to report data to the TE  immediately under certain service scenarios. However, frequent calls to `flush()` can result in degraded service performance.
+```cpp
+te.flush();
+```
+
+### 3.4 Close  SDK
+```cpp
+te.close();
+```
+
+<quote-container>
+Close and exit the SDK. Please call this api before closing the server to avoid data loss in the cache
+</quote-container>
+
+## **Best Practice**
+The following sample code covers all the above-mentioned operations. It is recommended that the codes be used in the following steps:
+```cpp
+// Import header file (adjust the path yourself)
+#include "../include/TDAnalytics.h"
+#include "../include/TDLoggerConsumer.h"
+
+using namespace thinkingDataAnalytics;
+
+TDLoggerConsumer::Config config = TDLoggerConsumer::Config("LOG_DIRECTORY", 20, 500, TDLoggerConsumer::HOURLY);
+config.fileNamePrefix = "te";
+config.rotateMode = TDLoggerConsumer::HOURLY;
+
+TDConsumer *consumer = new TDLoggerConsumer(config);
+TDAnalytics te(*consumer, false);
+
+TDPropertiesNode event_properties;
+event_properties.SetString("name1", "XZ_debug");;
+event_properties.SetNumber("test_number_int", 3);
+event_properties.SetBool("test_bool", true);
+te.track("accountId", "distinctId", "eventName", event_properties);
+
+TDPropertiesNode userSet_properties;
+userSet_properties.SetString("userName", "test");
+te.user_set("accountId", "distinctId", userSet_properties);
+
+te.flush();
+```

package/wiki/te-docs/raw/data-ingestion-guide/server-sdk/c.md

@@ -0,0 +1,189 @@
+---
+code: c_sdk_installation
+name: "C "
+wikiToken: Er3owqC0UiRR21kCDgZcY4qJn3e
+parentWikiToken: IKVPwn4NfiIhijk5EcAcMf6pn7e
+updateTime: 1774252007000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=c_sdk_installation
+---
+::: tip 
+Before you begin, please read [<text color="purple" underline="true">Preparation before Data Ingestion</text>](https://thinkingdata.feishu.cn/wiki/OhD8we9iai6Xk5kM1QNc8ITRnQe).
+ :::
+**Latest version: **v2.0.0
+**Update time: **2023-11-30
+**Resource download: **[Source Code](https%3A%2F%2Fgithub.com%2FThinkingDataAnalytics%2Fc-sdk)
+::: warning Notice 
+Current documentation applies to v2.0.0 and later. For historical versions, see [Data Ingestion Guide - C (V1)](https%3A%2F%2Fdocs.thinkingdata.cn%2Fta-manual%2Fv4.1%2Fen%2Finstallation%2Finstallation_menu%2Fserver_sdk%2Fc_sdk_installation%2Fc_sdk_installation.html) 
+:::
+## **SDK Integration**
+1.1 Download the source code,  modify the `CMakeLists.txt` file. 
+e.g. Use logconsumer mode:
+```bash
+cmake_minimum_required(VERSION 3.12)
+project(thinking_data_c)
+message(STATUS "[ThinkingData] CMAKE_HOST_SYSTEM: ${CMAKE_HOST_SYSTEM} ")
+
+include_directories(include)
+
+#################################################################
+
+# Product Library: logging consumer
+if(WIN32)
+    add_compile_definitions(USE_WIN)
+    set(CMAKE_C_FLAGS "-std=c89 -pedantic-errors -m64")
+else()
+    add_compile_definitions(USE_POSIX)
+    set(CMAKE_C_FLAGS "-std=c89")
+endif()
+SET(TE_LIB_NAME thinkingdata)
+add_library(${TE_LIB_NAME} src/thinkingdata.c src/td_json.c src/td_list.c src/td_util.c src/td_logger_consumer.c)
+if(WIN32)
+    include_directories(thirdparty/pcre/include)
+    link_directories(thirdparty/pcre/lib)
+    target_link_libraries(${TE_LIB_NAME} pcre_x64)
+endif()
+```
+
+1.2 Logbus Integration
+We recommend using SDK+LogBus to track and report data on server. You can refer to the following documents to complete the installation of Logbus:[ LogBus User Guide](https://thinkingdata.feishu.cn/wiki/SlE6wOEK3isQvukzEbnc5V0inNa)
+## **Initialization**
+The following is the sample code for SDK initialization:
+```c
+struct TDAnalytics* ta = NULL;
+struct TDConsumer* consumer = NULL;
+
+TDConfig* config = td_init_config();
+char* logPath = "LOG_DIRECTORY";
+TD_ASSERT(TD_OK == td_add_string("file_path", logPath, strlen(logPath), config));
+
+if (TD_OK != td_init_consumer(&consumer, config)) {
+    fprintf(stderr, "Failed to initialize the consumer.");
+}
+td_free_properties(config);
+
+if (TD_OK != td_init(consumer, &ta)) {
+    fprintf(stderr, "Failed to initialize the SDK.");
+    return 1;
+}
+```
+
+`LOG_DIRECTORY` is the local folder path.
+## **Common Features**
+In order to ensure that the distinct ID and account ID can be bound smoothly, if your game uses the distinct ID and account ID, we strongly recommend that you upload these two IDs at the same time, otherwise the account will not match, causing users to double count. For specific ID binding rules, please refer to the chapter on [User Identification Rules](https://thinkingdata.feishu.cn/wiki/Pov9wECdsi2QQsk4NN9cEPsvnyc).
+### **3.1 Sending Events**
+You can call `td_track` to upload events. It is suggested that you set event properties based on the data tracking plan drafted previously. Here is an example of a user buying an item:
+```c
+TDProperties *properties = td_init_properties();
+
+TD_ASSERT(TD_OK == td_add_string("#ip", "192.168.1.1", strlen("192.168.1.1"), properties));
+
+TD_ASSERT(TD_OK == td_add_string("channel", "ta", strlen("ta"), properties));
+TD_ASSERT(TD_OK == td_add_int("age", 1, properties));
+TD_ASSERT(TD_OK == td_add_bool("is_success", TD_TRUE, properties));
+TD_ASSERT(TD_OK == td_add_date("birthday", time(NULL), 0, properties));
+
+TD_ASSERT(TD_OK == td_append_array("arr", "value", strlen("value"), properties));
+TD_ASSERT(TD_OK == td_append_array("arr", "value1", strlen("value1"), properties));
+
+TDProperties *object = td_init_custom_properties("object");
+TD_ASSERT(TD_OK == td_add_string("key", "value", strlen("value"), object));
+TD_ASSERT(TD_OK == td_add_property(object, properties));
+
+TDProperties *object1 = td_init_custom_properties("object1");
+TD_ASSERT(TD_OK == td_add_string("key", "value", strlen("value"), object1));
+TD_ASSERT(TD_OK == td_append_properties("object_arr", object1, properties));
+
+TD_ASSERT(TD_OK == td_track("account_id", "distinct_id", "payment", properties, ta));
+td_free_properties(properties);
+```
+
+- Key is the name of the property and refers to the string type. It must start with a character, and contain numbers, characters (insensitive to case, and upper cases would be transformed into lower cases by TE) and underscores "_", with a maximum length of 50 characters. 
+- Value, the value of the property, supports string, numbers, Boolean, time, object, array object, and array
+<quote-container>
+**The requirements for event properties and user properties are the same as that for super properties**
+</quote-container>
+
+### 3.2** **User Properties**
+You can set general user properties by calling `td_user_set` API. The original properties would be replaced by the properties uploaded via this API. If no user properties are set before, user properties will be newly created. The type of newly-created user properties must conform to that of the uploaded properties. User name setting is taken as the example here: 
+```c
+TDProperties *user_properties = td_init_properties();
+TD_ASSERT(TD_OK == td_add_string("user_name", "TA", strlen("TA"), user_properties));
+TD_ASSERT(TD_OK == td_user_set(account_id, distinct_id, user_properties,ta));
+td_free_properties(user_properties);
+
+TDProperties *user_properties2 = td_init_properties();
+TD_ASSERT(TD_OK == td_add_string("user_name", "TE", strlen("TE"), user_properties2));
+TD_ASSERT(TD_OK == td_user_set(account_id, distinct_id, user_properties2,ta));
+td_free_properties(user_properties2);
+```
+
+### 3.3 Reported data
+Use `td_init_consumer()` to initialize the SDK. The SDK will write the collected data to the disk in real time.
+Internally, the `td_flush()` function synchronizes the default memory cache in the file system to disk in real time. No manual call is usually required.
+```c
+td_flush(ta);
+```
+
+### 3.4 Close SDK
+```c
+td_free(ta);
+td_consumer_free(consumer);
+```
+
+<quote-container>
+Close and exit the SDK. Please call this API before closing the server to avoid data loss in the cache
+</quote-container>
+
+## **Best Practice**
+The following sample code covers all the above-mentioned operations. It is recommended that the codes be used in the following steps:
+```c
+struct TDAnalytics* ta = NULL;
+struct TDConsumer* consumer = NULL;
+
+TDConfig* config = td_init_config();
+char* logPath = "LOG_DIRECTORY";
+TD_ASSERT(TD_OK == td_add_string("file_path", logPath, strlen(logPath), config));
+
+if (TD_OK != td_init_consumer(&consumer, config)) {
+    fprintf(stderr, "Failed to initialize the consumer.");
+}
+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();
+
+TD_ASSERT(TD_OK == td_add_string("#ip", "192.168.1.1", strlen("192.168.1.1"), properties));
+
+TD_ASSERT(TD_OK == td_add_string("channel", "ta", strlen("ta"), properties));
+TD_ASSERT(TD_OK == td_add_int("age", 1, properties)); 
+TD_ASSERT(TD_OK == td_add_bool("is_success", TD_TRUE, properties));
+TD_ASSERT(TD_OK == td_add_date("birthday", time(NULL), 0, properties));
+
+TD_ASSERT(TD_OK == td_append_array("arr", "value", strlen("value"), properties));
+TD_ASSERT(TD_OK == td_append_array("arr", "value1", strlen("value1"), properties));
+
+TDProperties *object = td_init_custom_properties("object");
+TD_ASSERT(TD_OK == td_add_string("key", "value", strlen("value"), object));
+TD_ASSERT(TD_OK == td_add_property(object, properties));
+
+TDProperties *object1 = td_init_custom_properties("object1");
+TD_ASSERT(TD_OK == td_add_string("key", "value", strlen("value"), object1));
+TD_ASSERT(TD_OK == td_append_properties("object_arr", object1, properties));
+
+TD_ASSERT(TD_OK == td_track("account_id", "distinct_id", "payment", properties, ta));
+td_free_properties(properties);
+
+TDProperties *user_properties = td_init_properties();
+TD_ASSERT(TD_OK == td_add_string("user_name", "TA", strlen("TA"), user_properties));
+TD_ASSERT(TD_OK == td_user_set("account_id", "distinct_id", user_properties,ta));
+td_free_properties(user_properties);
+
+TDProperties *user_properties2 = td_init_properties();
+TD_ASSERT(TD_OK == td_add_string("user_name", "TE", strlen("TE"), user_properties2));
+TD_ASSERT(TD_OK == td_user_set("account_id", "distinct_id", user_properties2,ta));
+td_free_properties(user_properties2);
+```

package/wiki/te-docs/raw/data-ingestion-guide/server-sdk/erlang/erlang-advanced/debugging-and-logging.md

@@ -0,0 +1,38 @@
+---
+code: erlang_sdk_debug
+name: "Debugging and Logging"
+wikiToken: In61wT9A5iEn0fky0DacwxDAnIf
+parentWikiToken: PnlawuZLdi5AtakVJFEcXnohnGc
+updateTime: 1774249338000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=erlang_sdk_debug
+---
+
+::: warning Notice
+The SDK Debug mode is used only for access debugging. Do not apply it to the production environment.
+:::
+During the process of SDK Integration, you can perform real-time debugging by checking SDK logs in the IDE console or using the Debug function of TE.
+## Debugging
+You need to follow the following two steps to enable the Debug mode:
+#### 2.1 Use DebugConsumer
+The sample code for enabling the Debug mode on the client side is as follows:
+```erlang
+ServerUrl = "server_url",
+AppID = "app_id",
+IsWrite = true,
+DeviceId = "123456789",
+
+Consumer = td_debug_consumer:init_with_config(ServerUrl, AppID, IsWrite, DeviceId),
+TE_SDK = td_analytics:init_with_consumer(Consumer),
+
+AccountId0 = "account_id_Erlang_0",
+td_analytics:track_instance(TE_SDK, AccountId0, "distinct_logbus", "ViewProduct", #{"#key_1" => "🚓🦽🦼🚲🚜🚜🦽", "key_2" => 2.2, "key_array" => ["🚌", "🏍", "😚😊"]}),
+td_analytics:close_instance(TE_SDK).
+```
+
+#### 2.2 Add Device
+To avoid launching the Debug mode in the production environment, it is required that only specified device can enable Debug mode.  The Debug mode can only be enabled for devices whose ID has been configured in the "Debug data" sector on the "tracking management" page of the TE.
+<image token="S4GEbaN7fosQCKxozN9cvFnhnSg" width="1280" height="590" align="center"/>
+
+<quote-container>
+It can only be used for data verification at the integration stage, and should not be used in the online environment.
+</quote-container>

package/wiki/te-docs/raw/data-ingestion-guide/server-sdk/erlang/erlang-advanced/preset-properties.md

@@ -0,0 +1,126 @@
+---
+code: erlang_sdk_preset_properties
+name: "Preset Properties"
+wikiToken: LFkbwNEG8idFlikyL1mcfeIRnIc
+parentWikiToken: PnlawuZLdi5AtakVJFEcXnohnGc
+updateTime: 1774249340000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=erlang_sdk_preset_properties
+---
+
+The following present properties are properties that all events in SDK would have.
+
+<lark-table rows="8" cols="4" column-widths="169,152,140,259">
+
+  <lark-tr>
+    <lark-td>
+      Property name
+    </lark-td>
+    <lark-td>
+      Display name
+    </lark-td>
+    <lark-td>
+      Property type
+    </lark-td>
+    <lark-td>
+      Instruction
+    </lark-td>
+  </lark-tr>
+  <lark-tr>
+    <lark-td>
+      #ip
+    </lark-td>
+    <lark-td>
+      IP address
+    </lark-td>
+    <lark-td>
+      Text
+    </lark-td>
+    <lark-td>
+      IP address of the user, based on which TE would get the geographical location of the user
+    </lark-td>
+  </lark-tr>
+  <lark-tr>
+    <lark-td>
+      #country
+    </lark-td>
+    <lark-td>
+      Country
+    </lark-td>
+    <lark-td>
+      Text
+    </lark-td>
+    <lark-td>
+      The country where the user is located; generated based on the IP address
+    </lark-td>
+  </lark-tr>
+  <lark-tr>
+    <lark-td>
+      #country_code
+    </lark-td>
+    <lark-td>
+      Country code
+    </lark-td>
+    <lark-td>
+      Text
+    </lark-td>
+    <lark-td>
+      The code of the country where the user is located (ISO 3166-1 alpha-2, two English characters in upper case); generated based on the IP address
+    </lark-td>
+  </lark-tr>
+  <lark-tr>
+    <lark-td>
+      #province
+    </lark-td>
+    <lark-td>
+      Province
+    </lark-td>
+    <lark-td>
+      Text
+    </lark-td>
+    <lark-td>
+      The province where the user is located; generated based on the IP address
+    </lark-td>
+  </lark-tr>
+  <lark-tr>
+    <lark-td>
+      #city
+    </lark-td>
+    <lark-td>
+      City
+    </lark-td>
+    <lark-td>
+      Text
+    </lark-td>
+    <lark-td>
+      The city where the user is located; generated based on the IP address
+    </lark-td>
+  </lark-tr>
+  <lark-tr>
+    <lark-td>
+      #lib
+    </lark-td>
+    <lark-td>
+      SDK type
+    </lark-td>
+    <lark-td>
+      Text
+    </lark-td>
+    <lark-td>
+      The type of SDK which you integrate, e.g., Golang, etc.
+    </lark-td>
+  </lark-tr>
+  <lark-tr>
+    <lark-td>
+      #lib_version
+    </lark-td>
+    <lark-td>
+      SDK version
+    </lark-td>
+    <lark-td>
+      Text
+    </lark-td>
+    <lark-td>
+      The version of the SDK which you integrate
+    </lark-td>
+  </lark-tr>
+</lark-table>