玩吧红包活动接入指引
红包活动目前只支持结合版-安卓,不支持的平台一律不显示红包相关的信息
一、 接入流程
- 接入红包的游戏,在活动结束前,进该游戏的每个用户均可参与活动
- 任务类红包,用户的当前任务状态发生变化的时候游戏侧需要调用openapi v3/redpacket/taskreport将数据上报给后台(目前接口在测试环境,用get请求调用,post请求转发不到测试环境,务必用get请求)
- 任务完成后调用window.redPacketTaskReport(callback)上报给平台侧的前台,前台在确认任务完成之后会显示弹出任务类红包。
回调说明
名称 | 类型 | 描述 |
---|---|---|
callback(result) | Function | 调用结果回调 |
result
名称 | 类型 | 描述 |
---|---|---|
retCode | Number | 调用结果,0代表成功,1代表失败 |
msg | String | 调用结果说明 |
hasShowRedPacket | Boolean | 是否显示任务红包,0代表已显示,1代表未显示 |
调用示例:
window.redPacketTaskReport(function(result) {
alert(result);
});
3.红包相关的参数定义在window.OPEN_DATA.redPacketInfo
对象上,redPacketInfo是红包相关的信息
参数:
window.OPEN_DATA.redPacketInfo
名称 | 描述 |
---|---|
inRedPacketAct | 是否参加红包活动 |
4.常见问题说明
- 上报是否针对全体用户? 答:是的,包含全体新老游戏用户
- 邀请任务如何上报 答: 邀请者关系由平台侧判断,游戏方上报时不做区分,全体用户统一上报
- 接口window.redPacketTaskReport(callback)的调用时机是什么? 答:达成每一条任务的数值时调用window.redPacketTaskReport方法来显示红包。以猎鱼达人这个游戏为例,游戏内达到100倍炮的时候,就可以调用该方法,不同的游戏任务不一样。以自己的游戏的任务为准