跳到主要内容

自动采集

最近更新 2026/08/27

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

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

  1. 小程序初始化，用户一次使用只会触发一次
  2. 小程序启动，包括启动与后台调回前台
  3. 小程序调入后台，并记录本次访问（启动至调入后台）的时间

接下来将会详细介绍每种数据的采集方法

一、 开启自动采集事件​

在 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
    appInstall: true,//自动采集 安装事件（仅 native 生效）
    appCrash: true, // 自动采集 崩溃事件（仅 native 生效）
  }
};
  • appLaunch：自动采集小程序初始化
  • appShow：自动采集小程序启动，或从后台进入前台
  • appHide：自动采集小程序从前台进入后台
  • appInstall ：自动采集安装事件（仅 native 生效）
  • appCrash ：自动采集崩溃事件（仅 native 生效）

二、 自动采集事件详解​

2.1 小程序初始化​

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

  • 事件名：ta_mp_launch
  • 自动采集属性：
    • #scene，场景值，取自微信提供的场景值

通过小程序初始化事件，您可以计算每天的用户使用次数、人均使用次数，包括以场景值做分组，查看不同场景值的用户的使用情况。

2.2 小程序启动​

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

  • 事件名：ta_mp_show

  • 自动采集属性：

    • #scene，场景值，取自微信提供的场景值
    • #url_path，页面路径，小程序启动被展示页面的路径

小程序启动由于会受到调出前后台的影响（条数较多），因此不太适合直接进行分析，但是可以在行为路径中标识用户的一次使用，可以作为用户行为路径的初始行为

2.3 小程序隐藏​

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

  • 事件名：ta_mp_hide

  • 自动采集属性：

    • #scene，场景值，取自微信提供的场景值
    • #duration，数值型，表示本次启动（ta_mp_show）到隐藏的持续时长

小程序隐藏事件会记录使用时长（单位为秒），因此可以直接计算用户使用总时长以及人均时长，也可以除以初始化次数计算单次使用时长。

这篇文档对你有帮助吗？
本页内容