关卡分析
追踪玩家关卡的过关、道具使用情况
支持平台:微信小游戏、QQ小游戏

一、接口和参数

不同接口事件,对应着用户触发的不同事件
//关卡开始
wx.aldStage.onStart()
//关卡进行中
wx.aldStage.onRunning()
//关卡付费上报
wx.aldRevenue()
//关卡结束
wx.aldStage.onEnd()

二、接口事件关系

Could not load image

wx.aldStage.onStart 关卡开始

参数/key
描述
参数类型/value
长度/规则
是否必传
stageId
关卡ID
String
1 , 2 , 3 , 1.1 , 1.2 , 1.3 格式 最多支持 32 个字符
必传
stageName
关卡名称
String
最多支持 32 个字符
必传
userId
用户ID
String
最多支持 32 个字符
可选
wx.aldStage.onStart({
stageId : "1.1", //关卡ID, 必须是1 || 2 || 1.1 || 12.2 格式 该字段必传
stageName : "第一大关-第一小关",//关卡名称,该字段必传
userId : "123456" //用户ID
})

wx.aldStage.onRunning 捕捉用户在关卡中的一些行为和操作

// 在关卡中使用道具
wx.aldStage.onRunning({
stageId : "1.1",
stageName : "第一大关-第一小关",
userId : "123456",
event : "tools"
params : {
itemName : "火力加强",
}
})
参数/key
描述
参数类型/value
长度/规则
是否必传
stageId
关卡ID
String
1 , 2 , 3 , 1.1 , 1.2 , 1.3 格式 最多支持 32 个字符
必传
stageName
关卡名称
String
最多支持 32 个字符
必传
userId
用户ID
String
最多支持 32 个字符
可选
event
事件类型
String
tools:使用道具 award:奖励
必传
params
事件参数
Object
params.itemName
商品/道具名称
String
“屠龙刀”
必传
params.itemId
商品/道具ID
String
"123"
可选
params.itemCount
商品/道具数量
Number
1
可选 默认:1
params.desc
描述
String
“+9屠龙刀”
可选
params.itemMoney
商品/道具价格
Number
12
可选 默认:0

关卡付费上报

wx.aldRevenue({
group:'stage', // 该字段为关卡付费固定字段不可修改 (该字段必传) String
stageId:"1", // 关卡id (该字段必传) String 必须是1 || 2 || 1.1 || 12.2 格式 最多支持 32 个字符
stageName:"第一关", // 关卡名称 (该字段必传) String 最多支持 32 个字符
money:100, // 付费金额 (该字段必传) Number
name:"火力增强", // 付费项目(该字段必传) String 最多支持 32 个字符
desc:"在关卡中使用火力增强,增加实力", // 描述(可选) String 最多支持 32 个字符
})
参数/key
描述
参数类型/value
长度/规则
是否必传
group
固定字段
String
该字段值固定为stage,不可随意修改
必传
stageID
关卡ID
String
格式:1,1.1,2,2.1……最多支持32个字符
必传
stageName
关卡名称
String
最多支持32个字符
必传
money
付费金额
Number
该字段值不能<0
必传
name
付费项目
String
最多支持 32 个字符
必传
desc
描述
String
最多支持 32 个字符
可选

wx.aldStage.onEnd 捕捉用户在关卡中的一些操作

参数/key
描述
参数类型/value
长度/规则
是否必传
stageId
关卡ID
String
1 , 2 , 3 , 1.1 , 1.2 , 1.3 格式 最多支持 32 个字符
必传
stageName
关卡名称
String
最多支持 32 个字符
必传
userId
用户ID
String
最多支持 32 个字符
可选
event
事件类型
String
complete:关卡完成 fail:关卡失败
必传
params
事件参数
Object
params.desc
描述
String
对关卡失败/成功的描述
可选

三、完整代码示例

//关卡开始
wx.aldStage.onStart({
stageId : "1", //关卡ID 该字段必传
stageName : "第一关", //关卡名称 该字段必传
userId : "06_bmjrPtlm6_2sgVt7hMZOPfL2M" //用户ID 可选
})
//关卡中,用户使用道具
wx.aldStage.onRunning({
stageId : "1", //关卡ID 该字段必传
stageName : "第一关", //关卡名称 该字段必传
userId : "06_bmjrPtlm6_2sgVt7hMZOPfL2M", //用户ID 可选
event : "tools", //使用道具 关卡进行中,用户触发的操作 该字段必传
params : {
itemName : "屠龙刀",//使用道具名称 该字段必传
itemCount : 1, //使用道具数量 可选
desc : "+9屠龙刀" //使用道具描述
}
})
//关卡付费上报
wx.aldRevenue({
group:'stage', // 该字段为关卡付费固定字段不可修改 (该字段必传) String
stageId:"1", // 关卡id (该字段必传) String 必须是1 || 2 || 1.1 || 12.2 格式 最多支持 32 个字符
stageName:"第一关", // 关卡名称 (该字段必传) String 最多支持 32 个字符
money:100, // 付费金额 (该字段必传) Number
name:"火力增强", // 付费项目(该字段必传) String 最多支持 32 个字符
desc:"在关卡中使用火力增强,增加实力", // 描述(可选) String 最多支持 32 个字符
})
//关卡完成
wx.aldStage.onEnd({
stageId : "1", //关卡ID 该字段必传
stageName : "第一关", //关卡名称 该字段必传
userId : "06_bmjrPtlm6_2sgVt7hMZOPfL2M", //用户ID 可选
event : "complete", //关卡完成 关卡进行中,用户触发的操作 该字段必传
params : {
desc : "关卡完成" //描述
}
})