自定义事件
自定义事件 支持平台:微信小程序、微信小游戏

一、自定义事件上报方法

wx.aldstat.sendEvent( key, value )
定义:该方法接收两个参数,第一个参数key为事件名称。第二个参数vaule为事件本身的参数,该参数可以为一个字符串( String )或者一个JavaScript对象 ( Object )。
参数:
1
key : string
2
3
value: { string | object }
Copied!
规则:
字段
类型
描述
事件名称
string
描述用户的动作名称,不超过255个字符,支持特殊字符
参数
string
动作的参数,不超过255个字符,支持特殊字符但不包括(英文逗号 , 英文冒号 : 点 .)
参数值
string
动作的参数值,不超过255个字符,支持特殊字符但不包括(英文逗号 , 英文冒号 : 点 .)
满足上述规则时,SDK才会上报事件及其参数。否则SDK 不会上报。

二、自定义事件成功检测

例如,以获取用户昵称为例,进行事件上报,代码如下:
1
wx.aldstat.sendEvent('获取用户昵称', {
2
"用户昵称": "DemoChen"
3
})
Copied!
上报成功后如下图所示:
埋点验证成功后,将所有代码提交至微信审核,审核通过后需发布版本

三、如何结合业务场景进行埋点

案例一、以小程序 [ 麦当劳 ] 举例
定义埋点目的:积分兑换优惠劵模中,查看商品的成功兑换情况
埋点方式
点击确定,成功兑换商品时上传事件
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
})
Copied!
案例二、以小程序 [ 每日优鲜 ] 举例
​​​​​定义埋点目的:有多少人点击“加入购物车”及加入该商品的参数信息
1
Page({
2
onLoad(){},
3
onShow(){},
4
//加入购物车
5
JoinCar:function(){
6
wx.aldstat.sendEvent("加入购物车",{
7
"商品名称":"",
8
"商品价格":"",
9
"加入时间":Data.now()
10
11
})
12
}
13
})
Copied!
埋点验证成功后,将所有代码提交至微信审核,审核通过后需发布版本
最近更新 1yr ago