关卡分析 - 阿拉丁帮助文档

搜索文档…
关卡分析
追踪玩家关卡的过关、道具使用情况
支持平台：微信小游戏、QQ小游戏
一、接口和参数
不同接口事件，对应着用户触发的不同事件
1
//关卡开始
2
wx.aldStage.onStart()
3
​
4
//关卡进行中
5
wx.aldStage.onRunning()
6
​
7
//关卡付费上报
8
wx.aldRevenue()
9
​
10
//关卡结束
11
wx.aldStage.onEnd()
Copied!
二、接口事件关系
​
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 个字符
可选
1
​
2
wx.aldStage.onStart({
3
  stageId   : "1.1", //关卡ID， 必须是1 || 2 || 1.1 || 12.2 格式  该字段必传
4
  stageName : "第一大关-第一小关",//关卡名称，该字段必传
5
  userId    : "123456" //用户ID
6
})
Copied!
wx.aldStage.onRunning 捕捉用户在关卡中的一些行为和操作
1
// 在关卡中使用道具
2
wx.aldStage.onRunning({
3
  stageId   : "1.1",
4
  stageName : "第一大关-第一小关",
5
  userId    : "123456",
6
  event     : "tools"
7
  params    : {
8
    itemName : "火力加强",
9
​
10
  }
11
})
Copied!
参数/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
关卡付费上报
1
wx.aldRevenue({
2
    group:'stage',   // 该字段为关卡付费固定字段不可修改  （该字段必传）  String
3
    stageId:"1",  // 关卡id  （该字段必传）          String  必须是1 || 2 || 1.1 || 12.2 格式  最多支持 32 个字符
4
    stageName:"第一关", // 关卡名称 （该字段必传）    String  最多支持 32 个字符
5
    money:100,   // 付费金额 （该字段必传）         Number 
6
    name:"火力增强",  // 付费项目（该字段必传）     String  最多支持 32 个字符
7
    desc:"在关卡中使用火力增强，增加实力",     // 描述（可选）  String  最多支持 32 个字符
8
})
Copied!
参数/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
对关卡失败/成功的描述
可选
三、完整代码示例
1
//关卡开始
2
​
3
wx.aldStage.onStart({
4
  stageId   : "1",     //关卡ID 该字段必传
5
  stageName : "第一关", //关卡名称  该字段必传
6
  userId    : "06_bmjrPtlm6_2sgVt7hMZOPfL2M" //用户ID 可选
7
})
Copied!
1
//关卡中，用户使用道具
2
​
3
wx.aldStage.onRunning({
4
  stageId   : "1",   //关卡ID 该字段必传
5
  stageName : "第一关",  //关卡名称  该字段必传
6
  userId    : "06_bmjrPtlm6_2sgVt7hMZOPfL2M", //用户ID 可选
7
  event     : "tools",  //使用道具  关卡进行中，用户触发的操作    该字段必传
8
  params    : {
9
    itemName  : "屠龙刀",//使用道具名称 该字段必传
10
    itemCount : 1,   //使用道具数量  可选
11
    desc      : "+9屠龙刀" //使用道具描述
12
  }
13
})
Copied!
1
//关卡付费上报
2
​
3
wx.aldRevenue({
4
    group:'stage',   // 该字段为关卡付费固定字段不可修改  （该字段必传）  String
5
    stageId:"1",  // 关卡id  （该字段必传）          String  必须是1 || 2 || 1.1 || 12.2 格式  最多支持 32 个字符
6
    stageName:"第一关", // 关卡名称 （该字段必传）    String  最多支持 32 个字符
7
    money:100,   // 付费金额 （该字段必传）         Number 
8
    name:"火力增强",  // 付费项目（该字段必传）     String  最多支持 32 个字符
9
    desc:"在关卡中使用火力增强，增加实力",     // 描述（可选）  String  最多支持 32 个字符
10
})
Copied!
1
//关卡完成
2
​
3
wx.aldStage.onEnd({
4
  stageId   : "1",    //关卡ID 该字段必传
5
  stageName : "第一关", //关卡名称  该字段必传
6
  userId    : "06_bmjrPtlm6_2sgVt7hMZOPfL2M",  //用户ID 可选
7
  event     : "complete",   //关卡完成  关卡进行中，用户触发的操作    该字段必传
8
  params    : {
9
    desc    : "关卡完成"   //描述
10
  }
11
})
Copied!
最近更新 11mo ago
复制链接
内容
一、接口和参数
二、接口事件关系
三、完整代码示例
一、接口和参数

二、接口事件关系

​

wx.aldStage.onStart 关卡开始

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

关卡付费上报

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

三、完整代码示例
