ae-tracking 0.1.0

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk//345/260/217/347/250/213/345/272/217/345/260/217/346/270/270/346/210/217.md

@@ -0,0 +1,440 @@
+---
+code: mp_sdk_installation
+name: "小程序&小游戏 "
+wikiToken: HBNXwSFSFiWQGWkt0ynccCeIn9g
+parentWikiToken: FTcTwinIOi3OiRkK4MPc2Ex7neg
+updateTime: 1770106195000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=mp_sdk_installation
+---
+# 小程序&小游戏 
+
+::: tip 提示
+
+ 在接入前, 请先阅读接入前准备。
+
+如果您使用游戏引擎开发小游戏，请阅读常用游戏引擎的集成方案：Egret 白鹭引擎、 LayaAir、 CocosCreator.
+
+ :::
+
+**最新版本:** v3.4.4 下载(小程序) 下载(小游戏)
+
+**更新时间:** 2026-02-03
+
+**资源下载:**** **源代码
+
+::: warning 注意
+
+当前文档适用于 v3.0.0 及以后的版本，历史版本请参考 小程序&小游戏接入指南（V2），小程序SDK下载（v2.2.4）、小游戏SDK下载（v2.2.4）
+
+::: 
+
+小程序&小游戏 SDK 为常见小程序平台、快应用、小游戏平台的提供了一套标准的 API 接口以实现数据上报功能。目前，支持的平台及对应的文件如下：
+
+**小程序：**
+
+- 微信小程序: tdanalytics.wx.min.js
+- 百度小程序: tdanalytics.swan.min.js
+- 抖音小程序: tdanalytics.tt.min.js
+- 支付宝小程序: tdanalytics.my.min.js
+- 钉钉小程序: tdanalytics.dd.min.js
+- 快手小程序: tdanalytics.ks.min.js
+- 快应用: tdanalytics.quick.min.js
+- QQ小程序：tdanalytics.qq.min.js
+- 京东小程序：tdanalytics.jd.min.js
+- 360小程序：tdanalytics.qh.min.js
+**小游戏：**
+
+- 微信小游戏: tdanalytics.mg.wx.min.js
+- QQ 小游戏: tdanalytics.mg.qq.min.js
+- 抖音小游戏: tdanalytics.mg.tt.min.js
+- 百度小游戏: tdanalytics.mg.swan.min.js
+- 哔哩哔哩小游戏: tdanalytics.mg.bl.min.js
+- 华为快游戏: tdanalytics.mg.huawei.min.js
+- OPPO 快游戏: tdanalytics.mg.oppo.min.js
+- VIVO 快游戏: tdanalytics.mg.vivo.min.js
+- 魅族快游戏: tdanalytics.mg.mz.min.js
+- 小米快游戏: tdanalytics.mg.xiaomi.min.js
+- 淘宝小游戏：tdanalytics.mg.tb.min.js
+- 快手小游戏：tdanalytics.mg.ks.min.js
+- 支付宝小游戏：tdanalytics.mg.my.min.js
+- 美团小游戏：tdanalytics.mg.mt.min.js
+- H5小游戏
+- UC小游戏
+- Facebook小游戏
+### 一、集成 SDK
+
+:::: el-tabs
+
+::: el-tab-pane label=小程序
+
+下载小程序 SDK, 在 app.js 中引入对应的 SDK 文件（以微信小程序为例）:
+
+```
+var TDAnalytics = require("./tdanalytics.wx.min.js");
+```
+
+引入 SDK 之后，您就可以创建 SDK 实例，开始上报数据了：
+
+```
+// AE SDK 配置对象
+var config = {
+  appId: "YOU-APP-ID", // 项目的 APP ID
+  serverUrl: "https://youserverurl.com", // 数据上报地址
+  autoTrack: {
+    appLaunch: true, // 自动采集 ta_mp_launch
+    appShow: true, // 自动采集 ta_mp_show
+    appHide: true, // 自动采集 ta_mp_hide
+    pageShow: true, // 自动采集 ta_mp_view
+    pageShare: true // 自动采集 ta_mp_share
+  }
+};
+
+// 初始化
+TDAnalytics.init(config);
+```
+
+AE 配置对象参数说明如下：
+
+- `appId`: 您项目的 APP ID，必需, 可以在 AE 后台项目管理页查看
+- `serverUrl`: 数据上报 URL，必需 
+- 如果您使用的是云服务，填入: https://global-receiver-ta.thinkingdata.cn
+- 如果您使用的是私有化部署的版本，请与运维同学确认上报地址
+- `enableBatch`:数据先缓存到本地，然后批量发送，默认为false
+- `autoTrack`：可选, 表示是否开启自动采集功能，每一个元素分别代表如下的自动采集事件，默认全部关闭： 
+- `appLaunch`：自动采集小程序初始化，一次使用只会触发一次
+- `appShow`：自动采集小程序启动，或从后台进入前台
+- `appHide`：自动采集小程序从前台进入后台，并记录本次访问（启动至调入后台）的时间
+- `pageShow`：自动采集小程序页面显示或切入前台，记录页面路径以及前向路径
+- `pageShare`：自动采集小程序进行转发分享，记录转发时的页面
+**关于自动采集事件的详细信息，可以查看**自动采集事件**一节**
+
+:::
+
+::: el-tab-pane label=快应用
+
+下载小程序 SDK, 在 app.ux 中引入对应的 SDK
+
+ 文件 `tdanalytics.``quick.min.js`:
+
+```
+var TDAnalytics = require("./tdanalytics.quick.min.js");
+```
+
+之后，您就可以创建 SDK 实例，开始上报数据了：
+
+```
+// AE SDK 配置对象
+var config = {
+  appId: "YOU-APP-ID", // 项目的 APP ID
+  serverUrl: "https://youserverurl.com", // 数据上报地址
+  persistenceComplete(ta) {
+    // 异步存储初始化完成时的回调，可以做一些与缓存相关的删除操作
+    //TDAnalytics.clearSuperProperties();
+  }
+};
+
+// 初始化
+TDAnalytics.init(config);
+```
+
+AE 配置对象参数说明如下：
+
+- `appId`: 您项目的 APP ID，必需, 可以在 AE 后台项目管理页查看
+- `serverUrl`: 数据上报 URL，必需 
+- 如果您使用的是云服务，填入: https://global-receiver-ta.thinkingdata.cn
+- 如果您使用的是私有化部署的版本，请与运维同学确认上报地址
+- `persistenceComplete`: 可选。 快应用缓存是异步读取的，因此完成缓存读取前，对缓存相关的字段进行查询、删除操作将会出现与预期不符的情况，为了保证在初始化阶段的缓存查询与删除能够正确执行，需要在
+ persistenceComplete 回调中完成相关操作。缓存相关数据包括：用户 ID（#account_id 与#distinct_id），设备 ID，公共事件属性等。
+
+**persistenceComplete 的进一步说明:**
+
+针对异步调用导致的 SDK 状态问题，我们为每个实例设置了 Ready 状态。当以下条件**全部满足**时，我们认为实例已经 Ready:
+
+- 获取系统信息完成：我们通过调用平台提供的 `getSystemInfo()` 获取系统信息
+- 缓存信息读取完成：快应用是异步读取缓存
+- 用户主动调用了 `TDAnalytics.``init()`
+当实例未进入 Ready 状态，我们会缓存所有上报的数据，等待实例初始化完成后，会清空缓存，以此保证状态正确。
+
+在异步读取缓存的不同阶段，需要特别注意下面的说明：
+
+1. 在缓存信息未读取的时候，可以设置公共属性、登录账户。
+1. 当缓存读取完成时，我们会用新的值覆盖之前在缓存中的值。
+1. **在缓存读取完成之前，调用涉及删除或读取之前缓存的一些信息的函数，则无法读取或删除实际缓存中的数据。**
+针对上述第 3 点，可以通过在初始化时传入回调函数 (即 persistenceComplete) 来保证调用顺序。
+
+<!-- unsupported block: 34 -->
+
+注意：快应用暂不支持自动采集事件
+
+:::
+
+::: el-tab-pane label=小游戏
+
+下载小游戏 SDK, 在 game.js 中引入对应的 SDK 文件（以微信小游戏为例）:
+
+```
+var TDAnalytics = require("./tdanalytics.mg.wx.min.js");
+```
+
+```
+// AE SDK 配置对象
+var config = {
+  appId: "YOUR_APPID", // 项目 APP ID
+  serverUrl: "YOUR_SERVER_URL", // 上报地址
+  autoTrack: {
+    appShow: true, // 自动采集 ta_mg_show
+    appHide: true // 自动采集 ta_mg_hide
+  }
+};
+// 初始化
+TDAnalytics.init(config);
+```
+
+AE 配置对象参数说明如下：
+
+- `appId`: 您项目的 APP ID，必需, 可以在 AE 后台项目管理页查看
+- `serverUrl`: 数据上报 URL，必需 
+- 如果您使用的是云服务，填入: https://global-receiver-ta.thinkingdata.cn
+- 如果您使用的是私有化部署的版本，请与运维同学确认上报地址
+- `autoTrack`：可选, 表示是否开启自动采集功能，每一个元素分别代表如下的自动采集事件，默认全部关闭： 
+- `appShow`：自动采集小游戏启动，或从后台进入前台
+- `appHide`：自动采集小游戏从前台进入后台，并记录本次访问（启动至调入后台）的时间
+:::
+
+::::
+
+::: warning 注意 
+
+在上报数据之前，请先在微信公众平台或其他平台的开发设置中，将数据传输 URL 加入到服务器域名的 request 列表中.
+
+ :::
+
+### 二、常用功能
+
+在使用常用功能之前，建议你先了解用户识别规则。SDK默认会生成随机数作为访客ID，并持久化存储访客ID在本地，用户未登录之前，会以访客ID作为身份识别ID。注意:访客 ID 在用户清理缓存 以及更换设备时将会变更。
+
+#### 2.1 设置账号ID
+
+在用户进行登录时，可调用 `login` 来设置用户的账号 ID， AE 平台将会以账号 ID 作为身份识别 ID，并且设置的账号 ID 将会在调用 `logout` 之前一直保留。多次调用 `login` 将覆盖先前的账号 ID 
+
+```
+// 用户的登录唯一标识，此数据对应上报数据里的#account_id，此时#account_id的值为TA
+TDAnalytics.login("TA");
+```
+
+<!-- unsupported block: 34 -->
+
+**该方法不会上传登录事件**
+
+#### 2.2 设置公共事件属性
+
+公共事件属性指的就是每个事件都会带有的属性，您可以调用 `setSuperProperties` 来设置公共事件属性，我们推荐您在发送事件前，先设置公共事件属性。对于一些重要的属性，譬如用户的会员等级、来源渠道等，这些属性需要设置在每个事件中，此时您可以将这些属性设置为公共事件属性。
+
+```
+var superProperties = {
+    channel : "ta",
+    age : 1,
+    isSuccess : true,
+    birthday :  new Date(),
+    object : { key : "value" },
+    object_arr : [ { key : "value" } ],
+    arr : [ "value" ]
+};
+TDAnalytics.setSuperProperties(superProperties);
+```
+
+公共事件属性将会被保存到缓存中，无需每次启动时调用。如果调用 `setSuperProperties` 上传了先前已设置过的公共事件属性，则会覆盖之前的属性。
+
+- Key 为该属性的名称，为字符串类型，规定只能以字母开头，包含数字，字母和下划线 "_"，长度最大为 50 个字符，对字母大小写不敏感，AE 会统一转化为小写字母
+- Value 为该属性的值，支持字符串、数字、布尔、时间、对象、对象组、数组
+<!-- unsupported block: 34 -->
+
+**事件属性、用户属性的要求与公共事件属性保持一致**
+
+#### 2.3 发送事件
+
+您可以调用 `track` 来上传事件，建议您根据先前梳理的埋点文档来设置事件的属性以及发送信息的条件，此处以用户购买某商品作为范例：
+
+```
+TDAnalytics.track({
+    eventName: "product_buy", // 事件名称
+    properties: {
+        product_name: "商品名"
+    } //事件属性
+});
+```
+
+事件的名称是字符串类型，只能以字母开头，可包含数字，字母和下划线 "_"，长度最大为 50 个字符。
+
+#### 2.4 设置用户属性
+
+对于一般的用户属性，您可以调用 `userSet` 来进行设置，使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例：
+
+```
+//此时username为TA
+TDAnalytics.userSet({
+    properties: {
+        username: "TA"
+    }
+});
+//此时userName为TE
+TDAnalytics.userSet({
+    properties: {
+        username: "TE"
+    }
+});
+```
+
+### 三、最佳实践
+
+以下示例代码包含以上所有操作，我们推荐按照如下步骤使用
+
+:::: el-tabs
+
+::: el-tab-pane label=小程序
+
+下载小程序 SDK,引入 SDK 之后，您就可以创建 SDK 实例，开始上报数据了：
+
+```
+var TDAnalytics = require("./tdanalytics.wx.min.js");
+var config = {
+  appId: "YOU-APP-ID", // 项目的 APP ID
+  serverUrl: "https://youserverurl.com", // 数据上报地址
+  autoTrack: {
+    appLaunch: true, // 自动采集 ta_mp_launch
+    appShow: true, // 自动采集 ta_mp_show
+    appHide: true, // 自动采集 ta_mp_hide
+    pageShow: true, // 自动采集 ta_mp_view
+    pageShare: true // 自动采集 ta_mp_share
+  }
+};
+// 初始化
+TDAnalytics.init(config);
+// 用户的登录唯一标识，此数据对应上报数据里的#account_id，此时#account_id的值为TA
+TDAnalytics.login("TA");
+//设置公共事件属性
+var superProperties = {
+    channel : "ta", //字符串
+    age : 1,//数字
+    isSuccess : true,//布尔
+    birthday :  new Date(),//对象
+    object : { key : "value" },//对象
+    object_arr : [ { key : "value" } ],//对象组
+    arr : [ "value" ]//数组
+};
+TDAnalytics.setSuperProperties(superProperties);
+//发送事件
+TDAnalytics.track({
+    eventName: "product_buy", // 事件名称
+    properties: {
+        product_name: "商品名"
+    } //事件属性
+});
+//设置用户属性
+TDAnalytics.userSet({
+    properties: { 
+        username: "TE" 
+    }
+});
+```
+
+:::
+
+::: el-tab-pane label=快应用
+
+下载小程序 SDK, 在 app.ux 中引入对应的 SDK（ `tdanalytics.``quick.min.js`）
+
+您就可以创建 SDK 实例，开始上报数据了：
+
+```
+var TDAnalytics = require("./tdanalytics.quick.min.js");
+// AE SDK 配置对象
+var config = {
+  appId: "YOU-APP-ID", // 项目的 APP ID
+  serverUrl: "https://youserverurl.com", // 数据上报地址
+  persistenceComplete(ta) {
+    // 异步存储初始化完成时的回调，可以做一些与缓存相关的删除操作
+    //TDAnalytics.clearSuperProperties();
+  }
+};
+// 初始化
+TDAnalytics.init(config);
+// 用户的登录唯一标识，此数据对应上报数据里的#account_id，此时#account_id的值为TA
+TDAnalytics.login("TA");
+//设置公共事件属性
+var superProperties = {
+    channel : "ta", //字符串
+    age : 1,//数字
+    isSuccess : true,//布尔
+    birthday :  new Date(),//对象
+    object : { key : "value" },//对象
+    object_arr : [ { key : "value" } ],//对象组
+    arr : [ "value" ]//数组
+};
+TDAnalytics.setSuperProperties(superProperties);
+//发送事件
+TDAnalytics.track({
+    eventName: "product_buy", // 事件名称
+    properties: {
+        product_name: "商品名"
+    } //事件属性
+});
+//设置用户属性
+TDAnalytics.userSet({
+    properties: {
+        username: "TE" 
+    }    
+});
+
+```
+
+:::
+
+::: el-tab-pane label=小游戏
+
+下载小游戏 SDK, 在 game.js 中引入对应的 SDK 文件（以微信小游戏为例），引入 SDK 之后，您就可以创建 SDK 实例，开始上报数据了：
+
+```
+var TDAnalytics = require("./tdanalytics.mg.wx.min.js");
+var config = {
+  appId: "YOUR_APPID", // 项目 APP ID
+  serverUrl: "YOUR_SERVER_URL", // 上报地址
+  autoTrack: {
+    appShow: true, // 自动采集 ta_mg_show
+    appHide: true // 自动采集 ta_mg_hide
+  }
+};
+//初始化
+TDAnalytics.init(config);
+// 用户的登录唯一标识，此数据对应上报数据里的#account_id，此时#account_id的值为TA
+TDAnalytics.login("TA");
+//设置公共事件属性
+var superProperties = {
+    channel : "ta", //字符串
+    age : 1,//数字
+    isSuccess : true,//布尔
+    birthday :  new Date(),//对象
+    object : { key : "value" },//对象
+    object_arr : [ { key : "value" } ],//对象组
+    arr : [ "value" ]//数组
+};
+TDAnalytics.setSuperProperties(superProperties);
+//发送事件
+TDAnalytics.track(
+    eventName: "product_buy", // 事件名称
+    properties: {
+        product_name: "商品名"
+    } //事件属性
+);
+//设置用户属性
+TDAnalytics.userSet({
+    properties: {
+        username: "TE"
+    }
+});
+
+```
+
+:::
+
+::::

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/cocos2d-lua//345/220/210/350/247/204/346/214/207/345/215/227.md

@@ -0,0 +1,35 @@
+---
+code: cocos2d_lua_sdk_compliance
+name: "合规指南"
+wikiToken: QXYZwgJgPiXIEskMupPcJqqsnHg
+parentWikiToken: QmTDwzv5mi9NVekISpKcwfJNnRc
+updateTime: 1745309742000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cocos2d_lua_sdk_compliance
+---
+# 合规指南
+
+### 一. 隐私政策中填写 SDK 相关内容
+
+#### 1.1 收集和获取
+
+在《隐私政策》中收集和获得您的个人信息栏目中根据实际情况填写以下内容。
+
+当您在激活使用时，我们会通过TDAnalytics-SDK收集您的设备信息（IDFV、AndroidID、操作系统、设备型号、设备制造商、系统版本、应用进程信息等）用于统计分析您在 App 内的使用效果。
+
+#### 1.2 与授权合作伙伴共享
+
+在《隐私政策》中的与授权合作伙伴共享栏目中根据实际情况填写以下内容。
+
+TDAnalytics-SDK：收集您的设备信息（IDFV、AndroidID、操作系统、设备型号、设备制造商、系统版本、应用进程信息等）、联网信息用于数据分析，从而改进我们的产品和服务。
+
+### 二. SDK合规步骤
+
+TDAnalytics SDK 需要您确保用户在同意 《隐私政策》后初始化SDK
+
+```
+local TDAnalytics = require("TDAnalytics")
+-- 根据隐私协议判断是否开启数据采集
+if (授权隐私政策) {
+    TDAnalytics.init(APPID, SERVER_URL, TDAnalytics.debugModel.debugOff)
+}
+```

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/cocos2d-lua//346/233/264/346/226/260/346/227/245/345/277/227.md

@@ -0,0 +1,49 @@
+---
+code: cocos2d_lua_sdk_release_note
+name: "更新日志"
+wikiToken: E8Bxwi21Hi0iwCkDQ20cBTw7nph
+parentWikiToken: QmTDwzv5mi9NVekISpKcwfJNnRc
+updateTime: 1745309744000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cocos2d_lua_sdk_release_note
+---
+# 更新日志
+
+### v2.0.2
+
+**更新时间:  2024/01/19 ****下载**
+
+**更新内容：**
+
+- 已知bug修复
+### v2.0.1
+
+**更新时间:  2023/11/24 ****下载**
+
+**更新内容：**
+
+- 代码优化
+### v2.0.0
+
+**更新时间:  2023/09/06 ****下载**
+
+**更新内容：**
+
+- 部分代码优化
+### v1.0.1
+
+**更新时间:  2023/03/21 ****下载**
+
+**更新内容：**
+
+- 部分代码优化
+### v1.0.0
+
+**更新时间:  2022/03/28**
+
+**更新内容：**
+
+- 支持 访客 ID 和 用户账号 的设置
+- 支持事件和用户属性上报
+- 支持启动 / 关闭 / 安装事件的自动上报
+- 支持公共属性接口
+- 支持 timeEvent 接口

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/cocos2d-lua//350/277/233/351/230/266/346/214/207/345/215/227//345/256/236/346/227/266/350/260/203/350/257/225.md

@@ -0,0 +1,53 @@
+---
+code: cocos2d_lua_sdk_debug
+name: "实时调试"
+wikiToken: Nx7MwKHEQi2x26kXVIDclEHenNg
+parentWikiToken: MERNwrahSimELOkM6wbcwBUsnze
+updateTime: 1745310885000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cocos2d_lua_sdk_debug
+---
+# 实时调试
+
+#### 一、打印SDK日志
+
+```
+-- 开启打印日志
+-- logLevelNone：打印日志关闭 
+-- logLevelError：打印错误日志 
+-- logLevelInfo：打印详细日志 
+-- logLevelDebug：打印调试日志 
+TDAnalytics.setLogLevel(TDAnalytics.logLevel.logLevelDebug)
+```
+
+<!-- unsupported block: 34 -->
+
+打开日志后，可以在IDE中过滤 ThinkingData 相关的日志来观察 SDK 的数据上报。
+
+#### 二、开启 Debug 模式
+
+开启Debug模式需要如下两步操作:
+
+1. 客户端开启Debug模式
+以下是客户端开启Debug模式的示例代码:
+
+```
+--[[
+设置运行模式为 Debug 模式
+debugOff模式:数据会存入缓存，并依据一定的缓存策略上报,默认为NORMAL模式；建议在线上环境使用
+debugOn模式:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
+debugOnly模式:只对数据做校验，不会入库；不建议在线上环境使用
+]]
+TDAnalytics.init(APP_ID, SERVER_URL, TDAnalytics.debugModel.debugOn)
+```
+
+1. AE 后台添加Debug设备
+为了避免 Debug 模式在生产环境上线，规定只有指定的设备才能开启 Debug 模式。只有在客户端开启了 Debug 模式，并且设备 ID 在 AE 后台的"埋点管理"页的"Debug 数据"板块中配置了的设备才能开启 Debug 模式。
+
+设备 ID 可以通过以下三种方式获取：
+
+- AE 平台中事件数据中的 #device_id 属性
+- 客户端日志：SDK 初始化完成后会打印设备 DeviceId
+- 通过实例接口调用：获取设备ID
+<!-- unsupported block: 34 -->
+
+Debug 模式可能会影响数据采集质量和 App 的稳定性，只用于集成阶段数据验证，不要在线上环境使用。

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/cocos2d-lua//350/277/233/351/230/266/346/214/207/345/215/227//350/207/252/345/212/250/351/207/207/351/233/206.md

@@ -0,0 +1,32 @@
+---
+code: cocos2d_lua_sdk_autotrack
+name: "自动采集"
+wikiToken: I5WBwEImSi2kMVknD9Oc8j7RnWd
+parentWikiToken: MERNwrahSimELOkM6wbcwBUsnze
+updateTime: 1745309738000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cocos2d_lua_sdk_autotrack
+---
+# 自动采集
+
+TDAnalytics SDK 提供了三种事件的自动采集：
+
+- `appInstall`: 游戏安装，当安装后首次打开游戏会采集该事件（事件名 `ta_app_install`）
+- `appStart`: 游戏进入前台的时候采集该事件（事件名 `ta_app_start`）
+- `appEnd`: 游戏退到后台的时候采集该事件（事件名 `ta_app_end`）
+通过调用 `enableAutoTrack()` 接口可以开启自动采集：
+
+```
+-- 开启自动采集 默认false：关闭，true：开启
+local autoTack = {
+    appInstall = true,  -- 开启自动采集安装事件
+    appStart = true,  -- 开启自动采集开始事件
+    appEnd = true -- 开启自动采集结束事件
+}
+TDAnalytics.enableAutoTrack(autoTack)
+```
+
+<!-- unsupported block: 34 -->
+
+注意： 如果您需要自定义访客 ID，请务必在开启自动采集功能之前调用 `setDistinctId` 接口设置访客 ID.
+
+###

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/cocos2d-lua//350/277/233/351/230/266/346/214/207/345/215/227//351/242/204/347/275/256/345/261/236/346/200/247.md

@@ -0,0 +1,65 @@
+---
+code: cocos2d_lua_sdk_preset_properties
+name: "预置属性"
+wikiToken: M9iBwKbTyiOJwekIFHqc8hcDn6T
+parentWikiToken: MERNwrahSimELOkM6wbcwBUsnze
+updateTime: 1745310885000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cocos2d_lua_sdk_preset_properties
+---
+# 预置属性
+
+#### 一、 预置属性说明
+
+<!-- unsupported block: 34 -->
+
+各个平台采集的预置属性会有一定的差异，具体可以参考如下文档: Android平台 、 iOS平台  
+
+#### 二、 获取预置属性
+
+服务端埋点需要 App 端的一些预置属性时，可以通过此方法获取 App 端的预置属性，再传给服务端。
+
+```
+-- 获取属性对象
+local presetProperties = TDAnalytics.getPresetProperties()
+
+-- 生成事件预置属性
+local properties = presetProperties.toEventPresetProperties()
+--[[
+   {
+        "#carrier": "中国电信",
+        "#os": "Android",
+        "#device_id": "abb8e87bfb5ce66c",
+        "#screen_height": 2264,
+        "#bundle_id": "com.sw.thinkingdatademo",
+        "#manufacturer": "realme",
+        "#device_model": "RMX1991",
+        "#screen_width": 1080,
+        "#system_language": "zh",
+        "#os_version": "10",
+        "#network_type": "WIFI",
+        "#zone_offset": 8，
+        "#app_version":"1.0"
+    }
+]]--
+
+-- 获取某个预置属性
+local bundleId = presetProperties.bundleId -- 包名
+local mOS =  presetProperties.os -- 系统类型，如 Android/iOS
+local systemLanguage = presetProperties.systemLanguage -- 手机系统语言类型
+local screenWidth = presetProperties.screenWidth -- 屏幕宽度
+local screenHeight = presetProperties.screenHeight -- 屏幕高度
+local deviceModel = presetProperties.deviceModel -- 设备型号
+local deviceId = presetProperties.deviceId -- 设备唯一标识
+local carrier = presetProperties.carrier -- 手机SIM卡运营商信息，双卡双待时，取主卡的运营商信息
+local manufacture = presetProperties.manufacturer -- 手机制造商 如 HuaWei
+local networkType = presetProperties.networkType -- 网络类型
+local osVersion = presetProperties.osVersion -- 系统版本号
+local appVersion = presetProperties.appVersion -- app版本号
+local zoneOffset = presetProperties.zoneOffset -- 时区偏移值
+```
+
+<!-- unsupported block: 34 -->
+
+IP，国家城市信息由服务端解析生成，客户端不提供接口获取这些属性
+
+###