DCloud_UNI_HT
DCloud_UNI_HT
  • 发布:2019-08-20 16:39
  • 更新:2024-10-09 11:03
  • 阅读:33884

uni 统计自定义事件说明

分类:uni-app

自定义事件是为了给开发者提供自定义上报统计数据的功能,如统计登录、注册、分享、点击某个按钮,我们都可以称之为自定义事件。

自定义事件 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',{  
  '内容':'搜索内容'  
})  

自定义事件上报后,在统计后台的事件和转换栏目中,可以看到上报的事件情况。

5 关注 分享
秋凡 4***@qq.com f***@qq.com 4***@qq.com 雕兄

要回复文章请先登录注册

yangjw

yangjw

uni 统计1.0, 自定义事件 uni.report,事件管理没有数据,还有一个疑问,使用uni统计2.0,项目是不是要和 uni-admin 绑定同一个云函数
2023-02-23 11:32
DCloud_UNI_HT

DCloud_UNI_HT (作者)

回复 6***@qq.com :
什么情况下出现的?
2023-01-28 16:51
6***@qq.com

6***@qq.com

uni.report is not a function 这是为什么?是什么地方我没配置?
2023-01-09 10:29
DCloud_UNI_HT

DCloud_UNI_HT (作者)

回复 胜天半子祁厅长 :
需求已了解
2022-10-27 11:25
胜天半子祁厅长

胜天半子祁厅长

回复 胜天半子祁厅长 :
自己临时实现了: https://ask.dcloud.net.cn/article/40120
2022-10-27 06:21
胜天半子祁厅长

胜天半子祁厅长

共享一段代码,可以临时解决自定义事件搜索统计等问题: https://ask.dcloud.net.cn/article/40120
2022-10-27 06:21
胜天半子祁厅长

胜天半子祁厅长

麻烦新版本增加一下事件ID、设备标识搜索条件,现在这个自定义事件完全用不起来,这两个搜索条件实现应该也简单?加上了的话就可以用起来了
2022-10-27 03:46
DCloud_UNI_HT

DCloud_UNI_HT (作者)

回复 赵永强 :
已经增加配置 ,可不开启
2022-10-14 11:52
1***@qq.com

1***@qq.com

是否支持额外参数
2022-09-12 18:49
T泰达T

T泰达T

为什么自定义事件是分开统计的,有啥意义……为什么不把所有相同ID的事件合并起来统计次数???一天事件数据几百上千条怎么看
2022-08-03 09:21