礼包码管理 | 文档中心

文章目录

概述

礼包码应用场景：玩家通过运营活动等多场景领取礼包码 → 玩家于游戏内输入礼包码兑换奖励 → 游戏内通过邮件等方式推送兑换成功的奖励 → 玩家领取奖励；礼包码的奖励内容为游戏道具。
业务流程
礼包码区分通码及专码类型——
1. 专码：每个专码仅能兑换一次，且同一角色仅可兑换同批次的一个专码；专码由系统根据用户设置的礼包码生成策略随机生成（但固定由数字+大写字母组成，且剔除数字01、字母OI）。
2. 通码：每个通码可被多角色兑换，但同一通码仅可被同一角色兑换一次；通码为用户设置的具体通码。
礼包码管理，支持增删改查礼包码策略，包含礼包码生成、导出、废弃、使用查询、兑换校验、奖励推送等功能。
仅面向“内部版”企业开放。

因可针对不同渠道玩家设置不同礼包码策略，故请先完成渠道信息配置，有两种方案：
1. 使用于星云维护的渠道信息
  于“星云开放平台 → 游戏中心 → 选择游戏 → 对接中心 →渠道打包 → 渠道配置” 配置渠道信息。
2. 直接获取游戏维护的渠道信息
  于“星云开放平台 → 游戏中心 → 选择游戏 → 对接中心 → GM接口管理 → 预置接口” 上线 “获取游戏当前可用的渠道列表”接口。
因可设置礼包码携带的奖励内容，可设置允许兑换礼包码的玩家角色等级、角色创建时间，可选采用邮件推送兑换成功的奖励，故请先于“星云开放平台 → 游戏中心 → 选择游戏 → 对接中心 → GM接口管理 → 预置接口”，正确配置并上线以下接口，才可正常使用“礼包码管理”功能：
1. 获取道具名称列表（必接）
2. 获取角色信息（若使用邮件推送奖励必接）
3. 发送角色邮件（若使用邮件推送奖励必接）
详见对接文档。

GM接口配置_列表_礼包码

支持添加并生成专码、修改专码策略、导出专码、废弃专码、专码批次管理。

支持设置专码的策略标题（用途）、生成数量、码长度、码前缀、所属批次、有效时间、可用渠道、可以换角色等级、可兑换角色创建时间、奖励内容。
码前缀的字符数不计入码长度，二者独立计算。
若使用星云维护的渠道信息，则在可用渠道选择时，支持开关“新增官方渠道时自动追加”；开，即当此游戏在表单提交后使用官方渠道模版创建了配置状态=已完成且启用状态=启用的渠道，则将自动追加归属为当前专码可用渠道。
奖励内容，支持设置多种道具及数量的组合方案。
表单提交后，系统即开始根据策略生成对应专码；其中，随机字符固定由数字+大写字母组成，且剔除数字01及字母OI。
点击每条策略记录的“复制”，可快速添加相同配置信息的专码策略。

GM_礼包码管理_专码_添加专码

仅“未生效”、“有效”的专码支持修改。
1. 未生效：已生成专码，专码有效时间的开始时间＞当前时间且未废弃；
2. 有效：已生成码，专码有效时间的开始时间≤当前时间≤专码有效时间的结束时间且未废弃。
因专码已生成，故专码数量、码长度、码前缀不支持修改。

支持废弃当前有效的专码，点击状态为“有效”的策略记录的“废弃”，二次确认后可废弃此记录生成的所有专码；废弃则不可兑换。

GM_礼包码管理_专码_查询

支持添加并生成通码、修改通码策略、废弃通码。

支持设置通码的策略标题（用途）、具体通码、可兑换次数、有效时间、可用渠道、可以换角色等级、可兑换角色创建时间、奖励内容。
若使用星云维护的渠道信息，则在可用渠道选择时，支持开关“新增官方渠道时自动追加”；开，即当此游戏在表单提交后使用官方渠道模版创建了配置状态=已完成且启用状态=启用的渠道，则将自动追加归属为当前通码可用渠道。
奖励内容，支持设置多种道具及数量的组合方案。
表单提交后，即生成对应通码。
点击每条策略记录的“复制”，可快速添加相同配置信息的通码策略。

GM_礼包码管理_通码_添加通码

仅“未生效”、“有效”的通码支持修改。
1. 未生效：通码有效时间的开始时间＞当前时间且未废弃；
2. 有效：通码有效时间的开始时间≤当前时间≤通码有效时间的结束时间且未废弃。
具体通码不支持修改。

支持废弃当前有效的通码，点击状态为“有效”的策略记录的“废弃”，二次确认后可废弃此通码；废弃则不可兑换。

GM_礼包码管理_通码_查询

GM_礼包码管理_兑换查询

星云标准化了礼包码奖励的邮件推送方式，若需使用，请于“礼包码管理”页面右上角点击“奖励推送配置”，开启“使用游戏内邮件推送礼包码奖励”并完成对应邮件模版信息配置，下发给玩家的邮件将自动带上奖励内容。
因采用邮件推送、且基于安全考虑将二次校验角色等信息，故若需使用此方式推送奖励，请先于“对接中心 → GM接口管理 → 预置接口”，正确配置并上线 “发送角色邮件” 及 “获取角色信息” 接口。

GM_礼包码管理_奖励推送配置