@thinkingai/ae-cli 1.0.30 → 6.0.16-1

package/wiki/te-docs/raw/data-ingestion-guide/client-sdk/ios/release-notes.md

@@ -0,0 +1,163 @@
+---
+code: ios_sdk_release_notes
+name: "Release Notes"
+wikiToken: KTEzwd88Mi5HG7kTrpbcYRtXnrh
+parentWikiToken: Wxc7wQj3FitXYVkTuW5cAAtPnCc
+updateTime: 1774249070000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=ios_sdk_release_notes
+---
+
+## v3.4.0
+**Date:** 03/20/2026 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.4.0.zip)
+**Notes:**
+- Support for backupUrlList
+- Add a switch to control whether configuration information is pulled during initialization
+- Known issues fixed
+## v3.3.5
+**Date:** 03/12/2026 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.3.5.zip)
+**Notes:**
+- Known issues fixed
+## v3.3.4
+**Date:** 03/09/2026 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.3.4.zip)
+**Notes:**
+- Known issues fixed
+## v3.3.3
+**Date:** 12/29/2025 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.3.3.zip)
+**Notes:**
+- Known issues fixed
+## v3.3.2
+**Date:** 12/03/2025 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.3.2.zip)
+**Notes:**
+- Known issues fixed
+## v3.3.1
+**Date:** 11/18/2025 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.3.1.zip)
+**Notes:**
+- Known issues fixed
+## v3.3.0
+**Date:** 11/03/2025 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.3.0.zip)
+**Notes:**
+- Known issues fixed
+- Improve SDK stability
+## v3.1.6
+**Date:** 10/10/2025 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.1.6.zip)
+**Notes:**
+- Known issues fixed
+## v3.1.5
+**Date:** 08/25/2025 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.1.5.zip)
+**Notes:**
+- Known issues fixed
+## v3.1.4
+**Date:** 08/19/2025 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.1.4.zip)
+**Notes:**
+- Known issues fixed
+## v3.1.3
+**Date:** 08/05/2025 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.1.3.zip)
+**Notes:**
+- Known issues fixed
+## v3.1.2
+**Date:** 07/31/2025 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.1.2.zip)
+**Notes:**
+- Known issues fixed
+## v3.1.1
+**Date:** 05/23/2025 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.1.1.zip)
+**Notes:**
+- Improve SDK stability
+## v3.1.0
+**Date:** 03/13/2025 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.1.0.zip)
+**Notes:**
+- Release the official version
+## v3.0.6
+**Date:** 02/25/2025 [Download (iOS)](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.0.6.zip)  [Download (OSX)](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Ftd_analytics_mac_v3.0.6.zip)
+**Notes:**
+- Release the official version
+## v3.1.0-beta.2
+**Date:** 12/15/2024
+**Notes:**
+- Improve SDK stability
+## v3.0.6-beta.1
+**Date:** 01/07/2025 [Download (iOS)](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.0.6-beta.1.zip)
+**Notes:**
+- Improved thread scheduling capability
+## v3.0.5
+**Date:** 11/05/2024 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.0.5.zip)
+**Notes:**
+- Release the official version
+## v3.0.5-beta.1
+**Date:** 09/03/2024
+**Notes:**
+- Improve SDK compatibility on the osx platform
+## v3.0.4
+**Date: **08/01/2024 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.0.4.zip)
+**Notes: **
+- Compatible with iOS 18
+## v3.0.3
+**Date: **05/17/2024 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.0.3.zip)
+**Notes: **
+- Release the official version
+## v3.0.3-beta.1
+**Date: **04/19/2024 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.0.3-beta.1.zip)
+**Notes: **
+- Support DNS parse
+## v3.0.2
+**Date: **04/09/2024 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.0.2.zip)
+**Notes: **
+- Release the official version
+## v3.0.2-beta.2
+**Date: **02/23/2024 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.0.2-beta.2.zip)
+**Notes: **
+- Add privacy manifest
+## v3.0.2-beta.1
+**Date: **01/26/2024 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.0.2-beta.1.zip)
+**Notes: **
+- Code optimization to improve SDK stability
+## v3.0.1
+**Date: **01/03/2024 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_3.0.1.zip)
+**Notes: **
+- Code optimization to improve SDK stability
+## v3.0.0
+**Date: **10/10/2023 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.0.0.zip)
+**Notes: **
+- The public API is changed to static access
+## v2.8.4
+**Date:** 08/29/2023 [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_sdk_2.8.4.zip)
+**Notes:**
+- Improve the accuracy of time zone
+- Supports more comprehensive app start event collection
+## v2.8.3.2
+**Date: **04/03/2023
+**Notes: **
+- Compatible with xcode 14.3
+## v2.8.3
+**Date: **11/08/2022
+**Notes: **
+- Optimize code and improve SDK stability
+- Remove third-party dataset code
+## v2.8.2
+**Date: **09/27/2022
+**Notes: **
+- Code optimization to improve SDK stability
+- Added preset property #device_type
+- Added an interface for getting mobile phone region information
+##  v2.8.1.1
+** Date: **06/27/2022
+** Notes: **
+- Code optimization to improve SDK stability
+##  v2.8.1
+** Date: **06/13/2022
+** Notes: **
+- Provide AppExtension data acquisition module
+##  v2.8.0.1
+** Date: **05/23/2022
+** Notes: **
+- Fixed that the system callback could not be executed when getting the start reason for Push
+##  v2.8.0
+** Date: **04/18/2022
+** Notes: **
+- Code optimization
+- Add third-party data integration function
+- Add encryption function
+##  v2.7.4
+** Date: **01/18/2022
+** Notes: **
+- Code optimization
+- Add prefabricated attributes such as start reason, performance index, etc.

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

@@ -0,0 +1,304 @@
+---
+code: ios_sdk_installation
+name: "iOS"
+wikiToken: Wxc7wQj3FitXYVkTuW5cAAtPnCc
+parentWikiToken: KaFCwNeV3iRxjNkpT3QcDMg3n5V
+updateTime: 1778673793000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=ios_sdk_installation
+---
+
+::: tip
+Before  you begin, please read [<text color="purple" underline="true">Preparation before Data Ingestion</text>](https://thinkingdata.feishu.cn/wiki/OhD8we9iai6Xk5kM1QNc8ITRnQe)
+The lowest system version required by iOS SDK is iOS 9.0
+The size of iOS SDK (Framework format) is around 2.7 MB
+ :::
+**Latest Version:** v3.4.0
+**Update Time:** 03/20/2026
+**Resource Download: **[Source Code](https%3A%2F%2Fgithub.com%2FThinkingDataAnalytics%2Fios-sdk%2Ftags), [Download](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.4.0.zip)
+::: warning Notice 
+Current documentation applies to v3.0.0 and later. For historical versions, see [Data Ingestion Guide - iOS (V2)](https%3A%2F%2Fdocs.thinkingdata.cn%2Fta-manual%2Fv4.1%2Fen%2Finstallation%2Finstallation_menu%2Fclient_sdk%2Fios_sdk_installation%2Fios_sdk_installation.html), [SDK Download (v2.8.4)](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_sdk_2.8.4.zip). 
+:::
+## **1. ****SDK**** Integration**
+### **1.1 Automatic Integration**
+- CocoaPods
+1. Create a Podfile in your Xcode project directory by running `pod init` in your terminal.
+Edit the generated Podfile , and add the following lines: 
+```ruby
+platform :ios, '9.0'
+target 'YourProjectTarget' do
+  pod 'ThinkingSDK', '3.4.0'
+end
+```
+
+2. Navigate to your project's root folder and run `pod install` in your terminal 
+After success, the following tip will appear in the terminal:
+<image token="QvsBb5DnyocFtgxoVBTc6Goxnxt" width="1132" height="342" align="center"/>
+
+3. Open project 
+After the command is executed successfully, `.xcworkspace` file will be generated, indicating that you have successfully imported the iOS SDK. Open the `.xcworkspace` file to start the project (note: the `.xcodeproj` file cannot be opened at the same time)
+### **1.2 ****Manual Integration**
+1. Download and unzip the [iOS SDK](https%3A%2F%2Fdownload.thinkingdata.cn%2Fclient%2FiOS%2Fios_td_analytics_v3.4.0.zip)
+2. Add `ThinkingSDK.framework`, `ThinkingDataCore.xcframework` into the Xcode project workspace project
+3. In Xcode, go to **Targets** > **Build Settings, **add line `-ObjC ` to `Other linker flags` :
+<grid cols="2">
+  <column width="52">
+    <image token="DQf2bBOAYoyw6mxAxb5c8Y9qnIb" width="496" height="202" align="center"/>
+
+  </column>
+  <column width="47">
+    <image token="NlCQbh9CmoS10SxyicpcYQZdndh" width="727" height="328" align="center"/>
+
+  </column>
+</grid>
+
+4. In Xcode, go to **Targets** > **Build Phases**, add the following dependencies into `Link Binary With Libraries`: `libz.dylib`, `Security.framework`, `SystemConfiguration.framework`, `libsqlite3.tbd`
+## **2.  ****Initialization**
+:::: el-tabs
+::: el-tab-pane label=Objective-C
+```objectivec
+#import <ThinkingSDK/ThinkingSDK.h>
+
+// SDK needs to be initialized on the main thread
+
+NSString *appid = @"APPID";
+NSString *url = @"SERVER_URL";
+    
+// the first way
+[TDAnalytics startAnalyticsWithAppId:appid serverUrl:url];
+    
+// the second way
+TDConfig *config = [[TDConfig alloc] init];
+config.appid = appid;
+config.serverUrl = url;
+[TDAnalytics startAnalyticsWithConfig:config];
+```
+
+:::
+::: el-tab-pane label=Swift
+```swift
+// SDK needs to be initialized on the main thread
+
+let appid = "APPID";
+let url = "SERVER_URL";
+
+// the first way
+TDAnalytics.start(withAppId: appid, serverUrl: url)
+
+// the second way
+let config = TDConfig(appId: appid, serverUrl: url)
+TDAnalytics.start(with: config)
+```
+
+:::
+::::
+Instruction on parameters:
+- `APPID`: The APPID of your project, which can be found on the project management page of the TE.
+- `SERVER_URL`: 
+  - If you are using a SaaS version, please check the receiver URL on this page
+<image token="QnSnbV9NRo0NElx5SQ9cenEcnbd" width="1674" height="1318" align="center"/>
+
+
+- If you use the private deployment version, you can customize the data tracking URL .
+## **3.  Common F****eatures**
+We suggested that you read [User Identification Rules](https://thinkingdata.feishu.cn/wiki/Pov9wECdsi2QQsk4NN9cEPsvnyc) before using common features; SDK would generate a random number that would be used as the distinct ID, and save the ID locally. Before the user logs in, the distinct ID would be used as the identification ID.   Note: The distinct ID would change after the user reinstalled the App or used the APP with a new device.
+### **3.1 Login**
+When the users log in , `login` could be called to set the account ID of the user. TE would use the account ID as the identification ID, and this ID would be saved before `logout` is called. The previous account ID would be replaced if `login` has been called multiple times.
+:::: el-tabs
+::: el-tab-pane label=Objective-C
+```java
+// The login unique identifier of the user, corresponding to the #account_id in data tracking. #Account_id now is TD
+[TDAnalytics login:@"TD"];
+```
+
+:::
+::: el-tab-pane label=Swift
+```swift
+// The login unique identifier of the user, corresponding to the #account_id in data tracking. #Account_id now is TD
+TDAnalytics.login("TD")
+```
+
+:::
+::::
+<quote-container>
+**Login events wouldn't be uploaded in this method.**
+</quote-container>
+
+### 3.2 **Super Properties**
+Super properties refer to properties that each event might have. You can call `setSuperProperties` to set super properties. It is recommended that you set super properties first before sending data. Some important properties (e.g., the membership class of users, source channels, etc.) should be set in each event. At this time, you can set these properties as super properties.
+:::: el-tabs
+::: el-tab-pane label=Objective-C
+```objectivec
+NSMutableDictionary *superProperties = [NSMutableDictionary new];
+[superProperties setValue:@"te" forKey:@"channel"];
+[superProperties setValue:@1 forKey:@"age"];
+[superProperties setValue:@YES forKey:@"isSuccess"];
+[superProperties setValue:[NSDate now] forKey:@"birthday"];
+[superProperties setValue:@{@"key":@"value"} forKey:@"object"];
+[superProperties setValue:@[@{@"key":@"value"}] forKey:@"object_arr"];
+[superProperties setValue:@[@"value"] forKey:@"arr"];
+
+//set super properties
+[TDAnalytics setSuperProperties:superProperties];
+```
+
+:::
+::: el-tab-pane label=Swift
+```swift
+var superProperties: [String : Any] = [:]
+superProperties["channel"] = "te"
+superProperties["age"] = 1
+superProperties["isSuccess"] = true
+superProperties["birthday"] = Date()
+superProperties["object"] = [
+    "key": "value"
+]
+superProperties["object_arr"] = [["key": "value"]]
+superProperties["arr"] = ["value"]
+
+//set super properties
+TDAnalytics.setSuperProperties(superProperties)
+```
+
+:::
+::::
+Super properties would be saved in local storage, and will not need to be called every time the APP is opened. If the super properties set previously are uploaded after calling `setSuperProperties`, previous properties would be replaced. 
+- 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 with that for super properties**
+</quote-container>
+
+### **3.3 Automatically Track Events**
+The following code is an example of tracking installation, open_app and close_app events. To get more information about the automatic tracking of SDK, please refer to the [Detailed introduction of automatic tracking function](https://thinkingdata.feishu.cn/wiki/IqwOwQmTbiVNXZk8r4JcmZAMnie)
+:::: el-tabs
+::: el-tab-pane label=Objective-C
+```objectivec
+[TDAnalytics enableAutoTrack:TDAutoTrackEventTypeAppInstall | TDAutoTrackEventTypeAppStart | TDAutoTrackEventTypeAppEnd];
+```
+
+:::
+::: el-tab-pane label=Swift
+```swift
+TDAnalytics.enableAutoTrack([.appStart, .appEnd, .appInstall])
+```
+
+:::
+::::
+### **3.4 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:
+:::: el-tabs
+::: el-tab-pane label=Objective-C
+```objectivec
+NSDictionary *eventProperties = @{@"product_name": @"book"};
+[TDAnalytics track:@"product_buy" properties:eventProperties];
+```
+
+:::
+::: el-tab-pane label=Swift
+```swift
+let properties = ["product_name": "book"] as [String: Any]
+TDAnalytics.track("product_buy", properties: properties)
+```
+
+:::
+::::
+The event name is string type. It could only start with a character and could contain figures, characters, and an underline "_", with a maximum length of 50 characters.
+### **3.5 User Properties**
+You can set general user properties by calling `user``S``et` API. The original properties would be replaced by the properties uploaded via this API. If no user properties are set before, user properties would be created. The data type of newly-created user properties must be the same as the uploaded properties. User name setting is taken as the example here: 
+:::: el-tabs
+::: el-tab-pane label=Objective-C
+```objectivec
+//the username now is ThinkingData
+[TDAnalytics userSet:@{@"username": @"ThinkingData"}];
+//the userName now is TA
+[TDAnalytics userSet:@{@"username": @"TA"}];
+```
+
+:::
+::: el-tab-pane label=Swift
+```swift
+//the username now is ThinkingData
+TDAnalytics.userSet(["usernaame": "ThinkingData"])
+//the userName now is TA
+TDAnalytics.userSet(["usernaame": "TA"])
+```
+
+:::
+::::
+## **4. Best Practice**
+The following sample code covers all the above-mentioned operations. It is recommended that the SDK be used in the following steps:
+:::: el-tabs
+::: el-tab-pane label=Objective-C
+```objectivec
+if (privacy policy is authorized) {
+    
+    // SDK needs to be initialized on the main thread
+    NSString *appid = @"APPID";
+    NSString *url = @"SERVER_URL";
+    TDConfig *config = [[TDConfig alloc] init];
+    config.appid = appid;
+    config.serverUrl = url;
+    [TDAnalytics startAnalyticsWithConfig:config];
+    
+    [TDAnalytics enableAutoTrack:TDAutoTrackEventTypeAppInstall | TDAutoTrackEventTypeAppStart | TDAutoTrackEventTypeAppEnd];
+    
+    [TDAnalytics login:@"TD"];
+    
+    NSDictionary *superProperties = @{
+        @"channel": @"ta",
+        @"age": @1,
+        @"isSuccess": @YES,
+        @"birthday": [NSDate date],
+        @"object": @{
+            @"key":@"value"
+        },
+        @"object_arr":@[
+            @{
+                @"key":@"value"
+            }
+        ],
+        @"arr": @[@"value"],
+    };
+    [TDAnalytics setSuperProperties:superProperties];
+        
+    NSDictionary *eventProperties = @{@"product_name": @"book"};
+    [TDAnalytics track:@"product_buy" properties:eventProperties];
+    
+    [TDAnalytics userSet:@{@"username": @"ThinkingData"}];
+}
+
+```
+
+:::
+::: el-tab-pane label=Swift
+```swift
+// SDK needs to be initialized on the main thread
+let appid = "app_id";
+let url = "server_url";
+let config = TDConfig(appId: appid, serverUrl: url)
+TDAnalytics.start(with: config)
+
+TDAnalytics.enableAutoTrack([.appStart, .appEnd, .appInstall])
+
+TDAnalytics.login("TD")
+
+var superProperties: [String : Any] = [:]
+superProperties["channel"] = "ta"
+superProperties["age"] = 1
+superProperties["isSuccess"] = true
+superProperties["birthday"] = Date()
+superProperties["object"] = [
+    "key": "value"
+]
+superProperties["object_arr"] = [["key": "value"]]
+superProperties["arr"] = ["value"]
+TDAnalytics.setSuperProperties(superProperties)
+
+let eventProperties : [String: Any] = ["product_name": "book"]
+TDAnalytics.track("test", properties: eventProperties)
+
+TDAnalytics.userSet(["level": "1"])
+```
+
+:::
+::::

package/wiki/te-docs/raw/data-ingestion-guide/client-sdk/javascript/compliance.md

@@ -0,0 +1,29 @@
+---
+code: javascript_sdk_compliance
+name: "Compliance"
+wikiToken: KBxowhZ3Fir4rekLEqec9em3ngg
+parentWikiToken: HwzHwHeb5iFceqk6Eylcd03UnMh
+updateTime: 1774249083000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=javascript_sdk_compliance
+---
+
+## **1. Fill In the ****SDK**** Related Content in the Privacy Policy**
+### **1.1 ****Collection and Acquisition**
+Complete the following as appropriate in the Collection and Access to Your Personal Information section of the Privacy Policy.
+When you are active, Thinking Data collects your device information (Screen width, Screen height, operating system, Browser type,Browser version, System language, etc.) for statistical analysis of how you use it within App.
+### **1.2 ****Share with Authorized Partners**
+Complete the following as appropriate in the Sharing with Authorized Partners section of the Privacy Policy.
+Thinking Data SDK: Collect your device information (Screen width, Screen height, operating system, Browser type,Browser version, System language, etc.) and networking information for data analysis to improve our products and services.
+## **2****. ****SDK**** Compliance Steps**
+ThinkingData SDK requires you to ensure that users initialize the SDK after agreeing to the Privacy Policy
+```cpp
+import ta from "thinkingdata-browser";
+// Judging whether to open data acquisition according to privacy protocol
+if (Authorized Privacy Policy) {
+    var config = {
+        appId: 'APP_ID',
+        serverUrl: 'SERVER_URL'
+    };            
+    ta.init(config);
+}
+```

package/wiki/te-docs/raw/data-ingestion-guide/client-sdk/javascript/javascript-advanced/automatic-event-tracking.md

@@ -0,0 +1,136 @@
+---
+code: javascript_sdk_autotrack
+name: "Automatic Event Tracking"
+wikiToken: Ekk2wzXp2iT1tqkpea6c2KB4nef
+parentWikiToken: BwkywAk0aiKI9Skyhk8cKnlKnde
+updateTime: 1776241528000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=javascript_sdk_autotrack
+---
+
+## 1.Monitor HTML element Clicked Events
+If you want to track click events on elements of the page, you can use trackLink to monitor HTML elements in batches:
+```javascript
+ta.trackLink(
+  {
+    tag: ["a", "button"], //HTML tag
+    class: ["class1", "class2"], //Custom Class name
+    id: ["id1", "id2"] //custom ID name
+  }, 
+  "click", //he name of the trace event
+  {
+    production: "production",
+    name: "name"
+  } //event properties
+);
+```
+
+- The first parameter is  the element you need to monitor. The type is a JSON object, which supports tracking the page element to be monitored according to the HTML `tag` , `class`, and `i``d`.For elements that meet the rules, the click event of the element will be monitored through the event listener. When the listening element is clicked, an event will be reported. The event name and event properties take the value of the next two parameters
+- The second parameter is the name of the event, which is of string type. 
+- The third parameter is the property of the event, and the type is a JSON object. If there is no property to be reported, an empty JSON can be passed in
+- The event property name is the ID of the element. If the event property name is not set in parameter.We will use the property value of the monitored element as the element identifier. The value priority is as follows:
+  1.Custom attribute 'td-name' of the value element
+  2.The innerHTML of the element
+  3.The value of the element
+  4.If none of them are fetched, pass 'ID not obtained'.
+<quote-container>
+When `trackLink `is called, it will set an event listener for elements that meet the rules. After the API is called, the identity of the element changes, or a new element that meets the rules is generated, and the event reported by the listener will not change accordingly. If you need to monitor newly generated elements, you can call `trackLink` after the elements are generated.
+</quote-container>
+
+## 2.Page show and hide event
+By default, the SDK does not collect these events, which can be configured through the config initialized by the SDK.
+```scala
+var config = {
+    appId: 'xxx',
+    serverUrl: 'xxx',
+    autoTrack: {
+     //enable ta_page_show event
+     pageShow: true,
+     //enable ta_page_hide event
+     pageHide: true,
+    }
+};
+```
+
+`ta_page_hide` event will put the duration of the page from displaying to closing into the property`#duration`
+## 3.Browse Events
+TE provides an API for auto-tracking view page event.You only need to use the following code, and SDK will automatically upload the event of the user browsing the page, and the event name is ta_pageview：
+```javascript
+ta.quick("autoTrack");
+```
+
+Support custom properties：
+```javascript
+ta.quick('autoTrack', {
+    name: 'test_name',
+    time: new Date(),
+    pro: [1, 2, 3, 4],
+})
+```
+
+<quote-container>
+When this API is called, a view page event will be reported immediately
+</quote-container>
+
+Starting from version 2.4.0, automatic browsing events for single-page applications (SPAs) are supported. The specific enabling methods are as follows:
+```javascript
+var config = {
+    appId: 'xxx',
+    serverUrl: 'xxx',
+    autoTrack: {
+         //enable ta_page_show event
+         pageShow: true,
+         //enable ta_page_hide event
+         pageHide: true,
+         //enable ta_pageview event
+         pageView: true,
+         properties: {
+             staticKey: 'staticValue'
+         }, 
+         callback: (eventType) => {
+              if (eventType === 'pageShow') {
+                  return { appShowKey: 'appShowValue' };
+              } else if (eventType === 'pageHide') {
+                  return { appHideKey: 'appHideValue' };
+              }else if (eventType === 'pageView') {
+                  return { appHideKey: 'pageViewValue' };
+              }else {
+                  return {};
+              }
+         }
+    }
+};
+```
+
+## 3.Element click event
+Starting with version 2.5.0, element click events can be automatically collected by configuring the pageClick parameter, with the event name being ta_page_click.
+```javascript
+var config = {
+    appId: 'xxx',
+    serverUrl: 'xxx',
+    autoTrack: {
+         pageShow: true,
+         pageHide: true,
+         pageView: true,
+         pageClick:true
+    }
+};
+```
+
+- Setting pageClick: true will, by default, collect click events of all elements with onclick or td-track-id set. Example code is as follows:
+```json
+<button onclick="testFun()" td-track-id="buttonId">test button</button>
+```
+
+<callout emoji="trophy" background-color="light-orange" border-color="light-orange">
+Note: Vue project elements do not have an onclick attribute; you need to use td-track-id to filter and collect data.
+</callout>
+
+After setting td-track-id, #element_id will be automatically included when reporting click events.
+- If you want to ignore the click event of this element, you can do so using `td-track-ignore` or `td-track-ignore="true"`. Example code is shown below:
+```json
+<button onclick="testFun()" td-track-ignore >test button</button>
+```
+
+<callout emoji="soccer" background-color="light-orange" border-color="light-orange">
+Note: React projects need to use `td-track-ignore="true"` to ignore this.
+</callout>

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

@@ -0,0 +1,48 @@
+---
+code: javascript_sdk_debug
+name: "Debugging and Logging"
+wikiToken: BjISw0TEGiY0iSkGlnhcRhCrnyc
+parentWikiToken: BwkywAk0aiKI9Skyhk8cKnlKnde
+updateTime: 1774251969000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=javascript_sdk_debug
+---
+
+During the process of SDK integration, you can perform real-time debugging by checking SDK's logs in the IDE console or using the Debug feature of TE.
+## Printing Log
+You can set showLog to true when the SDK is initialized,after opening the log,you can check SDK's logs on the browser console.
+```javascript
+var config = {
+    appId: "xxx",
+    serverUrl: "xxx",
+    showLog:true
+};
+```
+
+## **2. Debugging**
+You need to follow the following two steps to enable the Debug mode:
+1. Enable the debug mode at the client
+The sample code for enabling the Debug Mode on the client is as follows:
+```javascript
+var config = {
+    appId: "xxx",
+    serverUrl: "xxx",
+    /*
+    NORMAL mode: the data would be saved in caches and reported according to relevant cache policies under the NORMAL mode by default. It is recommended to use the mode in an online environment
+    Debug mode: report data item by item. If problems occur, the user would be notified with logs and anomalies. It is recommended to use the Debug mode in an online environment
+    DebugOnly mode: data would be verified without being stored; it is not recommended to use the DebugOnly mode in an online environment
+     */
+    mode:"debug"
+};
+```
+
+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 IDs have been configured in the "Debugger"sector on the "Tracking Management" page of TE when the client side has enabled the Debug mode.
+<image token="BU3ZbIk6AoadzGxfGdIcogdCnud" width="1280" height="590" align="center"/>
+
+Device ID could be obtained by the following three means:
+- #device_id:property in the event data of TE
+- Client-side log: DeviceID would be printed as log after SDK is initialized
+- Call API：[Device ID](https://thinkingdata.feishu.cn/wiki/BwkywAk0aiKI9Skyhk8cKnlKnde)
+<quote-container>
+The Debug Mode may undermine the data tracking quality and stability of the Application. It could only be used for data verification at the integration stage, and should not be used in the production environment.
+</quote-container>