关卡分析

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

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

一、接口和参数

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

//关卡开始
qq.aldStage.onStart()

//关卡进行中
qq.aldStage.onRunning()

//关卡付费上报
qq.aldLevelPay()

//关卡结束
qq.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 个字符	可选

qq.aldStage.onStart({
  stageId   : "1.1", //关卡ID， 必须是1 || 2 || 1.1 || 12.2 格式  该字段必传
  stageName : "第一大关-第一小关",//关卡名称，该字段必传
  userId    : "123456" //用户ID
})

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

// 在关卡中使用道具
qq.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

关卡付费上报

qq.aldLevelPay({
    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 个字符	可选

qq.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	对关卡失败/成功的描述	可选

三、完整代码示例

//关卡开始

qq.aldStage.onStart({
  stageId   : "1",     //关卡ID 该字段必传
  stageName : "第一关", //关卡名称  该字段必传
  userId    : "06_bmjrPtlm6_2sgVt7hMZOPfL2M" //用户ID 可选
})

//关卡中，用户使用道具

qq.aldStage.onRunning({
  stageId   : "1",   //关卡ID 该字段必传
  stageName : "第一关",  //关卡名称  该字段必传
  userId    : "06_bmjrPtlm6_2sgVt7hMZOPfL2M", //用户ID 可选
  event     : "tools",  //使用道具  关卡进行中，用户触发的操作    该字段必传
  params    : {
    itemName  : "屠龙刀",//使用道具名称 该字段必传
    itemCount : 1,   //使用道具数量  可选
    desc      : "+9屠龙刀" //使用道具描述
  }
})

//关卡付费上报

qq.aldLevelPay({
    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 个字符
})

//关卡完成

qq.aldStage.onEnd({
  stageId   : "1",    //关卡ID 该字段必传
  stageName : "第一关", //关卡名称  该字段必传
  userId    : "06_bmjrPtlm6_2sgVt7hMZOPfL2M",  //用户ID 可选
  event     : "complete",   //关卡完成  关卡进行中，用户触发的操作    该字段必传
  params    : {
    desc    : "关卡完成"   //描述
  }
})