自定义事件是为了给开发者提供自定义上报统计数据的功能,如统计登录、注册、分享、点击某个按钮,我们都可以称之为自定义事件。
自定义事件 API
uni.report( eventName , options)
参数说明
参数 | 类型 | 描述 |
---|---|---|
eventName | String | 事件名称,最大长度不超过 255 个字符 |
options | String 、 Object | 事件参数 |
Tips
- eventName 为 String 类型,并且字符长度必须小于255
- options 为 String 类型时,字符长度必须小于255
- options 为 Object 类型时,该对象的值只能为 String 类型
- 字符串支持特殊字符但不包括(英文逗号 , 英文冒号 : 点 .)
- eventName 为
title
时为内容标题上报,用户不能自定义。此时数据会展现在uni统计的首页-内容统计及左侧导航的内容统计中。方便查看内容页数据。 - 用户在使用
uni.login()
会执行登录事件,不携带参数。如果如需上报携带具体参数的数据,需要手动调用uni.report('login',{...})
- 用户在使用
uni.share()
或触发onShareAppMessage
会执行分享事件,不携带参数。如果如需上报携带具体参数的数据,需要手动调用uni.report('share',{...})
- 用户在使用
uni.requestPayment()
会执行支付事件,不携带参数。如果如需上报携带具体参数的数据,需要手动调用uni.report('pay_success',{...})
和uni.report('pay_fail',{...})
示例
// 内容统计
// 当 eventName 为 title 时,options 只能为 String 类型
uni.report('title','首页')
// 登录
uni.report('login',{
'name':'uni-app',
'age':'21',
// ...
})
// 分享
uni.report('share','分享')
// 支付成功
uni.report('pay_success','支付成功')
// or
uni.report('pay_success',{
"订单金额":'20元',
"订单名称":'鼠标',
// ...
})
// 支付失败
uni.report('pay_fail','支付失败')
// or
uni.report('pay_fail',{
"订单金额":'20元',
"订单名称":'鼠标',
// ...
})
// 注册
uni.report('register',{
'name':'uni-app',
'age':'21',
// ...
})
// 搜索
uni.report('search','搜索内容')
// or
uni.report('search',{
'内容':'搜索内容'
})
自定义事件上报后,在统计后台的事件和转换
栏目中,可以看到上报的事件情况。
152 个评论
要回复文章请先登录或注册
yangjw
DCloud_UNI_HT (作者)
6***@qq.com
DCloud_UNI_HT (作者)
胜天半子祁厅长
胜天半子祁厅长
胜天半子祁厅长
DCloud_UNI_HT (作者)
1***@qq.com
T泰达T