---
code: uniapp_sdk_autotrack
name: "自动采集"
wikiToken: USErwv6jRi64tOkeWrYc22nangd
parentWikiToken: R6t6weBoli9ljYk1lOMcblrbnAe
updateTime: 1763015723000
sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=uniapp_sdk_autotrack
---
# 自动采集

我们提供了自动采集功能，只需在创建实例的 config 中开启您需要自动采集的事件，SDK 将会自动采集小程序的一些行为，现在主要有以下几种事件支持自动采集：

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

1. 小程序初始化，用户一次使用只会触发一次
1. 小程序启动，包括启动与后台调回前台
1. 小程序调入后台，并记录本次访问（启动至调入后台）的时间
接下来将会详细介绍每种数据的采集方法

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

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

```
var config = {
  appid: "YOU-APP-ID",
  server_url: "https://youserverurl.com",
  autoTrack: {
    appLaunch: true, // 自动采集 ta_mp_launch
    appShow: true, // 自动采集 ta_mp_show
    appHide: true, // 自动采集 ta_mp_hide
  }
};
```

- `appLaunch`：自动采集小程序初始化
- `appShow`：自动采集小程序启动，或从后台进入前台
- `appHide`：自动采集小程序从前台进入后台
### 二、 自动采集事件详解

#### 2.1 小程序初始化

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

- 事件名：ta_mp_launch
- 自动采集属性： 
- `#scene`，场景值，取自微信提供的场景值
通过小程序初始化事件，您可以计算每天的用户使用次数、人均使用次数，包括以场景值做分组，查看不同场景值的用户的使用情况。

#### 2.2 小程序启动

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

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

#### 2.3 小程序隐藏

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

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