自动采集

# 一、 介绍

引力引擎 SDK 提供了自动采集功能，支持自动采集一些基础行为事件，目前主要有以下几种事件支持自动采集：

1. 启动（$MPLaunch）：用户一次使用只会触发一次
2. 展示（$MPShow）：包括启动之后首次展示与后台调回前台
3. 进入后台（$MPhide）：并记录本次访问（展示至进入后台）的时间
4. 页面展示（$MPViewScreen）：自动记录页面的路径以及前向路径
5. 转发分享（$MPShare）：自动记录转发时的页面

本文将会对每种类型的自采集事件做详细介绍。

# 二、 开启自动采集

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

var config = {
  autoTrack: {
    appLaunch: true, // 自动采集 $MPLaunch
    appShow: true, // 自动采集 $MPShow
    appHide: true, // 自动采集 $MPhide
    pageShow: true, // 自动采集 $MPViewScreen
    pageShare: true, // 自动采集 $MPShare
  },
};

不同平台由于运行环境以及结构原因，支持不同的自动采集事件，支持列表如下：

# 三、 详细介绍

# 3.1 启动事件

• 英文事件名：$MPLaunch（快应用类型的产品，对应为：$AppStart）
• 触发时机：首次打开或用户杀死进程再重新开启时触发，在进程的生命周期内只会触发一次。
• 自动采集属性：
  • $scene，场景值，取自微信提供的场景值
  • $url_query，页面参数

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

# 3.2 展示事件

• 英文事件名：$MPShow
• 触发时机：启动之后首次展示或后台调回前台时触发。
• 自动采集属性：
  • $scene，场景值，取自微信提供的场景值
  • $url_path，页面路径，小程序启动被展示页面的路径
  • $url_query，页面参数

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

# 3.3 进入后台事件

• 英文事件名：$MPHide
• 触发时机：在进入后台时触发，并记录本次使用的时长。
• 自动采集属性：
  • $scene，场景值，取自微信提供的场景值
  • $event_duration，数值型，表示本次启动（$MPShow）到进入后台的持续时长，单位为秒

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

# 3.4 页面浏览事件

• 英文事件名：$MPViewScreen
• 触发时机：在页面被打开时，或从后台调回前台的页面展示时触发，会记录页面的路径以及访问的前向路径。
• 自动采集属性：
  • $scene，场景值，取自微信提供的场景值
  • $url_path，页面路径，也就是被展示页面的路径
  • $url_query，页面参数

通过页面浏览事件，您可以计算每个页面的 pv、uv，以及用户访问小程序的使用路径。

# 3.5 页面转发分享事件

• 英文事件名：$MPShare
• 触发时机：在转发按钮被点击时触发（包括右上角导航栏的转发按钮，以及页面中的转发按钮）。
• 自动采集属性：
  • $scene，场景值，取自微信提供的场景值
  • $url_path，页面路径，也就是转发时所在的页面路径
  • $share_method，分享途径
  • $share_depth，页面层级

页面转发分享事件，适合对页面的分享率进行分析，可以帮助您优化页面转发。