预置事件

事件英文变量名事件显示名属性英文变量名事件属性显示名属性值类型属性值示例或说明触发时机说明对应的生命周期
$MPLaunch小程序启动
$预置属性

小程序进程被杀死,重新打开且在相应小程序生命周期函数中调用了 sa.quick( 'appLaunch', options ) 时会触发

小程序初始化完成时,全局只触发一次








App.onLaunch
$scene启动场景字符串
$url_path页面路径字符串
$is_first_time是否首次布尔值
$utm_source广告系列来源字符串0.3 版本以上
$utm_medium广告系列媒介字符串0.3 版本以上
$utm_term广告系列字词字符串0.3 版本以上
$utm_content广告系列内容字符串0.3 版本以上
$utm_campaign广告系列名称字符串0.3 版本以上
$MPShow小程序显示
$预置属性

小程序启动,或从后台进入前台显示且在相应小程序生命周期函数中调用了 sa.quick( 'appShow', options ) 时会触发启动小程序时

App.onShow

$scene启动场景字符串
$url_path页面路径字符串
$utm_source字符串广告系列来源0.3 版本以上
$utm_medium字符串广告系列媒介0.3 版本以上
$utm_term字符串广告系列字词0.3 版本以上
$utm_content字符串广告系列内容0.3 版本以上
$utm_campaign字符串广告系列名称0.3 版本以上
$MPHide小程序进入后台
$预置属性

点击小程序右上角退出按钮、相关 App 进入后台、进入小程序关于页面、手机锁屏、小程序进程被杀死且在相应小程序生命周期函数中调用了 sa.quick( 'Hide' ) 时会触发时小程序从前台进入后台App.onHide
$event_duration停留时长数值从本次小程序显示 $MPShow 到 $MPHide 小程序进入后台或者关闭的时间
$url_path页面路径字符串
$MPClick小程序元素点击
$预置属性

小程序页面元素被点击时触发,被点击元素使用 onTap 或者 onLongTap 添加监听时才会采集0.8.0 及以上版本
$element_id元素 ID字符串元素需要设置 id 属性
$element_name元素名字字符串元素需要设置 data-name 属性
$element_content元素内容字符串元素需要设置 data-content 属性
$element_type元素类型字符串元素需要设置 data-type 属性
$MPViewScreen小程序页面浏览
$预置属性




$url_path页面路径字符串



所有事件都有的预置属性

字段名称类型说明备注
$lib字符串SDK 类型字节跳动小程序 SDK 的值为 BytedanceMini
$lib_version字符串SDK 版本
$app_id字符串字节跳动小程序 AppID0.6.0 及以上版本
$screen_height数值屏幕高度
$screen_width数值屏幕宽度
$model字符串设备型号
$manufacturer字符串设备制造商
$os字符串操作系统
$os_version字符串操作系统版本
$is_first_day布尔值是否首日访问(从新用户第一次访问到当天的凌晨十二点之间的值都为真,之后为假,标识存在 storage 中)
$is_login_id布尔值是否是登录 ID (数据入库时判断添加)
$ip字符串SDK 发送数据请求时携带的属性
$timezone_offset数值时区偏移量0.6.0 及以上版本
$country字符串由 IP 解析得到
$province字符串由 IP 解析得到
$city字符串由 IP 解析得到
$network_type字符串网络类型
$browser字符串浏览器名称,由 UA 解析得到
$browser_version字符串浏览器版本,由 UA 解析得到
$latest_utm_source字符串最近一次付费广告系列来源0.3 及以上版本
$latest_utm_medium字符串最近一次付费广告系列媒介0.3 及以上版本
$latest_utm_term字符串最近一次付费广告系列字词0.3 及以上版本
$latest_utm_content字符串最近一次付费广告系列内容0.3 及以上版本
$latest_utm_campaign字符串最近一次付费广告系列名称0.3 及以上版本
$latest_scene字符串最近一次启动场景值0.3 及以上版本