## 自定义事件 自定义事件 支持平台:微信小程序、微信小游戏 ## ## 一、自定义事件上报方法 wx.aldstat.sendEvent( key, value ) 定义:该方法接收两个参数,第一个参数key为事件名称。第二个参数vaule为事件本身的参数,该参数可以为一个字符串( String )或者一个JavaScript对象 ( Object )。 参数: ``` 1 key : string 2 3 value: { string | object } ``` 规则: ![](https://img.kancloud.cn/44/5c/445cf91e7b1c12a5aea3e3bf0dd53287_426x395.png) 满足上述规则时,SDK才会上报事件及其参数。否则SDK 不会上报。 ## ## 二、自定义事件成功检测 例如,以获取用户昵称为例,进行事件上报,代码如下: ``` 1 wx.aldstat.sendEvent('获取用户昵称', { 2 "用户昵称": "DemoChen" 3 }) ``` 上报成功后如下图所示: ![](http://aldpicsh-1252823355.cossh.myqcloud.com/ueditor/1578224507.jpg) 埋点验证成功后,将所有代码提交至微信审核,审核通过后需发布版本 ## ## 三、如何结合业务场景进行埋点 案例一、以小程序 \[ 麦当劳 \] 举例 定义埋点目的:积分兑换优惠劵模中,查看商品的成功兑换情况 ![](http://aldpicsh.aldwx.com/doc_aldwx/xcxtj-zdysj01.jpg) 埋点方式 ![](http://aldpicsh.aldwx.com/doc_aldwx/xcxtj-zdysj02.jpg) 点击确定,成功兑换商品时上传事件 ``` 1 Page({ 2 onLoad(){ 3 }, 4 5 onShow(){ 6 7 }, 8 9 // 触发自定义事件,比如当前点击确定提交事件的时候触发埋点上报。 10 submit(){ 11 /\*其他逻辑\*/ 12 13 wx.aldstat.sendEvent('兑换商品',{ 14 '商品名': '免费海盐柠檬苏打(1杯)' 15 }); 16 } 17 }) ``` 案例二、以小程序 \[ 每日优鲜 \] 举例 ![](http://aldpicsh.aldwx.com/doc_aldwx/xcxtj-zdysj03.jpg) ​​​​​定义埋点目的:有多少人点击“加入购物车”及加入该商品的参数信息 ``` 1 Page({ 2 onLoad(){}, 3 onShow(){}, 4 //加入购物车 5 JoinCar:function(){ 6 wx.aldstat.sendEvent("加入购物车",{ 7 "商品名称":"", 8 "商品价格":"", 9 "加入时间":Data.now() 10 11 }) 12 } 13 }) ``` 埋点验证成功后,将所有代码提交至微信审核,审核通过后需发布版本 ​