@thinkingai/ae-cli 1.0.30 → 6.0.16

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

@@ -0,0 +1,141 @@
+---
+code: nodejs_sdk_installation
+name: "Node.js"
+wikiToken: OoIKwLEiNiPgzhksi3xcUBEknbb
+parentWikiToken: IKVPwn4NfiIhijk5EcAcMf6pn7e
+updateTime: 1774252010000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=nodejs_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: **1.5.0
+**Update time:** 2024-03-26
+**Resource download: **[**Source Code**](https%3A%2F%2Fgithub.com%2FThinkingDataAnalytics%2Fnode-sdk)
+## **SDK**** Integration**
+1.1 Please use `npm` to get the Node.js SDK:
+```shell
+# install SDK
+npm install thinkingdata-node --save
+
+# update SDK
+npm i thinkingdata-node@{version}
+```
+
+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:
+```javascript
+const ThinkingData = require('thinkingdata-node');
+
+let teSDK = ThinkingData.initWithLoggingMode('LOG_DIRECTORY', {
+    filePrefix: 'test',
+    rotateHourly: true
+});
+```
+
+`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:
+```javascript
+let trackEvent = {
+    accountId: '2222',
+    distinctId: '1111',
+    event: 'test_event',
+    time: new Date(),
+    ip: '202.38.64.1',
+    properties: {
+        prop_double: 134.1,
+    },
+    callback(e) {
+        if (e) {
+            console.log(e);
+        }
+    }
+};
+
+teSDK.track(trackEvent)
+```
+
+- 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: 
+```javascript
+let userSetData = {
+    accountId: 'node_test',
+    properties: {
+        prop_date: new Date(),
+        prop_double: 134.12,
+        prop_string: 'hello',
+        prop_int: 666,
+        prop_array: ['str1', 'str2'],
+    },
+    callback(e) {
+        if (e) {
+            console.log(e);
+        }
+    }
+};
+
+teSDK.userSet(userSetData);
+```
+
+### 3.3 Reported data
+When `TDLoggingConsumer` is used, the SDK will write the collected data to disk in real time.
+### 3.4 Close  SDK
+```javascript
+teSDK.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:
+```javascript
+var teSDK = ThinkingData.initWithLoggingMode('LOG_DIRECTORY');
+let trackEvent = {
+    accountId: '2222',
+    distinctId: '1111',
+    event: 'test_event',
+    time: new Date(),
+    ip: '202.38.64.1',
+    properties: {
+        prop_double: 134.1,
+    },
+    callback(e) {
+        if (e) {
+            console.log(e);
+        }
+    }
+};
+
+teSDK.track(trackEvent)
+let userSetData = {
+    accountId: 'node_test',
+    properties: {
+        prop_date: new Date(),
+        prop_double: 134.12,
+        prop_string: 'hello',
+        prop_int: 666,
+        prop_array: ['str1', 'str2'],
+    },
+    callback(e) {
+        if (e) {
+            console.log(e);
+        }
+    }
+};
+
+teSDK.userSet(userSetData);
+```

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

@@ -0,0 +1,41 @@
+---
+code: php_sdk_debug
+name: "Debugging and Logging"
+wikiToken: AwNYwWUD6i1vIxk2yvccxLNbn9U
+parentWikiToken: G4igw6q4gieQcgkEQxRcPW5XnVb
+updateTime: 1774249308000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=php_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
+```php
+TDLog::$enable = 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:
+```php
+try {
+    $deviceId = "123";
+    $debugConsumer = new TDDebugConsumer("SERVER_URL", "APP_ID", 1000, $deviceId);
+    $debugConsumer->setDebugOnly(false);
+    $te = new TDAnalytics($debugConsumer);
+} catch (Exception $e) {
+    echo $e;
+}
+```
+
+#### 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="TOXubQvsSoZLfoxhvIScdmMvn2g" 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/php/php-advanced/preset-properties.md

@@ -0,0 +1,126 @@
+---
+code: php_sdk_preset_properties
+name: "Preset Properties"
+wikiToken: LcUuw6npci86jwkSsulc5qXhnGb
+parentWikiToken: G4igw6q4gieQcgkEQxRcPW5XnVb
+updateTime: 1774249310000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=php_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/php/php-advanced.md

@@ -0,0 +1,216 @@
+---
+code: php_sdk_advanced
+name: "PHP-Advanced"
+wikiToken: G4igw6q4gieQcgkEQxRcPW5XnVb
+parentWikiToken: G0BrwOPbXiAtIikbcv3cMEyonTf
+updateTime: 1774249306000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=php_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:
+```php
+$properties = array();
+$properties["product_name"] = "book";
+try {
+    $te->track("distinctId", "accountId", "productBuy", $properties);
+} catch (Exception $e) {
+    echo $e;
+}
+```
+
+### 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:
+```php
+$properties = array();
+$properties["price"] = 100;
+$properties["status"] = 3;
+$firstCheckId = "first_flag_id";
+try {
+    $te->track_first("distinctId", "accountId", "device_activation", $firstCheckId, $properties);
+} catch (Exception $e) {
+    echo $e;
+}
+```
+
+<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.
+```php
+$properties = array();
+$properties["price"] = 100;
+$properties["status"] = 3;
+$eventId = "eventId";
+try {
+    $te->track_update("distinctId", "accountId", "eventName", $eventId, $properties);
+} catch (Exception $e) {
+    echo $e;
+}
+
+$properties1 = array();
+$properties1["status"] = 5;
+try {
+    $te->track_update("distinctId", "accountId", "eventName", $eventId, $properties1);
+} catch (Exception $e) {
+    echo $e;
+}
+```
+
+### 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.
+```php
+$properties = array();
+$properties["price"] = 100;
+$properties["status"] = 3;
+$eventId = "eventId";
+try {
+    $te->track_overwrite("distinctId", "accountId", "eventName", $eventId, $properties);
+} catch (Exception $e) {
+    echo $e;
+}
+
+$properties1 = array();
+$properties1["status"] = 5;
+try {
+    $te->track_overwrite("distinctId", "accountId", "eventName", $eventId, $properties1);
+} catch (Exception $e) {
+    echo $e;
+}
+```
+
+## **User Properties**
+User property setting APIs supported by the TE  include: `user_set`, `user_setOnce`, `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:
+```php
+$properties = array();
+
+$properties["user_name"] = "ABC";
+try{
+    $te->user_set('distinct_id', 'account_id', $properties);
+}catch (Exception $e){
+    echo $e;
+}
+
+$properties["user_name"] = "XYZ";
+try{
+    $te->user_set('distinct_id', 'account_id', $properties);
+}catch (Exception $e){
+    echo $e;
+}
+```
+
+### 2.2 user_setOnce
+If the user property you want to upload only needs to be set once, you can call `user_setOnce` 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:
+```php
+$properties = array();
+
+$properties["user_name"] = "ABC";
+try{
+    $te->user_setOnce('distinct_id', 'account_id', $properties);
+} catch (Exception $e){
+    echo $e;
+}
+
+$properties["user_name"] = "XYZ";
+$properties["user_age"] = 18;
+try{
+    $te->user_setOnce('distinct_id', 'account_id', $properties);
+} catch (Exception $e){
+    echo $e;
+}
+```
+
+### 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:
+```php
+try{
+    $properties = array();
+    $properties['level'] = 2;
+    $te->user_add('distinct_id', 'account_id', $properties);
+} catch (Exception $e){
+    //handle except
+    echo $e;
+}
+```
+
+<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.
+```php
+try{
+    $properties = array();
+    $properties['arr'] = ['str3','str4'];
+    $te->user_append('distinct_id', 'account_id', $properties);
+} catch (Exception $e){
+    //handle except
+    echo $e;
+}
+```
+
+### 2.5 user_uniq_append
+You can delete duplicated user property by calling `user_uniq_append` API. If you call `user_append` API, duplicated user property might not be deleted.
+```php
+try{
+    $properties = array();
+    $properties['arr'] = ['str3','str4'];
+    $te->user_uniq_append('distinct_id', 'account_id', $properties);
+}catch (Exception $e){
+    //handle except
+    echo $e;
+}
+```
+
+### 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.
+```php
+$properties1 = array(
+    'age', "update_time"
+);
+try {
+    $te->user_unset(null, 'account_id', $properties1);
+} catch (Exception $e) {
+    //handle except
+    echo $e;
+}
+```
+
+### 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.
+```php
+try{
+    $te->user_del('distinct_id', 'account_id');
+}catch (Exception $e){
+    echo $e;
+}
+```
+
+
+## **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.
+```php
+require "TaPhpSdk.php";
+$te = new TDAnalytics(new TDBatchConsumer("SERVER_URL","APP_ID"));
+```
+
+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="E18LbtFm4ogabLxmuyLcgicfnbh" 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/php/release-notes.md

@@ -0,0 +1,45 @@
+---
+code: php_sdk_release_note
+name: "Release Notes"
+wikiToken: GwAqwKHv3iluiqk6d5zc7gvdnjK
+parentWikiToken: G0BrwOPbXiAtIikbcv3cMEyonTf
+updateTime: 1774249312000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=php_sdk_release_note
+---
+
+## v3.1.1
+**Date: 2024/07/24**
+**Notes：**
+- Supports setting log file permissions
+## v3.0.0
+**Date: 2023/10/08**
+**Notes：**
+- Enabling new apis
+## v2.2.2
+**Date: 2023/06/29**
+**Notes：**
+- Bugfix: close file handler when file rotate
+## v2.2.1
+**Date: 2023/04/11**
+**Notes：**
+- Close file handler when SDK close
+## v2.2.0
+**Date: 2023/04/10**
+**Notes：**
+- Add TE namespace
+- Add buffer
+## **v2.1.1**
+**Date：2022/11/10**
+**Notes：**
+- Support debug mode in TE
+## **v2.1.0**
+**Date：2022/10/25**
+**Notes：**
+- Support log system
+## **v2.0.0** 
+**Date：2022/05/09**
+**Notes：**
+- Support dynamic common properties
+- Add `track_first` api
+- Add `user_uniq_append` api
+