@thinkingai/ae-cli 1.0.28 → 6.0.16

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

@@ -0,0 +1,116 @@
+---
+code: python_sdk_installation
+name: "Python"
+wikiToken: YoPdwzGBMiRyS7kTY5pcmWHpnjf
+parentWikiToken: IKVPwn4NfiIhijk5EcAcMf6pn7e
+updateTime: 1774252012000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=python_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: **v3.0.0
+**Update time: **2023-10-07
+**Resource download: **[Source Code](https%3A%2F%2Fgithub.com%2FThinkingDataAnalytics%2Fpython-sdk)
+::: warning Notice 
+Current documentation applies to v3.0.0 and later. For historical versions, see [Data Ingestion Guide - Python (V2)](https%3A%2F%2Fdocs.thinkingdata.cn%2Fta-manual%2Fv4.1%2Fen%2Finstallation%2Finstallation_menu%2Fserver_sdk%2Fpython_sdk_installation%2Fpython_sdk_installation.html) 
+:::
+## **SDK**** Integration**
+1.1 Get Python SDK through `pip`
+```shell
+# install SDK
+pip install ThinkingDataSdk
+
+# update SDK
+pip install --upgrade ThinkingDataSdk
+```
+
+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:
+```python
+from tgasdk.sdk import *
+te = TDAnalytics(TDLogConsumer("LOG_DIRECTORY"))
+```
+
+`LOG_DIRECTORY` is the path of the folder written to the local directory. You need to set the `LogBus` listening folder address to this address in order to use `LogBus` for data listening upload.
+`LOG_FILE_PREFIX` Indicates the prefix of the log file name.
+## **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:
+```python
+distinct_id = "ABCDEF123456"
+account_id = "TE10001"
+properties = {
+    "#time": datetime.datetime.now(),
+    "#ip": "192.168.1.1",
+    "Product_Name": "商品名",
+    "Price": 30,
+    "OrderId": "订单号abc_123"
+}
+try:
+    te.track(distinct_id, account_id, "Payment", properties)
+except Exception as e:
+    print(e)
+```
+
+- 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: 
+```python
+properties = {"user_name": "ABC"}
+try:
+    te.user_set(account_id="account_id", distinct_id="distinct_id", properties=properties)
+except Exception as e:
+    print(e)
+```
+
+### 3.3 Reported data
+When using `TDLogConsumer`, 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 5. You can set the size of `buffer_size` in the `TDLogConsumer` constructor.
+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.
+```python
+te.flush();
+```
+
+### 3.4 Close  SDK
+```python
+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:
+```python
+from tgasdk.sdk import *
+
+te = TDAnalytics(TDLogConsumer("LOG_DIRECTORY"))
+
+properties = {
+    "#time": datetime.datetime.now(),  
+    "#ip": "192.168.1.1", 
+    "Product_Name": "goods_name"
+}
+try:
+    te.track("distinct_id", "account_id", "Payment", properties)
+except Exception as e:
+    print(e)
+
+user_properties = {"user_name": "ABC"}
+try:
+    te.user_set(account_id="account_id", distinct_id="distinct_id", properties=user_properties)
+except Exception as e:
+    print(e)
+
+te.flush()
+```

package/wiki/te-docs/raw/data-ingestion-guide/server-sdk/ruby/release-notes.md

@@ -0,0 +1,44 @@
+---
+code: ruby_sdk_release_note
+name: "Release Notes"
+wikiToken: NuXswgQPZi5K9OkaxzWctlxcnMe
+parentWikiToken: S8vpwcvIxiPflykjVPScH7dTnyd
+updateTime: 1780898293000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=ruby_sdk_release_note
+---
+
+## v2.0.2
+**Date: 2026/06/05**
+**Notes：**
+- Supports multi-threaded invocation
+## v2.0.1
+**Date: 2026/05/13**
+**Notes：**
+- Supports multi-threaded invocation
+## v2.0.0
+**Date: 2023/09/20**
+**Notes：**
+- Modified module name, incompatible with older versions
+## v1.2.1
+**Date: 2023/03/20**
+**Notes：**
+- Compatible ruby 3
+- Supports a different '#app_id' for each event
+## v1.2.0
+**Date：****2020/08/28**
+**Notes：**
+- Added track_update interface to support updatable events
+- Added track_overwrite interface to support rewritable events
+## v1.1.0
+**Date：****2020/02/11**
+**Notes：**
+- Data type support array type
+- Added user_append interface to support attribute appending of user's array type
+- BatchConsumer performance optimization: support to choose whether to compress; remove Base64 encoding
+- DebugConsumer Optimization: More complete and accurate validation of data at the server level
+## v1.0.0
+**Date：****2019-11-20**
+**Notes：**
+- Support three modes of reporting: DebugConsumer, BatchConsumer, LoggerConsumer.
+- Support event reporting and user feature reporting.
+- Supports public event properties.

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

@@ -0,0 +1,47 @@
+---
+code: ruby_sdk_debug
+name: "Debugging and Logging"
+wikiToken: VpzSwR4BZiAigmkidffcx4n0nHc
+parentWikiToken: CKuawiPqPi1o3pkdExtc3VB7nsn
+updateTime: 1774249288000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=ruby_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.
+## Logging
+```python
+ThinkingData::set_enable_log(true)
+```
+
+## 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:
+```python
+consumer = ThinkingData::TDDebugConsumer.new('SERVER_URL', 'APPID', device_id: "123456789")
+te = ThinkingData::TDAnalytics.new(consumer)
+
+DEMO_ACCOUNT_ID = '123'
+DEMO_DISTINCT_ID = 'aaa'
+
+properties = {
+  array: ["str1", "11", Time.now, "2020-02-11 17:02:52.415"],
+  prop_date: Time.now,
+  prop_double: 134.1,
+  prop_string: 'hello world',
+  prop_bool: true,
+}
+
+ta.track(event_name: 'test_event', distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: properties)
+```
+
+#### 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="WsAdb3pD5ohbjIxmizDcJO5onIg" 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/ruby/ruby-advanced/preset-properties.md

@@ -0,0 +1,126 @@
+---
+code: ruby_sdk_preset_properties
+name: "Preset Properties"
+wikiToken: Chi4w6Kkpixz5lk5zdKckvOrnWe
+parentWikiToken: CKuawiPqPi1o3pkdExtc3VB7nsn
+updateTime: 1774249290000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=ruby_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>

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

@@ -0,0 +1,189 @@
+---
+code: ruby_sdk_advanced
+name: "Ruby-Advanced"
+wikiToken: CKuawiPqPi1o3pkdExtc3VB7nsn
+parentWikiToken: S8vpwcvIxiPflykjVPScH7dTnyd
+updateTime: 1774249286000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=ruby_sdk_advanced
+---
+
+## **Sending Events**
+After SDK is initialized, you can track user behaviour data. In general, ordinary events could meet business requirements. You can also use the First/Updatable Event based on your own business requirements.
+### 1.1 **Ordinary Events**
+ You can call `track` to upload events. It is suggested that you set event properties  based on the document about data tracking drafted previously. Procurement of a commodity by a user is taken as the example here:
+```ruby
+DEMO_ACCOUNT_ID = '123'
+DEMO_DISTINCT_ID = 'aaa'
+
+properties = {
+  array: ["str1", "11", Time.now, "2020-02-11 17:02:52.415"],
+  prop_date: Time.now,
+  prop_double: 134.1,
+  prop_string: 'hello world',
+  prop_bool: true,
+}
+
+ta.track(event_name: 'test_event', distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: properties)
+```
+
+### 1.2 **First Events**
+The First Events refers to events that would only be recorded once for the ID of a certain device or other dimensions.   For example, under certain scenarios, you may want to record the activation event on a certain device.   In this case, you can perform data tracking with the First Event.
+If you want to judge whether an event is the First Event from other dimensions, you can define a first_check_id for the First Event:
+```ruby
+DEMO_ACCOUNT_ID = '123'
+DEMO_DISTINCT_ID = 'aaa'
+
+properties = {
+  array: ["str1", "11", Time.now, "2020-02-11 17:02:52.415"],
+  prop_date: Time.now,
+  prop_double: 134.1,
+  prop_string: 'hello world',
+  prop_bool: true,
+}
+ta.track(event_name: 'test_event', distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, first_check_id:'first_id', properties: properties)
+```
+
+<quote-container>
+Note: Since the server has to check whether the event is the First Event, the First Event will be put in storage one hour later by default.
+</quote-container>
+
+### 1.3 ** Updatable Events**
+You can meet the requirements for event data modification under specific scenarios through Updatable Event. The TE would determine the data to be updated according to the event name and event ID.
+```ruby
+DEMO_ACCOUNT_ID = '123'
+DEMO_DISTINCT_ID = 'aaa'
+
+properties = {
+  array: ["str1", "11", Time.now, "2020-02-11 17:02:52.415"],
+  prop_date: Time.now,
+  prop_double: 134.1,
+  prop_string: 'hello world',
+  prop_bool: true,
+}
+ta.track_update(event_name: 'update', event_id: 'id123', distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties:properties)
+```
+
+### 1.4 **Overwritable Event****s**
+Despite the similarity with Updatable Event, Overwritable Event would cover all historical data with the latest data. Looking from the perspective of effect, such a process is equivalent to the behavior of deleting the previous data while putting the latest data in storage. The TE would determine the data to be updated according to the event name and event ID.
+```ruby
+DEMO_ACCOUNT_ID = '123'
+DEMO_DISTINCT_ID = 'aaa'
+
+properties = {
+  array: ["str1", "11", Time.now, "2020-02-11 17:02:52.415"],
+  prop_date: Time.now,
+  prop_double: 134.1,
+  prop_string: 'hello world',
+  prop_bool: true,
+}
+ta.track_overwrite(event_name: 'update', event_id: 'id123', distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties:properties)
+```
+
+## **User Properties**
+User property setting APIs supported by the TE  include: `user_set`, `user_set_once`, `user_add`, `user_append`, `user_uniq_append`, `user_unset`, `user_del`.
+### 2.1 user_set
+You can call `user_set` to set general user properties. The original properties would be replaced if the properties uploaded via the API are used. If  user properties are not set before, user properties will be 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:
+```ruby
+DEMO_ACCOUNT_ID = '123'
+DEMO_DISTINCT_ID = 'aaa'
+
+user_data = {
+  array: ["str1", 11, 22.22],
+  prop_double: 134.12,
+  prop_string: 'hello',
+  prop_int: 666,
+}
+ta.user_set(distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: user_data)
+```
+
+### 2.2 user_set_once
+If the user property you want to upload only needs to be set once, you can call `user_set_once` to set the property. If such property had been set before, this message would be ignored. Let's take the setting of the first payment time as an example:：
+```ruby
+user_set_once_data = {
+  prop_int_new: 888,
+}
+ta.user_set_once(distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: user_set_once_data)
+```
+
+### 2.3 user_add
+When you want to upload numeric property for cumulative operation, you can call `user_add`.
+If the property has not been set, it would be given a value of 0 before computing. A negative value could be uploaded, which is equivalent to subtraction operation. Let's take the accumulative payment amount as an example:
+```ruby
+ta.user_add(distinct_id: DEMO_DISTINCT_ID, properties: {prop_int: 10, prop_double: 15.88})
+```
+
+<quote-container>
+The property key is a string, and the value is only allowed to be a numeric value.
+</quote-container>
+
+### 2.4 user_append
+You can call `user_append` to add user properties of array type.
+```ruby
+user_append_data = {
+  array: %w[33 44]
+}
+ta.user_append(distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: user_append_data)
+
+user_append_data_new = {
+  array: %w[44 55]
+}
+ta.user_append(distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: user_append_data_new)
+```
+
+### 2.5 user_uniq_append
+You can delete duplicated user property by calling `user_uniq_append` interface. If you call `user_append` interface, duplicated user property might not be deleted.
+```ruby
+user_append_data = {
+  array: %w[33 44]
+}
+ta.user_append(distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: user_append_data)
+
+user_uniq_append_data = {
+  array: %w[44 55]
+}
+ta.user_uniq_append(distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: user_uniq_append_data)
+```
+
+### 2.6 user_unset
+When you need to clear the user properties of users, you can call `user_unset` to clear specific properties.  `user_unset` would not create properties that have not been created in the cluster.
+```ruby
+ta.user_unset(distinct_id: DEMO_DISTINCT_ID, property: [:prop_string, :prop_int])
+```
+
+### 2.7 user_del
+You can call `user_del` to delete a user. After deleting the user, you would no longer be able to inquire about its user property, but could still query the events triggered by the user.
+```ruby
+ta.user_del(distinct_id: DEMO_DISTINCT_ID)
+```
+
+## **Other**
+### 3.1 BatchConsumer
+::: warning Notice
+When the amount of data is too large or the network is abnormal, there is a risk of data loss. And it is not recommended to use it in a production environment
+:::
+Batches transmit data to the TE in real time, without the need for a transmission tool. 
+```ruby
+consumer = ThinkingData::TDBatchConsumer.new('SERVER_URL', 'APPID', 30)
+ta = ThinkingData::TDAnalytics.new(consumer)
+
+DEMO_ACCOUNT_ID = '123'
+DEMO_DISTINCT_ID = 'aaa'
+
+properties = {
+  array: ["str1", "11", Time.now, "2020-02-11 17:02:52.415"],
+  prop_date: Time.now,
+  prop_double: 134.1,
+  prop_string: 'hello world',
+  prop_bool: true,
+}
+
+ta.track(event_name: 'test_event', distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: properties)
+```
+
+Instruction on parameters:
+- `APPID`: The APPID of your project, which can be found on the project management page of  TE.
+- `SERVER_URL`: 
+  - If you are using a SaaS version, please check the receiver URL on this page
+<image token="FlHEbKx8moxDYmxoD91ccNgynic" width="1674" height="1318" align="center"/>
+
+- If you use the private deployment version, you can customize the data tracking URL .

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

@@ -0,0 +1,142 @@
+---
+code: ruby_sdk_installation
+name: "Ruby"
+wikiToken: S8vpwcvIxiPflykjVPScH7dTnyd
+parentWikiToken: IKVPwn4NfiIhijk5EcAcMf6pn7e
+updateTime: 1780898277000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=ruby_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.2
+**Update time**: 2026-06-05
+**Resource download**: [Source Code](https%3A%2F%2Fgithub.com%2FThinkingDataAnalytics%2Fruby-sdk)
+::: warning Notice 
+Current documentation applies to v3.0.0 and later. For historical versions, see [Data Ingestion Guide - Ruby (V1)](https%3A%2F%2Fdocs.thinkingdata.cn%2Fta-manual%2Fv4.1%2Fen%2Finstallation%2Finstallation_menu%2Fserver_sdk%2Fruby_sdk_installation%2Fruby_sdk_installation.html) 
+:::
+## **SDK**** Integration**
+1.1 Please use `gem` command to get the SDK package.
+```shell
+# install SDK
+gem install thinkingdata-ruby
+```
+
+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:
+```ruby
+require 'thinkingdata-ruby'
+
+consumer = ThinkingData::TDLoggerConsumer.new("LOG_DIRECTORY")
+ta = ThinkingData::TDAnalytics.new(consumer)
+```
+
+`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:
+```ruby
+DEMO_ACCOUNT_ID = '123'
+DEMO_DISTINCT_ID = 'aaa'
+
+properties = {
+  array: ["str1", "11", Time.now, "2020-02-11 17:02:52.415"],
+  prop_date: Time.now,
+  prop_double: 134.1,
+  prop_string: 'hello world',
+  prop_bool: true,
+}
+
+ta.track(event_name: 'test_event', distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, 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 `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: 
+```ruby
+DEMO_ACCOUNT_ID = '123'
+DEMO_DISTINCT_ID = 'aaa'
+
+user_data = {
+  array: ["str1", 11, 22.22],
+  prop_date: Time.now,
+  prop_double: 134.12,
+  prop_string: 'hello',
+  prop_int: 666,
+}
+ta.user_set(distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: user_data)
+```
+
+### 3.3 Reported data
+When `TDLoggingConsumer` is used, the SDK will write the collected data to disk in real time.
+### 3.4 Close  SDK
+```ruby
+ta.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:
+```ruby
+require 'thinkingdata-ruby'
+
+ThinkingData::set_stringent(false)
+ThinkingData::set_enable_log(false)
+
+consumer = ThinkingData::TDLoggerConsumer.new( 'LOG_DIRECTORY', 'hourly')
+ta = ThinkingData::TDAnalytics.new(consumer, my_error_handler, uuid: true)
+
+DEMO_ACCOUNT_ID = '123'
+DEMO_DISTINCT_ID = 'aaa'
+
+properties = {
+  array: ["str1", "11", Time.now, "2020-02-11 17:02:52.415"],
+  prop_date: Time.now,
+  prop_double: 134.1,
+  prop_string: 'hello world',
+  prop_bool: true,
+}
+
+ta.track(event_name: 'test_event', distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: properties)
+
+user_data = {
+  array: ["str1", 11, 22.22],
+  prop_date: Time.now,
+  prop_double: 134.12,
+  prop_string: 'hello',
+  prop_int: 666,
+}
+ta.user_set(distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: user_data)
+
+user_append_data = {
+  array: %w[33 44]
+}
+ta.user_append(distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: user_append_data)
+
+user_uniq_append_data = {
+  array: %w[44 55]
+}
+ta.user_uniq_append(distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: user_uniq_append_data)
+
+user_set_once_data = {
+  prop_int_new: 888,
+}
+ta.user_set_once(distinct_id: DEMO_DISTINCT_ID, account_id: DEMO_ACCOUNT_ID, properties: user_set_once_data)
+
+ta.user_add(distinct_id: DEMO_DISTINCT_ID, properties: {prop_int: 10, prop_double: 15.88})
+
+ta.user_unset(distinct_id: DEMO_DISTINCT_ID, property: [:prop_string, :prop_int])
+
+ta.user_del(distinct_id: DEMO_DISTINCT_ID)
+```

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

@@ -0,0 +1,22 @@
+---
+code: server_sdk_menu
+name: "Server SDK"
+wikiToken: IKVPwn4NfiIhijk5EcAcMf6pn7e
+parentWikiToken: AWr4wIMGYi9FB7ksPi4c17kNnxh
+updateTime: 1774252005000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=server_sdk_menu
+---
+
+- The server SDK mainly includes:
+[<text underline="true">Golang</text>](https://thinkingdata.feishu.cn/wiki/GVHiwdEmWixRWrk0ZdKcT2twnSn)
+[<text underline="true">Java</text>](https://thinkingdata.feishu.cn/wiki/BuVmwRcFsi4Oq5knoDDcgJ3fnSN)
+[<text underline="true">C </text>](https://thinkingdata.feishu.cn/wiki/Er3owqC0UiRR21kCDgZcY4qJn3e)
+[<text underline="true">Node</text>](https://thinkingdata.feishu.cn/wiki/OoIKwLEiNiPgzhksi3xcUBEknbb)[<text underline="true">.js</text>](https://thinkingdata.feishu.cn/wiki/OoIKwLEiNiPgzhksi3xcUBEknbb)
+[<text underline="true">Python </text>](https://thinkingdata.feishu.cn/wiki/YoPdwzGBMiRyS7kTY5pcmWHpnjf)
+[<text underline="true">Ruby</text>](https://thinkingdata.feishu.cn/wiki/S8vpwcvIxiPflykjVPScH7dTnyd)
+[C#](https://thinkingdata.feishu.cn/wiki/V2W3wvcfkiGW3lk9rrDcnosAnqi)
+[PHP](https://thinkingdata.feishu.cn/wiki/G0BrwOPbXiAtIikbcv3cMEyonTf)
+[Lua](https://thinkingdata.feishu.cn/wiki/CLL4wjPKtiEhkjkmbIqcrn3CnXd)
+[C++](https://thinkingdata.feishu.cn/wiki/Zf9Jwl81biGtrbkmBhackD1Fn3c)
+[ErLang](https://thinkingdata.feishu.cn/wiki/HCbFw6wKsiAj0Qkst6cctv3AnIf)
+