---
code: cocos2d-x_sdk_autotrack
name: "自动采集"
wikiToken: LQqRwyJ5tiBQcqkXIqDcbQFxnFe
parentWikiToken: AoyTwkwUniCkJsk1HnRcjV8vngh
updateTime: 1745309726000
sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cocos2d-x_sdk_autotrack
---
# 自动采集

TDAnalytics SDK 提供了三种事件的自动采集：

- ta_app_install: 游戏安装，当安装后首次打开游戏会采集该事件
- ta_app_start: 游戏进入前台的时候采集该事件
- ta_app_end: 游戏退到后台的时候采集该事件
通过调用 `enableAutoTrack` 接口可以开启自动采集：

```
// 开启自动采集
TDAnalytics::enableAutoTrack();
```

<!-- unsupported block: 34 -->

注意： 如果您需要自定义访客 ID，请务必在开启自动采集功能之前调用 setDistinctId 接口设置访客 ID.

v1.3.2 版本开始支持为自动采集事件设置自定义属性，当采集指定的事件时，会将自定义属性合并到该事件属性中并上报。

```
// 开启自动采集，并设置自定义属性
TDJSONObject autoProperties;
autoProperties.setString("auto_track_key", "auto_track_value");
TDAnalytics::enableAutoTrack(autoProperties);
```
