玩吧红包活动接入指引

红包活动目前只支持结合版-安卓,不支持的平台一律不显示红包相关的信息

一、 接入流程

  1. 接入红包的游戏,在活动结束前,进该游戏的每个用户均可参与活动
  2. 任务类红包,用户的当前任务状态发生变化的时候游戏侧需要调用openapi v3/redpacket/taskreport将数据上报给后台(目前接口在测试环境,用get请求调用,post请求转发不到测试环境,务必用get请求)
  3. 任务完成后调用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.常见问题说明

  1. 上报是否针对全体用户? 答:是的,包含全体新老游戏用户
  2. 邀请任务如何上报 答: 邀请者关系由平台侧判断,游戏方上报时不做区分,全体用户统一上报
  3. 接口window.redPacketTaskReport(callback)的调用时机是什么? 答:达成每一条任务的数值时调用window.redPacketTaskReport方法来显示红包。以猎鱼达人这个游戏为例,游戏内达到100倍炮的时候,就可以调用该方法,不同的游戏任务不一样。以自己的游戏的任务为准