You need to enable JavaScript to run this app.
最新活动
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们
导航

小程序预置事件及属性

最近更新时间2023.02.21 11:24:16

首次发布时间2023.02.21 11:24:16

事件名监听时机事件说明属性属性描述属性类型备注

app_launch

App.onShow

小程序冷启动,以及从后台进入前台时上报,另外在设置user_unique_id时也会上报

session_id

session_id是由SDK随机生成的,每次App.onShow时都生成新的。

string

举例:a829cc7f-c86c-462d-971e-0710e9ff66bd

scene

场景值

number

场景值 场景 appId含义
1020 公众号 profile 页相关小程序列表 来源公众号
1035 公众号自定义菜单 来源公众号
1036 App 分享消息卡片 来源App
1037 小程序打开小程序 来源小程序
1038 从另一个小程序返回 来源小程序
1043 公众号模板消息 来源公众号

path启动小程序的路径string
$is_first_time是否首次访问string'true'或者'false'

query_${key}

启动小程序的query对象中每一个query属性,每个属性会增加"query_"作为前缀。

any

举例:
原始query对象为
{
a: 'isa',
b: 'notb'
}
会产生
query_a: 'isa'
query_b: 'notb'
放入app_launch事件中作为事件属性

app_terminate

App.onHide

小程序退出以及进入后台时上报,另外在设置user_unique_id的变更前也会上报

session_id

同上

scene同上
exit_page退出时小程序所在页面的路径string通过getCurrentPages()获取到当前页面的path
session_durationsession时长,秒number在app_launch时记录一个时间,然后在app_terminate时计算出时间差
session_depth会话深度number在app_launch时开始时设置session_depth为0,之后每次页面切换时对session_depth进行加1,最后在app_terminate时获取带上

query_${key}

当前页面的options对象中每一个option属性,每个属性会增加"query_"作为前缀。

any

通过getCurrentPages()获取到当前页面的options
处理方式同app_launch时的做法一致

on_error

App.onError

小程序发生脚本错误或 API 调用报错时触发

session_id

同上

on_error错误信息string

predefine_pageview

Page.onShow

页面显示时上报,另外在后退操作时也会上报

session_id

同上

scene同上
path当前页面的路径string通过getCurrentPages()获取到当前页面的path

query_${key}

当前页面的options对象中每一个option属性,每个属性会增加"query_"作为前缀。

any

通过getCurrentPages()获取到当前页面的options
处理方式同app_launch时的做法一致

predefine_pageview_hide

Page.onHide

页面隐藏

session_id

同上

这几个都是predefine_pageview时的属性,在predefine_pageview_hide时重复带上

duration停留时长,毫秒在predefine_pageview时记录一个时间,然后在predefine_pageview_hide时计算出时间差

on_share

Page.onShareAppMessage

转发

session_id

同上

path

转发时业务所定义的路径,并且SDK会为path增加额外的4个参数:
from_uid
from_user_unique_id
share_depth
from_title

string

举例:
业务原本的path假设为"/page/index?a=1&b=2",以及title为测试分享的标题,则处理后的path为"/page/index?a=1&b=2&from_uid=45c9b10b-7b66-406c-be40-6ecbb68c2d5e&from_user_unique_id=bytedance-test&share_depth=1&from_title=测试分享的标题"

title转发时业务所定义的标题string

page_path

path去掉query后的路径

string

举例:
path: "/page/index?a=1&b=2"
page_path: "/page/index"

query_from_uid当前ssidstringssid是由数据流下发的
query_share_depth分享深度number在app_luanch的时候获取query中的share_depth并记录下来,在转发时,有则加1,没有则为1
on_addtofavoritesPage.onAddToFavorites收藏title收藏时所定义的标题string

url_path

path去掉query后的路径

string

举例:
path: "/page/index?a=1&b=2"
url_path: "/page/index"

url_query

path中query部分

string

举例:
path: "/page/index?a=1&b=2"
url_query: "a=1&b=2"

bav2b_clickPage中定义的事件处理函数被触发时目前只支持tap事件path当前页面的路径string通过getCurrentPages()获取到当前页面的path
page_key目前等于pathstring

query_${key}

当前被触发节点所附加一些自定义数据(dataset)

string

举例:
组件上设置了data-xxx="这是xxx",被采集作为query_xxx: "这是xxx"