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//350/277/233/351/230/266/346/214/207/345/215/227.md

@@ -0,0 +1,242 @@
+---
+code: c_sdk_advanced
+name: "进阶指南"
+wikiToken: TDQVw9hTRi2KYjkieoScuelXnIh
+parentWikiToken: SLlQwuOYRifeDVkRAxTc08pVnMg
+updateTime: 1745309867000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=c_sdk_advanced
+---
+# 进阶指南
+
+### 一、发送事件
+
+在 SDK 初始化完成之后，您就可以进行数据埋点，收集用户的的行为信息。一般情况下普通事件即可满足业务场景需求，您也可以根据自己的实际业务场景使用首次、可更新等事件。
+
+#### 1.1 普通事件
+
+您可以调用 `td_track` 来上传事件，建议您根据先前梳理的文档来设置事件的属性以及发送事件的条件，此处以用户购买某商品作为范例：
+
+```
+// 设置事件属性
+TDProperties *properties = td_init_properties();
+TD_ASSERT(*TD_OK *== td_add_string("product_name", "goods_name", strlen("goods_name"), properties));
+// 上报带有自定义属性的事件数据，同样account_id 和 distinct_id 必须至少设置其中一个
+TD_ASSERT(*TD_OK *== td_track("account_id", "distinct_id", "product_buy", properties, ta));
+td_free_properties(properties);
+```
+
+#### 1.2 首次事件
+
+首次事件是指针对某个设备或者其他维度的 ID，只会记录一次的事件。例如在一些场景下，您可能希望记录在某个设备上的激活事件，则可以用首次事件来上报数据。
+
+```
+TD_ASSERT(*TD_OK *== td_track_first_event("account_id", "distinct_id", "device_activation", "first_id", properties, ta));
+```
+
+<!-- unsupported block: 34 -->
+
+注意：由于在服务端完成对是否首次的校验，首次事件默认会延时 1 小时入库。
+
+#### 1.3 可更新事件
+
+您可以通过可更新事件实现特定场景下需要修改事件数据的需求。可更新事件需要指定标识该事件的 ID，并在创建可更新事件对象时传入。AE 后台将根据事件名和事件 ID 来确定需要更新的数据。
+
+```
+// 上报可更新事件，事件名为UPDATABLE_EVENT，事件ID为event_id
+// 上报后事件属性 status 为 3, price 为 100
+TDProperties *properties = td_init_properties();
+TD_ASSERT(*TD_OK *== td_add_int("price",100,properties));
+TD_ASSERT(*TD_OK *== td_add_int("status",3,properties));
+TD_ASSERT(*TD_OK *== td_track_update("account_id", "distinct_id", "UPDATABLE_EVENT", "event_id",properties, ta));
+td_free_properties(properties);
+// 上报后同样的事件属性 status 被更新为 5, price 不变
+TDProperties *new_properties = td_init_properties();
+TD_ASSERT(*TD_OK *== td_add_int("status",5,new_properties));
+TD_ASSERT(*TD_OK *== td_track_update("account_id", "distinct_id", "UPDATABLE_EVENT", "event_id",new_properties, ta));
+td_free_properties(new_properties);
+```
+
+#### 1.4 可重写事件
+
+可重写事件与可更新事件类似，区别在于可重写事件会用最新的数据完全覆盖历史数据，从效果上看相当于删除前一条数据，并入库最新的数据。AE 后台将根据事件名和事件 ID 来确定需要更新的数据。
+
+```
+// 上报可重写事件，事件名为OVERWRITE_EVENT，事件ID为event_id
+// 上报后事件属性 status 为 3, price 为 100
+TDProperties *properties = td_init_properties();
+TD_ASSERT(*TD_OK *== td_add_int("price",100,properties));
+TD_ASSERT(*TD_OK *== td_add_int("status",3,properties));
+TD_ASSERT(*TD_OK *== td_track_overwrite("account_id", "distinct_id", "OVERWRITE_EVENT", "event_id",properties, ta));
+td_free_properties(properties);
+// 上报后同样的事件属性 status 被更新为 5, price 属性被删除
+TDProperties *new_properties = td_init_properties();
+TD_ASSERT(*TD_OK *== td_add_int("status",5,new_properties));
+TD_ASSERT(*TD_OK *== td_track_overwrite("account_id", "distinct_id", "OVERWRITE_EVENT", "event_id",new_properties, ta));
+td_free_properties(new_properties);
+```
+
+### 二、用户属性
+
+AE 平台支持的用户属性设置API有: `td_user_set`、`td_user_setOnce`、`td_user_add`、`td_user_unset`、`td_user_delete`、`td_user_append`、`td_user_uniq_append`。
+
+#### 2.1 td_user_set
+
+对于一般的用户属性，您可以调用`td_user_set`来进行设置。使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例：
+
+```
+//此时username为TA
+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);
+
+//此时userName为TE
+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);
+```
+
+#### 2.2 td_user_setOnce
+
+如果您要上传的用户属性只要设置一次，则可以调用`t``d``_user_setOnce`来进行设置，当该属性之前已经有值的时候，将会忽略这条信息，再以设置用户名为例：
+
+```
+//first_payment_time为2018-01-01 01:23:45.678
+TDProperties *user_properties = td_init_properties();
+TD_ASSERT(*TD_OK *== td_add_string("first_payment_time", "2018-01-01 01:23:45.678", strlen("2018-01-01 01:23:45.678"), user_properties));
+TD_ASSERT(*TD_OK *== td_user_setOnce("account_id", "distinct_id", user_properties,ta));
+td_free_properties(user_properties);
+
+//first_payment_time仍然为2018-01-01 01:23:45.678
+TDProperties *user_properties2 = td_init_properties();
+TD_ASSERT(*TD_OK *== td_add_string("first_payment_time", "2018-12-31 01:23:45.678", strlen("2018-12-31 01:23:45.678"), user_properties2));
+TD_ASSERT(*TD_OK *== td_user_setOnce("account_id", "distinct_id", user_properties2,ta));
+td_free_properties(user_properties2);
+```
+
+#### 2.3 td_user_add
+
+当您要上传数值型的属性时，您可以调用`t``d``_user_add`来对该属性进行累加操作，如果该属性还未被设置，则会赋值 0 后再进行计算，可传入负值，等同于相减操作。此处以累计付费金额为例：
+
+```
+// 上传用户属性，此时"total_revenue"的值为30
+TDProperties *user_properties = td_init_properties();
+TD_ASSERT(*TD_OK *== td_add_int("total_revenue", 30, user_properties));
+TD_ASSERT(*TD_OK *== td_user_add("account_id", "distinct_id", user_properties, ta));
+td_free_properties(user_properties);
+
+// 上传用户属性，此时"total_revenue"的值为678
+TDProperties *new_user_properties = td_init_properties();
+TD_ASSERT(*TD_OK *== td_add_int("total_revenue",648 , new_user_properties));
+TD_ASSERT(*TD_OK *== td_user_add("account_id", "distinct_id", new_user_properties, ta));
+td_free_properties(new_user_properties);
+```
+
+<!-- unsupported block: 34 -->
+
+设置的属性key为字符串，Value 只允许为数值。
+
+#### 2.4 td_user_append
+
+您可以调用 `t``d``_user_append` 对数组类型的用户属性进行追加操作。
+
+```
+// 此时user_list的属性值为["apple"，"ball"]
+TDProperties *array_properties = td_init_properties();
+TD_ASSERT(*TD_OK *== td_append_array("user_list", "apple", strlen("apple"), array_properties));
+TD_ASSERT(*TD_OK *== td_append_array("user_list", "ball", strlen("ball"), array_properties));
+TD_ASSERT(*TD_OK *== td_user_append("account_id", "distinct_id", array_properties, ta));
+td_free_properties(array_properties);
+
+// 此时user_list的属性值为["apple","apple","ball","cube"]
+TDProperties *new_array_properties = td_init_properties();
+TD_ASSERT(*TD_OK *== td_append_array("user_list", "apple", strlen("apple"), new_array_properties));
+TD_ASSERT(*TD_OK *== td_append_array("user_list", "cube", strlen("cube"), new_array_properties));
+TD_ASSERT(*TD_OK *== td_user_append("account_id", "distinct_id", new_array_properties, ta));
+```
+
+#### 2.5 td_user_uniq_append
+
+您可以调用 `t``d``_user_uniq``_a``ppend` 对 数组类型的用户属性进行追加操作。调用 `t``d``_user_uniq``_a``ppend` 接口会对追加的用户属性进行去重， `t``d``_user_append` 接口不做去重，用户属性可存在重复。
+
+```
+// 此时user_list的属性值为["apple"，"ball"]
+TDProperties *array_properties = td_init_properties();
+TD_ASSERT(*TD_OK *== td_append_array("user_list", "apple", strlen("apple"), array_properties));
+TD_ASSERT(*TD_OK *== td_append_array("user_list", "ball", strlen("ball"), array_properties));
+TD_ASSERT(*TD_OK *== td_user_append("account_id", "distinct_id", array_properties, ta));
+td_free_properties(array_properties);
+
+// 此时user_list的属性值为["apple"，"ball","cube"]
+TDProperties *new_array_properties = td_init_properties();
+TD_ASSERT(*TD_OK *== td_append_array("user_list", "apple", strlen("apple"), new_array_properties));
+TD_ASSERT(*TD_OK *== td_append_array("user_list", "cube", strlen("cube"), new_array_properties));
+TD_ASSERT(*TD_OK *== td_user_uniq_append("account_id","distinct_id", new_array_properties, ta));
+td_free_properties(new_array_properties);
+```
+
+#### 2.6 td_user_unset
+
+当您要清空用户的用户属性值时，您可以调用`t``d``_user_unset`来对指定属性进行清空操作，如果该属性还未在集群中被创建，则`t``d``_user_unset`不会创建该属性
+
+```
+TD_ASSERT(*TD_OK *== td_user_unset("account_id", "distinct_id", "test", ta));
+```
+
+<!-- unsupported block: 34 -->
+
+td_user_unset: 的传入值为被清空属性的 Key 值。
+
+#### 2.7 td_user_delete
+
+如果您要删除某个用户，可以调用`td_user_delete`将这名用户删除，您将无法再查询该名用户的用户属性，但该用户产生的事件仍然可以被查询到，该操作可能产生不可逆的后果，请慎用
+
+```
+TD_ASSERT(*TD_OK *== td_user_delete("account_id", "distinct_id", ta));
+```
+
+### 三、其他功能
+
+#### 3.1 BatchConsumer
+
+::: warning 注意
+
+当数据量过大或者网络异常时，有数据丢失的风险，不建议在正式环境中使用
+
+:::
+
+批量实时地向 AE 服务器传输数据，不需要搭配传输工具，可设置缓存区大小，默认20，即缓存区保留的数据总数最大为20（20为每次上传的batch值，可设置）。
+
+```
+// 首先：修改 CMakeList.txt 文件，打包 TDBatchConsumer 类型的库文件
+
+struct TDAnalytics* ta = NULL;
+struct TDConsumer* consumer = NULL;
+
+//生成config
+TDConfig *config = td_init_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;
+}
+```
+
+参数说明:
+
+- `APPID`: 您的项目的 APPID，可通过在 AE 后台项目管理页面获取
+- `SERVER_URL`: 数据上传的 URL
+- 如果您对接的是云服务，填入: https://global-receiver-ta.thinkingdata.cn 
+- 如果您使用私有化部署版本，请为数据采集地址绑定域名，并配置 HTTPS 证书：https://数据采集地址绑定域名

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-D4KBwg.md

@@ -0,0 +1,211 @@
+---
+code: cpp_server_sdk_installation
+name: "C++"
+wikiToken: D4KBwgaZjiQA3Nklwdtc9z1EnGf
+parentWikiToken: O3YxwgHGiiEnvYkHCcIcX51inkf
+updateTime: 1762772307000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cpp_server_sdk_installation
+---
+# C++
+
+::: tip 提示
+
+ 在接入前, 请先阅读接入前准备。
+
+ c++ 版本要求 c++ 11。需要 g++ 5.1.0 以上版本。
+
+ :::
+
+**最新版本**：v2.0.0
+
+**更新时间**：2023-11-30
+
+**资源下载：**源代码
+
+::: warning 注意
+
+当前文档适用于 v2.0.0 及以后的版本，历史版本请参考 C++ SDK 接入指南（V1）
+
+::: 
+
+### 一、集成SDK
+
+###### Ⅰ. 编译源码，获取`libthinkingdata.a`文件
+
+1. AE SDK 依赖 rapidjson 解析库，你需要下载 rapidjson 库到本地。
+1. 下载 C++ SDK 源码，修改 SDK 中的 `CMakeLists.txt` 文件，选择你需要的数据消费者进行打包（详细内容可以参考SDK源码内的 `CMakeLists.txt` 文件）。这里以最常用的 `log``consumer` 举例：
+```
+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()
+```
+
+1. rapidjson 库是一个纯 `.h` 库，所以以头文件的形式引入到你的工程。
+1. 如果你的工程没有引入 rapidjson 库，那么请导入如下头文件即可：
+
+1. 如果你的工程之前已经引入了 rapidjson 库，那么请只需导入 AE SDK 的头文件。然后需要修改并确认 `TDJsonParse.h` 文件内的内容，核对文件内对  rapidjson 库的引入路径是否正确：
+###### Ⅱ. 安装Logbus
+
+我们推荐使用SDK+LogBus的形式，完成服务端数据的采集上报.您可以参考以下文档完成Logbus的安装:LogBus使用指南
+
+### 二、初始化
+
+导入头文件：
+
+```
+#include "../include/TDAnalytics.h"
+#include "../include/TDLoggerConsumer.h"
+#include "../include/TDDebugConsumer.h"
+#include "../include/TDBatchConsumer.h"
+
+using namespace thinkingDataAnalytics;
+```
+
+以下是SDK初始化的示例代码:
+
+```
+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`为写入本地的文件夹地址。您只需将 LogBus 的监听文件夹地址设置为此处的地址，即可使用 LogBus 进行数据的监听上传。
+
+### 三、常用功能
+
+为了保证访客 ID 与账号 ID 能够顺利进行绑定，如果您的游戏中会用到访客 ID 与账号 ID，我们极力建议您同时上传这两个 ID，否则将会出现账号无法匹配的情况，导致用户重复计算，具体的 ID 绑定规则可参考用户识别规则一章。
+
+#### 3.1 发送事件
+
+您可以调用`track`来上传事件，建议您根据先前梳理的文档来设置事件的属性以及发送信息的条件，以下是发送事件的示例代码:
+
+```
+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);
+```
+
+- 事件的名称是字符串类型，只能以字母开头，可包含数字，字母和下划线 "_"，长度最大为 50 个字符。
+- Key 为该属性的名称，为字符串类型，规定只能以字母开头，包含数字，字母和下划线 "_"，长度最大为 50 个字符，对字母大小写不敏感,TE会统一转化为小写字母
+- Value 为该属性的值，支持字符串、数字、布尔、时间、对象、对象组、数组
+<!-- unsupported block: 34 -->
+
+**用户属性的要求与事件属性保持一致**
+
+#### 3.2 设置用户属性
+
+对于一般的用户属性，您可以调用 `user_set` 来进行设置，使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例：
+
+```
+// user_set
+TDPropertiesNode userSet_properties;
+userSet_properties.SetString("userName", "test");
+// 上传用户属性
+te.user_set("accountId", "distinctId", userSet_properties);
+```
+
+#### 3.3 数据上报
+
+使用 `TDLoggerConsumer` 时，采集到的事件会先转成 json 字符串，然后添加到缓存数组中。当数组元素个数超出设置的容量时才会将数据写入磁盘。默认容量限制为20条数据。
+
+在某些业务场景下，如果您期望数据立即上报到TE服务器，可以通过调用`flush()`接口完成。需要注意，频繁调用`flush()`会导致服务性能下降。
+
+```
+te.flush();
+```
+
+#### 3.4 关闭SDK
+
+```
+te.close();
+```
+
+<!-- unsupported block: 34 -->
+
+关闭并退出 SDK，请在关闭服务器前调用本接口，以避免缓存内的数据丢失
+
+### 四、最佳实践
+
+以下示例代码包含以上所有操作，我们推荐按照如下步骤使用:
+
+```
+// 导入头文件(每个平台以及IDE的路径不一样，自行适合调整)
+#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);
+
+// 调用flush接口数据会立即写入文件，生产环境注意避免频繁调用flush引发IO或网络开销问题
+// 一般情况不需要手动调用
+te.flush();
+```

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-HF7Dwv.md

@@ -0,0 +1,169 @@
+---
+code: csharp_sdk_installation
+name: "C#"
+wikiToken: HF7Dwv171ibMQtkmV1UcOhownPc
+parentWikiToken: O3YxwgHGiiEnvYkHCcIcX51inkf
+updateTime: 1756884342000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=csharp_sdk_installation
+---
+# C#
+
+::: tip 提示
+
+ 在接入前, 请先阅读接入前准备。
+
+ :::
+
+**最新版本为**：v2.0.3
+
+**更新时间为**：2025-09-03
+
+**资源下载****：**源代码
+
+::: warning 注意
+
+当前文档适用于 v2.0.0 及以后的版本，历史版本请参考 C# SDK 接入指南（V1）
+
+::: 
+
+### 一、集成SDK
+
+#### 方式一：NuGet 集成
+
+1. 在 NuGet 中搜索 ThinkingDataAnalytics 库，安装到你的项目中
+1. ThinkingDataAnalytics 库同时会自动安装 Newtonsoft.Json 库
+#### 方式二：集成 dll 文件
+
+1. 下载 SDK 源码
+1. 打开源码中的解决方案，手动编译出 SDK 的 dll 文件
+1. 将 ThinkingDataAnalytics SDK 的 dll 文件引入到你的工程
+1. SDK 依赖 Newtonsoft.Json 框架用作json解析，请手动添加 Newtonsoft.Json 库到你的项目。
+#### 安装Logbus
+
+我们推荐使用SDK+LogBus的形式，完成服务端数据的采集上报.您可以参考以下文档完成Logbus的安装:LogBus使用指南
+
+### 二、初始化
+
+以下是SDK初始化的示例代码:
+
+```
+using ThinkingData.Analytics
+
+TDAnalytics te = new TDAnalytics(new TDLoggerConsumer("LOG_DIRECTORY"));
+```
+
+`LOG_DIRECTORY`为写入本地的文件夹地址。您只需将 LogBus 的监听文件夹地址设置为此处的地址，即可使用 LogBus 进行数据的监听上传。
+
+### 三、常用功能
+
+为了保证访客 ID 与账号 ID 能够顺利进行绑定，如果您的游戏中会用到访客 ID 与账号 ID，我们极力建议您同时上传这两个 ID，否则将会出现账号无法匹配的情况，导致用户重复计算，具体的 ID 绑定规则可参考用户识别规则一章。
+
+#### 3.1 发送事件
+
+您可以调用`track`来上传事件，建议您根据先前梳理的文档来设置事件的属性以及发送信息的条件，以下是发送事件的示例代码:
+
+```
+Dictionary<string, object> properties = new Dictionary<string, object>();
+// 设置用户的ip地址，TE系统会根据IP地址解析用户的地理位置信息
+properties.Add("#ip", "123.123.123.123");
+//设置事件属性
+properties.Add("channel", "TE");//字符串
+properties.Add("age", 1);//数字
+properties.Add("is_success", true);//布尔value
+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);
+
+//上报带有自定义属性的事件，accountId 和 distinctId至少一个不为空
+te.Track("accountId", "distinctId", "Payment", properties);
+```
+
+- 事件的名称是字符串类型，只能以字母开头，可包含数字，字母和下划线 "_"，长度最大为 50 个字符。
+- Key 为该属性的名称，为字符串类型，规定只能以字母开头，包含数字，字母和下划线 "_"，长度最大为 50 个字符，对字母大小写不敏感,TE会统一转化为小写字母
+- Value 为该属性的值，支持字符串、数字、布尔、时间、对象、对象组、数组
+<!-- unsupported block: 34 -->
+
+**用户属性的要求与事件属性保持一致**
+
+#### 3.2 设置用户属性
+
+对于一般的用户属性，您可以调用 `UserSet` 来进行设置，使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例：
+
+```
+//此时username为TA
+Dictionary<string, object> properties= new Dictionary<string, object>();
+properties.Add("user_name","TA");
+te.UserSet("accountId","distinctId", properties);
+//此时userName为TE
+Dictionary<string, object> newProperties= new Dictionary<string, object>();
+newProperties.Add("user_name","TE");
+//设置用户属性，accountId 和 distinctId 必须至少设置其中一个
+te.UserSet("accountId","distinctId", newProperties);
+```
+
+#### 3.3 数据上报
+
+使用 TDLoggerConsumer 时，采集到的事件会先编码成 json 字符串，然后添加到缓存字符串中。当缓存字符串长度超出设置的长度时才会将数据写入磁盘。默认最大长度为 8192。
+
+在某些业务场景下，如果您期望数据立即上报到TE服务器，可以通过调用`flush()`接口完成。需要注意，频繁调用`flush()`会导致服务性能下降。
+
+```
+te.Flush();
+```
+
+#### 3.4 关闭SDK
+
+```
+te.Close();
+```
+
+<!-- unsupported block: 34 -->
+
+关闭并退出 SDK，请在关闭服务器前调用本接口，以避免缓存内的数据丢失
+
+### 四、最佳实践
+
+以下示例代码包含以上所有操作，我们推荐按照如下步骤使用:
+
+```
+using ThinkingData.Analytics
+//初始化SDK
+TDAnalytics te = new TDAnalytics(new TDLoggerConsumer("LOG_DIRECTORY"));
+
+Dictionary<string, object> properties = new Dictionary<string, object>();
+// 设置用户的ip地址，TE系统会根据IP地址解析用户的地理位置信息
+properties.Add("#ip", "123.123.123.123");
+//设置事件属性
+properties.Add("channel", "TE");//字符串
+properties.Add("age", 1);//数字
+properties.Add("is_success", true);//布尔value
+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);
+
+//上报带有自定义属性的事件，accountId 和 distinctId至少一个不为空
+te.Track("accountId", "distinctId", "Payment", properties);
+
+//此时username为TA
+Dictionary<string, object> userProperties = new Dictionary<string, object>();
+userProperties.Add("user_name", "TA");
+te.UserSet("accountId", "distinctId", userProperties);
+
+//调用flush接口数据会立即写入文件，生产环境注意避免频繁调用flush引发IO或网络开销问题
+te.Flush();
+```