预置事件

事件英文变量名事件显示名属性英文变量名事件属性显示名属性值类型触发时机说明备注
$MPLaunch小程序启动
$预置属性
小程序进程被杀死,重新打开且在相应小程序生命周期函数中调用了 sa.quick( 'appLaunch', options ) 时会触发小程序初始化完成时,全局只触发一次
$scene启动场景字符串
$url_path页面路径字符串
$is_first_time是否首次布尔值
$utm_source字符串广告系列来源
$utm_medium字符串广告系列媒介
$utm_term字符串广告系列字词
$utm_content字符串广告系列内容
$utm_campaign字符串广告系列名称
$MPShow小程序显示
$预置属性
小程序启动,或从后台进入前台显示且在相应小程序生命周期函数中调用了 sa.quick( 'appShow', options ) 时会触发启动小程序时
$scene启动场景字符串
$url_path页面路径字符串
$utm_source字符串广告系列来源
$utm_medium字符串广告系列媒介
$utm_term字符串广告系列字词
$utm_content字符串广告系列内容
$utm_campaign字符串广告系列名称
$MPHide小程序进入后台
$预置属性
点击小程序右上角退出按钮、百度 App 进入后台、进入小程序关于页面、手机锁屏、小程序进程被杀死且在相应小程序生命周期函数中调用了 sa.quick( 'Hide' ) 时会触发时小程序从前台进入后台
$event_duration停留时长数值
$url_path页面路径字符串
$MPViewScreen小程序页面浏览
$预置属性
小程序启动打开页面、小程序内打开页面、从后台进入前台打开页面时触发每次打开页面都会调用一次

不支持 uni-app 框架开发的小程序

需要 v0.6.0 及以后版本才支持

$url_path页面路径字符串
$MPClick小程序元素点击
$预置属性
小程序页面元素被点击时触发被点击元素使用 bindtap/bindlongtap/bindlongpress 添加监听时才会采集
$element_id元素 ID字符串
$element_name元素名字字符串
$element_content元素内容字符串
$element_type元素类型字符串
$url_path页面路径字符串

所有事件都有的预置属性

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

预置用户属性

属性名属性类型默认显示名说明备注
$first_visit_time时间首次访问时间 新用户首次访问小程序时, 会给此属性赋值因为这些属性的设置时机是新用户首次访问小程序时,才会设置这些属性,新用户一般时以匿名 ID 标记用户行为,如果登录 ID 和匿名 ID 关联失败,则登录 ID 不会由这些属性值。
$utm_source字符串首次广告系列来源

使用小程序渠道追踪,且新用户首次访问时,通过带有 utm 参数的渠道访问时,才会采集这些用户属性。如果时老用户,即使通过渠道访问小程序,也不会设置这些用户属性。新老用户的标记可以参考此文档:新增用户及首日首次标记

$utm_medium字符串首次广告系列媒介
$utm_term字符串首次广告系列字词
$utm_content字符串首次广告系列内容
$utm_campaign字符串首次广告系列名称