---
code: cocoscreator_sdk_autotrack
name: "自动采集"
wikiToken: Ex5tw4Co9iROrJkDVu3cKw02nzQ
parentWikiToken: RvASwF6gWieCFIkqqRlchH0xnUg
updateTime: 1765346387000
sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cocoscreator_sdk_autotrack
---
# 自动采集

在创建实例的 config 中开启您需要自动采集的事件，SDK 将会自动采集小游戏的一些行为，现在主要有以下几种事件支持自动采集：

现在支持的自动化收集数据有：

1. 小游戏回到前台的事件
1. 小游戏调入后台，并记录本次访问（启动至调入后台）的时间
接下来将会详细介绍每种数据的采集方法

### 一、 开启自动采集事件

在 config 中，参数 `autoTrack` 中的元素表示每个自动采集事件的开关，设置为 `true` 为开启自动采集：

```
var config = {
    appId: "YOUR_APPID",
    serverUrl: "YOUR_SERVER_URL",
    autoTrack: {
         appLaunch: true, // 自动采集 ta_mg_launch
         appShow: true, // 自动采集 ta_mg_show
         appHide: true, // 自动采集 ta_mg_hide
         properties: { // 自动采集自定义属性staticKey: 'staticValue'},
         callback: (eventType:any) =>{ // 自动采集回调
           if (eventType === 'appShow')
           {
            return { appShowKey: 'appShowValue' };
           } 
           else if (eventType === 'appHide')
           {
            return { appHideKey: 'appHideValue' };
           } 
           else {
             return {};
           }
         }
     }
};
TDAnalytics.init(config);
```

- appLaunch：自动采集小游戏初始化
- appShow：自动采集小游戏启动，或从后台进入前台
- appHide：自动采集小游戏从前台进入后台
- properties：自动采集自定义属性（支持appShow/appHide）
- callback：自动采集回调（支持appShow/appHide）
如果需要首个自动采集事件带上账号、访客和静态公共属性，可以在初始化传入如下配置：

```
TDAnalytics.init(config, () => {
  TDAnalytics.login("TA")
  TDAnalytics.setDistinctId("DIS_TA")
  TDAnalytics.setSuperProperties({
    key: "value"
  });
});
```

### 二、 自动采集事件详解

#### 2.1 小游戏初始化

小游戏初始化将会在小游戏被首次打开时，或用户杀死进程再重新开启时触发，在进程的生命周期内只会触发一次，详细的事件介绍如下：

- 事件名：ta_mg_launch
- 自动采集属性： 
- `#scene`，场景值，取自微信提供的场景值
- `#start_reason`，应用启动来源，是从`getLaunchOptionsSync`接口获取的参数
通过小游戏初始化事件，您可以计算每天的用户使用次数、人均使用次数，包括以场景值做分组，查看不同场景值的用户的使用情况。

#### 2.2 小游戏启动

小游戏启动将会在小游戏被启动、或小游戏被从后台调回前台时触发，详细的事件介绍如下：

- 事件名：ta_mg_show
- 自动采集属性：
- `#scene`，场景值，取自微信提供的场景值
小游戏启动由于会受到调出前后台的影响（条数较多），因此不太适合直接进行分析，但是可以在行为路径中标识用户的一次使用，可以作为用户行为路径的初始行为

#### 2.3 小游戏隐藏

小游戏隐藏将会在小游戏被调入后台时触发，并记录本次使用的时长，详细的事件介绍如下：

- 事件名：ta_mg_hide
- 自动采集属性：
- `#scene`，场景值，取自微信提供的场景值
- `#duration`，数值型，表示本次启动（ta_mg_show）到隐藏的持续时长
小游戏隐藏事件会记录使用时长（单位为秒），因此可以直接计算用户使用总时长以及人均时长，也可以除以初始化次数计算单次使用时长。
