# 自动采集
我们提供了自动采集功能,只需在创建实例的 config 中开启您需要自动采集的事件,SDK 将会自动采集小程序的一些行为,现在主要有以下几种事件支持自动采集:
现在支持的自动化收集数据有:
- 小程序初始化,用户一次使用只会触发一次
- 小程序启动,包括启动与后台调回前台
- 小程序调入后台,并记录本次访问(启动至调入后台)的时间
- 小程序页面显示或切入前台,自动记录页面的路径以及前向路径
- 小程序进行转发分享,自动记录转发时的页面
接下来将会详细介绍每种数据的采集方法
# 一、 开启自动采集事件
在 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
pageShow: true, // 自动采集 ta_mp_view
pageShare: true, // 自动采集 ta_mp_share
}
};
appLaunch
:自动采集小程序初始化appShow
:自动采集小程序启动,或从后台进入前台appHide
:自动采集小程序从前台进入后台pageShow
:自动采集小程序页面显示或切入前台pageShare
:自动采集小程序进行转发分享
# 二、 自动采集事件详解
# 2.1 小程序初始化
小程序初始化将会在小程序被首次打开时,或用户杀死进程再重新开启时触发,在进程的生命周期内只会触发一次,详细的事件介绍如下:
- 事件名:ta_mp_launch
- 自动采集属性:
#scene
,场景值,取自微信提供的场景值
通过小程序初始化事件,您可以计算每天的用户使用次数、人均使用次数,包括以场景值做分组,查看不同场景值的用户的使用情况。
# 2.2 小程序启动
小程序启动将会在小程序被启动、或小程序被从后台调回前台时触发,详细的事件介绍如下:
- 事件名:ta_mp_show
- 自动采集属性:
#scene
,场景值,取自微信提供的场景值#url_path
,页面路径,小程序启动被展示页面的路径
小程序启动由于会受到调出前后台的影响(条数较多),因此不太适合直接进行分析,但是可以在行为路径中标识用户的一次使用,可以作为用户行为路径的初始行为
# 2.3 小程序隐藏
小程序隐藏将会在小程序被调入后台时触发,并记录本次使用的时长,详细的事件介绍如下:
- 事件名:ta_mp_hide
- 自动采集属性:
#scene
,场景值,取自微信提供的场景值#duration
,数值型,表示本次启动(ta_mp_show)到隐藏的持续时长
小程序隐藏事件会记录使用时长(单位为秒),因此可以直接计算用户使用总时长以及人均时长,也可以除以初始化次数计算单次使用时长。
# 2.4 小程序页面浏览
小程序页面浏览将会在小程序的页面被打开时,或小程序从后台调回前台的页面展示时触发,会记录页面的路径以及访问的前向路径,详细的事件介绍如下:
- 事件名:ta_mp_view
- 自动采集属性:
#scene
,场景值,取自微信提供的场景值#url_path
,页面路径,也就是被展示页面的路径#referrer
,前向路径,被展示页面之前页面的路径,也就是跳转前路径,如果是启动小程序时展示的首页,则取值为“直接打开”
通过小程序页面浏览事件,您可以计算每个页面的 pv、uv,以及用户访问小程序的使用路径。
# 2.5 小程序页面转发分享
小程序页面转发分享将会在转发按钮被点击时触发(包括右上角导航栏的转发按钮,以及页面中的转发按钮),详细的事件介绍如下:
- 事件名:ta_mp_share
- 自动采集属性:
#scene
,场景值,取自微信提供的场景值#url_path
,页面路径,也就是转发时所在的页面路径
小程序页面转发分享事件,适合对页面的分享率进行分析,可以帮助您优化页面转发。