自动采集

最近更新 2026/10/03

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

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

1. 小游戏回到前台的事件
2. 小游戏调入后台，并记录本次访问（启动至调入后台）的时间

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

一、 开启自动采集事件

在 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）到隐藏的持续时长

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