# 自动采集
在创建实例的 config 中开启您需要自动采集的事件,SDK 将会自动采集小游戏的一些行为,现在主要有以下几种事件支持自动采集:
现在支持的自动化收集数据有:
- 小游戏回到前台的事件
- 小游戏调入后台,并记录本次访问(启动至调入后台)的时间
接下来将会详细介绍每种数据的采集方法
# 一、 开启自动采集事件
在 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)到隐藏的持续时长
小游戏隐藏事件会记录使用时长(单位为秒),因此可以直接计算用户使用总时长以及人均时长,也可以除以初始化次数计算单次使用时长。