自动采集

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

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

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

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

一、 开启自动采集事件

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

var config = {
    appid: "YOUR_APPID",
    server_url: "YOUR_SERVER_URL",
    autoTrack: {
         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 {};
           }
         }
     }
};

• appShow：自动采集小游戏启动，或从后台进入前台
• appHide：自动采集小游戏从前台进入后台
• properties：自动采集自定义属性（支持 appShow/appHide）
• callback：自动采集回调（支持 appShow/appHide）

二、 自动采集事件详解

2.1 小游戏启动

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

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

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

2.2 小游戏隐藏

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

• 事件名：ta_mg_hide
• 自动采集属性：
  • #scene，场景值，取自微信提供的场景值
  • #duration，数值型，表示本次启动（ta_mg_show）到隐藏的持续时长

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