自动采集
约 1028 字大约 3 分钟
一、 介绍
引力引擎 SDK 提供了自动采集功能,支持自动采集一些基础行为事件,目前主要有以下几种事件支持自动采集:
启动($MPLaunch)
:用户一次使用只会触发一次展示($MPShow)
:包括启动之后首次展示与后台调回前台进入后台($MPhide)
:并记录本次访问(展示至进入后台)的时间页面展示($MPViewScreen)
:自动记录页面的路径以及前向路径转发分享($MPShare)
:自动记录转发时的页面
本文将会对每种类型的自采集事件做详细介绍。
二、 开启自动采集
在初始化时的 config
中,参数 autoTrack
中的元素表示每个自动采集事件的开关,设置为 true
为开启对应事件的自动采集:
var config = {
autoTrack: {
appLaunch: true, // 自动采集 $MPLaunch
appShow: true, // 自动采集 $MPShow
appHide: true, // 自动采集 $MPhide
pageShow: true, // 自动采集 $MPViewScreen
pageShare: true, // 自动采集 $MPShare
},
};
不同平台由于运行环境以及结构原因,支持不同的自动采集事件,支持列表如下:
平台 | appLaunch | appShow | appHide | pageShow | pageShare |
---|---|---|---|---|---|
小程序 | ✅ | ✅ | ✅ | ✅ | ✅ |
小游戏 | ✅ | ✅ | ✅ | ||
快应用 | ✅ |
提示
为了更好的在引力引擎平台做后向数据分析,建议您全部开启。
三、 详细介绍
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
,页面层级
页面转发分享事件,适合对页面的分享率进行分析,可以帮助您优化页面转发。