## 关卡分析 追踪玩家关卡的过关、道具使用情况 **支持平台**:微信小游戏、QQ小游戏 ## ## 一、接口和参数 不同接口事件,对应着用户触发的不同事件 ``` 1 //关卡开始 2 wx.aldStage.onStart() 3 4 //关卡进行中 5 wx.aldStage.onRunning() 6 7 //关卡付费上报 8 wx.aldRevenue() 9 10 //关卡结束 11 wx.aldStage.onEnd() ``` ## ## 二、接口事件关系 ​ ![](http://aldpicsh.aldwx.com/doc_aldwx/xyxtj-gqfx04.png) ## wx.aldStage.onStart 关卡开始 ![](https://img.kancloud.cn/63/57/6357cae06173264f2e1d2f432c194bc7_802x110.png) ``` 1 2 wx.aldStage.onStart({ 3 stageId : "1.1", //关卡ID, 必须是1 || 2 || 1.1 || 12.2 格式 该字段必传 4 stageName : "第一大关-第一小关",//关卡名称,该字段必传 5 userId : "123456" //用户ID 6 }) ``` ## 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 }) ``` ![](https://img.kancloud.cn/32/d3/32d350bc199186a093d4fcd1bdd8dae7_1117x286.png) ## 关卡付费上报 ``` 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 }) ``` ![](https://img.kancloud.cn/e0/f3/e0f3086fc9f792563b2a978acf521c80_1110x183.png) ## wx.aldStage.onEnd 捕捉用户在关卡中的一些操作 ![](https://img.kancloud.cn/a9/01/a901fde8cc527900e0bfa7f5144e1b18_1104x213.png) ## 三、完整代码示例 ``` 1 //关卡开始 2 3 wx.aldStage.onStart({ 4 stageId : "1", //关卡ID 该字段必传 5 stageName : "第一关", //关卡名称 该字段必传 6 userId : "06\_bmjrPtlm6\_2sgVt7hMZOPfL2M" //用户ID 可选 7 }) ``` ``` 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 }) ``` ``` 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 }) ``` ``` 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 }) ```