自定义事件 支持平台:微信小程序、微信小游戏
wx.aldstat.sendEvent( key, value )
定义:该方法接收两个参数,第一个参数key为事件名称。第二个参数vaule为事件本身的参数,该参数可以为一个字符串( String )或者一个JavaScript对象 ( Object )。
参数:
key : stringvalue: { string | object }
规则:
字段 | 类型 | 描述 |
事件名称 | string | 描述用户的动作名称,不超过255个字符,支持特殊字符 |
参数 | string | 动作的参数,不超过255个字符,支持特殊字符但不包括(英文逗号 , 英文冒号 : 点 .) |
参数值 | string | 动作的参数值,不超过255个字符,支持特殊字符但不包括(英文逗号 , 英文冒号 : 点 .) |
满足上述规则时,SDK才会上报事件及其参数。否则SDK 不会上报。
例如,以获取用户昵称为例,进行事件上报,代码如下:
wx.aldstat.sendEvent('获取用户昵称', {"用户昵称": "DemoChen"})
上报成功后如下图所示:
埋点验证成功后,将所有代码提交至微信审核,审核通过后需发布版本
案例一、以小程序 [ 麦当劳 ] 举例
定义埋点目的:积分兑换优惠劵模中,查看商品的成功兑换情况
埋点方式
点击确定,成功兑换商品时上传事件
Page({onLoad(){},onShow(){},// 触发自定义事件,比如当前点击确定提交事件的时候触发埋点上报。submit(){/*其他逻辑*/wx.aldstat.sendEvent('兑换商品',{'商品名': '免费海盐柠檬苏打(1杯)'});}})
案例二、以小程序 [ 每日优鲜 ] 举例
定义埋点目的:有多少人点击“加入购物车”及加入该商品的参数信息
Page({onLoad(){},onShow(){},//加入购物车JoinCar:function(){wx.aldstat.sendEvent("加入购物车",{"商品名称":"","商品价格":"","加入时间":Data.now()})}})
埋点验证成功后,将所有代码提交至微信审核,审核通过后需发布版本