接入前必读
VIP体系接入含两项内容，分别为VIP礼包接入及VIP特权接入，上线结合版需完成两项接入并由平台审核通过。两项内容需使用不同接口，具体接入流程请见下方详细指导。
VIP礼包接口：https://wiki.qzone.qq.com/openapi/v3/user/gift_exchange
VIP特权接口：https://wiki.qzone.qq.com/openapi/v3/user/get_vip_level
VIP接入项1：VIP礼包接入指导文档
一、VIP礼包外网展示页面及效果预览
1、进入手机QQ-好友动态-小游戏页面，点击进入子页面【我的】
2、点击头像下方的VIP图标，进入【特权中心】
3、进入小游戏【特权中心】，下拉查看已上线的【VIP特权礼包】
4、在小游戏【特权中心】页面，点击可查看VIP的特权介绍
介绍的内容包括： a.如何成为VIP； b.VIP成长值如何计算、分等级VIP所需成长值； c.维持VIP等级所需条件； d.如何再次点亮VIP图标；
二、用户领取流程
注意：1、VIP平台礼包的接口为/v3/user/gift_exchange，用于VIP平台礼包的领取校验；需要区别于VIP在游戏内的特权接口get_vip_level； VIP特权的平台礼包接口wiki：https://wiki.qzone.qq.com/openapi/v3/user/gift_exchange
三、礼包弹窗视觉规范
弹窗需包含：
- 领取成功/失败的提示；
- 操作结果说明、礼包内容，开发商可加入实际ICON增强视觉效果；
- 关闭按钮；
- 领取成功的情况下，需提示用户明日再来领取。
1）校验成功的情况
- 领取成功提示文案：领取成功 恭喜你，获得VIPX礼包：XXX 明天请记得再来领取喔~
- 重复领取提示文案：领取成功 你已经领取过VIPX礼包，明天请记得再来领取喔~
2）校验失败的情况
- VIP等级不匹配提示文案：领取失败 VIP等级不匹配，无法领取。
- VIP过期提示文案：领取失败 很遗憾，您的VIP等级已失效，点亮特权后重新领取。
- 其他异常提示文案：领取失败 系统繁忙，请稍后重试或联系客服进行处理。
四、VIP礼包内容
每个VIP礼包为为每日礼包，玩家每天可以到特权中心领取一次 礼包内容开发商提供，通常为金币或者游戏道具，平台审核后上架。
五、礼包发放逻辑
- 每日礼包：开发商提供VIP1至VIP6共6个等级的礼包，平台配置后会在每晚12点更新数据，VIP用户每日可领取当前VIP等级对应的礼包。
- 如：VIP4用户，当日可在这里领取一份VIP4礼包
- 领取逻辑和现有礼包领取一致，点击后进入游戏
- 当用户未领取礼包的情况下，展示该用户可领取的礼包。
- 当用户已领取礼包后，按钮显示为【已领取】
- 1个用户（分机型、分区分服）只能在当日（昨日晚12点~当日晚12点）领取该礼包一次，此处需要开发商做判断逻辑。
六、开发商添加VIP礼包流程
配置页面链接：https://wanba.qzone.qq.com/
步骤1：登录后点击进入【管理中心】
步骤2：选择对应的游戏，点击【进入】管理页面
步骤3：进入后，点击【VIP礼包】进入配置页面
步骤4：配置页面如下，配置信息可参考下方信息：
步骤5：有效日期尽量长，可以填到2018年12月30日。
开发商添加VIP礼包说明：
- VIP礼包的价值不得低于全平台用户可领的礼包，可低于游戏内的VIP礼包。
- 编号1212到1217只是我们这边举例，实际编号为多少，可自定义。
- https://open.mobile.qq.com/api/h5plus/debug.html 调试工具礼包编号填入就可测试礼包。
- 测试通过后，在玩吧后台添加礼包审核后就可上架。
- 如果缺少高VIP等级的QQ号，需要给白名单帐号做VIP等级数据配合测试，可联系工作人员并提交测试号，后台可以给每个号模拟数据等级，测试号可在正式环境下测试VIP特权和礼包。
七、平台VIP礼包接入Q&A
Q：小游戏VIP特权礼包（通过游戏内手动领取的）和现在【VIP特权礼包配置指引（平台礼包）第二版】文档中的通道领取的其实是两个不一样的礼包？ A：空间的VIP特权分为两个部分：一部分是游戏内特权，就是之前说的在游戏内加入口和发自测文档的那一块；另一部分是在平台领取的，用户在平台点击领取后会跳转到游戏内，游戏内提示【领取成功】或者【你今天已经领取过】，类似现在的周循环礼包。
Q：礼包分6个等级，从VIP1-VIP6，这个vip等级是玩家在平台的vip等级吗 A：是的。
Q：VIP特权礼包配置指引（平台礼包）第二版教程提示文案里特权失效是指2006（用户非VIP,无法兑换VIP礼包），2007（用户VIP等级与VIP礼包等级不符，无法兑换）这两种情况吗？ A：特权失效是指2006，2007显示 等级不匹配
VIP接入项2：VIP特权接入指导文档
一、VIP特权外网展示页面及效果预览**
二、用户领取逻辑
福利中心（游戏按钮）——领取页面（显示各个等级vip福利）——点击领取 （非vip玩家会跳转至游戏充值页面）
VIP特权接口wiki：https://wiki.qzone.qq.com/openapi/v3/user/get_vip_level
三、VIP特权接入标准：
首页福利中心按钮（游戏可结合游戏内美术风格做二次创作）
游戏内的小游戏VIP特权页需包含以下内容：
- 小游戏VIP官方logo。
- 小游戏VIP官方sologan：小游戏、大特权
- 根据用户当前VIP等级，展示该用户游戏可享受特权及可领取福利内容。
- 领取按钮、关闭按钮。
- 领取成功或领取失败有相关提示。
- 领取失败需提示原因，并提示充值（提升VIP等级、重新点亮VIP的情况）。
四、VIP特权内容设置指引：
五、游戏内VIP特权参考案例：
常见问题：
- VIP3只能领取VIP3的礼包，不能领取VIP2和VIP1的礼包。其他情况可类推。
- 用户原本是VIP1，领取过VIP1的礼包之后，马上充钱升级到VIP2了，当日无法再次领取VIP2礼包，每个用户每日只能领取1个当前等级的礼包。
- 游戏侧无需判断用户当日是否已经领取礼包，由平台进行领取限制。
- 如果缺少高VIP等级的QQ号，需要给白名单帐号做VIP等级数据配合测试，可联系工作人员并提交测试号，后台可以给每个号模拟数据等级，测试号可在正式环境下测试VIP特权和礼包。
六、配置VIP特权文案
配置页面链接：https://wanba.qzone.qq.com/
步骤1：登录后点击进入【管理中心】
步骤2：选择对应的游戏，点击【进入】管理页面
步骤3：进入后，点击左侧列表中的【VIP特权】进入配置页面，填写相关信息
步骤4：填写完毕后点击【提交审核】，测试通过后，联系相关工作人员进行审核
七、如何测试
VIP礼包（可用测试工具）
步骤1：点击链接进入以下调试界面 https://wiki.qzone.qq.com/debug/index.html
步骤2：输入游戏应用的ID，以及测试礼包ID
步骤3：扫描二维码测试VIP礼包是否领取正常，扫码后等同于点击领取按钮。
步骤4：把每个VIP等级对应领取到的礼包界面一一截图，打包后通过运营对接QQ群同步给相关审核人员，审核后即可由空间运营操作礼包上架。（如没有上线结合版的游戏，需要先通过审核，待结合版上线后才进行VIP礼包上架。）
步骤5：如需要为测试QQ号模拟VIP等级数据，请在运营对接群内联系相关审核人员，按以下格式申请给指定测试QQ号添加VIP等级，格式如下（如有多个号码需添加等级请同时批量申请）：
游戏《XXXX》申请为测试号添加小游戏VIP等级
QQ号：12345678---需添加等级：VIP1
VIP特权（游戏内自行测试）
可使用有VIP等级资格的帐号在游戏内的领取，需要开发商根据数据接口自行判断用户状态，自测后将测试过程及领取页面截图，打包后通过运营对接群同步给空间运营人员。