微信小游戏 SDK 预置事件和预置属性
|
收藏
预置事件
事件英文变量名 | 事件显示名 | 属性英文变量名 | 事件属性显示名 | 属性值类型 | 属性值示例或说明 | 触发时机 | 对应的生命周期 |
---|---|---|---|---|---|---|---|
$MPLaunch | 小程序启动 | $预置属性 | 小游戏冷启动时触发 | ||||
$scene | 启动场景 | 字符串 | |||||
$url_query | 页面参数 | 字符串 | |||||
$utm_campaign | 广告系列名称 | 字符串 | |||||
$utm_source | 广告系列来源 | 字符串 | |||||
$utm_medium | 广告系列媒介 | 字符串 | |||||
$utm_term | 广告系列字词 | 字符串 | |||||
$utm_content | 广告系列内容 | 字符串 | |||||
$is_first_time | 是否首次 | 布尔值 | |||||
$share_depth | 分享时的层级 | 数值 | |||||
$share_distinct_id | 分享者的 distinct_id | 字符串 | |||||
$MPShow | 小程序显示 | $预置属性 | 小游戏热启动或者从后台进入前台时触发 | 触发小游戏的 onShow 生命周期函数时触发 | |||
$scene | 启动场景 | 字符串 | |||||
$url_query | 页面参数 | 字符串 | |||||
$url_path | 页面路径 | 字符串 | |||||
$utm_campaign | 广告系列名称 | 字符串 | |||||
$utm_source | 广告系列来源 | 字符串 | |||||
$utm_medium | 广告系列媒介 | 字符串 | |||||
$utm_term | 广告系列字词 | 字符串 | |||||
$utm_content | 广告系列内容 | 字符串 | |||||
$share_depth | 分享时的层级 | 数值 | |||||
$share_distinct_id | 分享时的 distinct_id | 字符串 | |||||
$MPHide | 小程序进入后台 | $预置属性 | 小游戏进入后台时触发 | 触发小游戏的 onHide 生命周期函数时触发 | |||
$event_duration | 停留时长 | 数值 | |||||
$url_path | 页面路径 | 字符串 | |||||
$MPShare | 小程序分享 | $预置属性 | 需要调用神策定义的分享函数 sensors.onShareAppMessage() | ||||
$share_depth | 分享时的层级 | 数值 | |||||
$url_path | 页面路径 | 字符串 |
所有事件都有的预置属性
字段名称 | 类型 | 说明 | 备注 |
---|---|---|---|
$lib | 字符串 | SDK 类型 | 微信小游戏 SDK 的值为 MiniGame |
$lib_version | 字符串 | SDK 版本 | |
$app_id | 字符串 | 小程序的 App ID | 0.2.0 及以上版本支持 |
$screen_height | 数值 | 屏幕高度 | |
$screen_width | 数值 | 屏幕宽度 | |
$model | 字符串 | 设备型号 | |
$manufacturer | 字符串 | 设备制造商 | |
$os | 字符串 | 操作系统 | |
$os_version | 字符串 | 操作系统版本 | |
$is_first_day | 布尔值 | 是否首日访问(从新用户第一次访问到当天的二十三点五十九分五十九秒之间的值都为真,之后都为假,判断标识存在微信 storage 中) | |
$is_login_id | 布尔值 | 是否是登录 ID(数据入库后添加) | |
$ip | 字符串 | SDK 发送数据请求携带的属性 | |
$timezone_offset | 数值 | 时区偏移量 | 0.2.0 及以上版本支持 |
$country | 字符串 | 由 IP 解析得到 | |
$province | 字符串 | 由 IP 解析得到 | |
$city | 字符串 | 由 IP 解析得到 | |
$network_type | 字符串 | 网络类型 | |
$browser | 字符串 | 浏览器类型,由 UA 解析得到 | |
$browser_version | 字符串 | 浏览器版本,由 UA 解析得到 | |
$latest_utm_source | 字符串 | 最近一次广告系列来源 | |
$latest_utm_medium | 字符串 | 最近一次广告系列媒介 | |
$latest_utm_term | 字符串 | 最近一次广告系列字词 | |
$latest_utm_content | 字符串 | 最近一次广告系列内容 | |
$latest_utm_campaign | 字符串 | 最近一次广告系列名称 | |
$latest_scene | 字符串 | 最近一次场景值 |
注意:如果自定义事件的触发时机早于小程序启动 $MPLaunch 和 小程序显示 $MPShow 这两个预置事件,那么首次发送自定义事件时将不会采集 $latest_utm_source、$latest_utm_medium、$latest_utm_term、$latest_utm_content、$latest_utm_campaign、$latest_scene 这些最近一次来源属性。
注:本文档内容为神策产品使用和技术细节说明文档,不包含适销类条款;具体企业采购产品和技术服务内容,以商业采购合同为准。