关卡分析

追踪玩家关卡的过关、道具使用情况

支持平台:微信小游戏、QQ小游戏

一、接口和参数

不同接口事件,对应着用户触发的不同事件

//关卡开始
wx.aldStage.onStart()
//关卡进行中
wx.aldStage.onRunning()
//关卡结束
wx.aldStage.onEnd()

二、接口事件关系

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

payStart:发起支付 paySuccess:支付成功 payFail:支付失败 tools:使用道具 revive:复活 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.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 : "payStart", //发起支付 关卡进行中,用户触发的操作 该字段必传
params : { //参数
itemName : "火力增强", //购买商品名称 该字段必传
itemCount : 5, //购买商品数量 可选,默认1
itemMoney : 20 // 购买商品金额 可选 默认0
desc : "武器库-商店购买" //商品描述 可选
}
})
//关卡中,用户支付成功
wx.aldStage.onRunning({
stageId : "1", //关卡ID 该字段必传
stageName : "第一关", //关卡名称 该字段必传
userId : "06_bmjrPtlm6_2sgVt7hMZOPfL2M" //用户ID 可选
event : "paySuccess", //支付成功 关卡进行中,用户触发的操作 该字段必传
params : { //参数
itemName : "火力增强", //购买商品名称 该字段必传
itemCount : 5, //购买商品数量 可选,默认1
itemMoney : 20 // 购买商品金额 可选 默认0
desc : "武器库-商店购买" //商品描述 可选
}
})
//关卡中,用户使用道具
wx.aldStage.onRunning({
stageId : "1", //关卡ID 该字段必传
stageName : "第一关", //关卡名称 该字段必传
userId : "06_bmjrPtlm6_2sgVt7hMZOPfL2M", //用户ID 可选
event : "tools", //使用道具 关卡进行中,用户触发的操作 该字段必传
params : {
itemName : "屠龙刀",//使用道具名称 该字段必传
itemCount : 1, //使用道具数量 可选
desc : "+9屠龙刀" //使用道具描述
}
})
//关卡完成
wx.aldStage.onEnd({
stageId : "1", //关卡ID 该字段必传
stageName : "第一关", //关卡名称 该字段必传
userId : "06_bmjrPtlm6_2sgVt7hMZOPfL2M", //用户ID 可选
event : "complete", //关卡完成 关卡进行中,用户触发的操作 该字段必传
params : {
desc : "关卡完成" //描述
}
})