定制礼包管理

概述

• 定制礼包：支持自定义礼包内容及展示规则，而后向目前人群推送付费礼包，以完善面向玩家的个性化运营及游戏商业化经营；定制礼包一般为限购模式，即限制单角色单礼包仅可购买一次。
• 支持游戏内定制礼包的增删改查、定时推送。
• 支持全服礼包、角色礼包等不同礼包类型。
• 因礼包存在道具奖励发放等敏感信息，故礼包的增删改均需二次确认。

使用前提

• 请先于“星云开放平台 → 游戏中心 → 选择游戏 → 对接中心 → GM接口管理 → 预置接口”，正确配置并上线以下接口，才可正常使用“定制礼包管理”功能：
  1. 推送全服礼包
  2. 推送角色礼包
  3. 撤回礼包
• 关于参数配置
  1. 除了预置参数外，支持通过“新增参数”自定义添加游戏所需的额外参数，也可通过上下箭头调整参数于GM系统对应功能页的显示顺序。
  2. 若存在多个参数需至少必填一项才可提交，可通过“提交设置”设置。
  3. 礼包接口中使用的推送对象“游戏服”、“渠道”参数，将默认填充在星云配置的游戏服及渠道信息作为枚举获取地址
     • 游戏服
       • 若“获取游戏当前可用的游戏服列表”接口已上线，默认填充此接口地址作为游戏服的枚举地址；
       • 若“获取游戏当前可用的游戏服列表”接口未上线，默认填充 __NEBULA_SERVER__，即默认使用星云“游戏服管理”信息；若需正常使用星云“游戏服管理”，请确保“获取游戏服变更信息”接口已上线。
     • 渠道
       • 若“获取游戏当前可用的渠道列表”接口已上线，默认填充此接口地址作为渠道的枚举地址；
       • 若“获取游戏当前可用的渠道列表”接口未上线，默认填充 __NEBULA_CHANNEL__，即默认使用星云“渠道配置”信息。
  4. 礼包接口中使用的“礼包内容”参数，若“获取道具名称列表”接口已上线，将默认填充此接口地址作为道具的枚举地址。
  5. 礼包接口中使用的“礼包价格”参数，若游戏的发行区域=中国大陆地区，将默认填充星云预置价格列表__NEBULA_AMOUNT__，枚举值包含0、1元、6元、12元、18元、30元、68元、98元、128元、198元、328元、648元。
  6. 礼包接口中使用的“持续时长”参数，将默认填充星云预置时长列表__NEBULA_DURATION__，枚举值包含3小时、6小时、12小时、24小时、3天、7天。
  7. 上述参数默认填充的枚举获取地址，均支持替换为游戏自定义的地址。
• 详见对接文档。

全服礼包

支持 添加、修改、撤回、查询 全服礼包。

添加全服礼包

• 支持设置礼包标题、礼包价格、礼包内容、礼包背景、展示时间、持续时长、推送对象。
• 礼包内容，支持设置多种道具及数量的组合方案。
• 展示时间&持续时长
  • 展示时间，为游戏内礼包购买入口的展示时间。
  • 持续时长，为游戏内礼包购买入口出现后允许购买的时长（常以倒计时出现）。
  • 因玩家上线时间不同，且定制礼包一般为限购模式，故定制礼包可购买时段=玩家首次可见礼包购买入口的时间点+持续时长（不同玩家可购买时段不同，可能超出展示时间的结束时间点）。
• 推送对象，支持面向多个 游戏服 或 渠道 发送。
  • 面向游戏服推送，若使用星云GM“游戏服管理”维护的游戏服信息，在游戏服选择时：
    • 在设置展示时间后，支持筛选礼包展示时已开服的游戏服：若勾选，则一键选中表单填写时游戏服管理中 部署状态=已部署 且 开服时间≤时间的开始时间 的游戏服。
    • 支持开关“新增游戏服时自动追加”；开，即当此游戏在表单提交后展示时间的结束时间之前新增了未删除的游戏服，则自动追加归属为当前全服礼包发送游戏服。
  • 面向渠道发送，若使用星云维护的渠道信息，则在发送渠道选择时，支持开关“新增官方渠道时自动追加”；开，即当此游戏在表单提交后展示时间的结束时间之前使用官方渠道模版创建了 配置状态=已完成 且 启用状态=启用 的渠道，则将自动追加归属为当前全服礼包发送渠道。
• 礼包记录添加后，星云将在到达“展示时间”的开始时间时调用“发送全服礼包”接口向游戏下发礼包配置信息。
• 点击每条礼包记录的“复制”，可快速添加相同配置信息的礼包。

修改全服礼包

• 未达展示时间即“未通知游戏推送”的礼包，及“已删除或通知游戏撤回”的礼包，支持修改。
• 礼包记录修改后，星云将在到达“展示时间”时调用“发送全服礼包”接口向游戏下发礼包最新配置信息。

删除全服礼包

• 仅未达展示时间即“未通知游戏发送”的礼包，支持删除。
• 礼包记录删除后，则不向游戏推送此礼包配置信息。

撤回全服礼包

• 仅已达展示时间且未撤回，即状态为“已通知游戏发送”的礼包，支持撤回。
• 礼包记录撤回后，星云将即时调用“撤回礼包”接口通知游戏。

礼包记录查询

• 支持通过礼包标题、礼包价格、礼包内容、推送游戏服、推送渠道、通知状态等搜索礼包。
• 查询结果，默认按创建时间倒序显示；礼包价格、创建时间、更新时间，支持手动排序。

角色礼包

支持 添加、修改、撤回、查询 角色礼包。

添加角色礼包

• 支持设置礼包标题、礼包价格、礼包内容、礼包背景、展示时间、持续时长、角色ID。
• 礼包内容，支持设置多种道具及数量的组合方案。
• 展示时间&持续时长
  • 展示时间，为游戏内礼包购买入口的展示时间。
  • 持续时长，为游戏内礼包购买入口出现后允许购买的时长（常以倒计时出现）。
  • 因玩家上线时间不同，且定制礼包一般为限购模式，故定制礼包可购买时段=玩家首次可见礼包购买入口的时间点+持续时长（不同玩家可购买时段不同，可能超出展示时间的结束时间点）。
• 角色ID，支持直接输入或批量导入多个角色。
• 礼包记录添加后，星云将在到达“展示时间”的开始时间时调用“发送角色礼包”接口向游戏下发礼包配置信息。
• 点击每条礼包记录的“复制”，可快速添加相同配置信息的礼包。

修改角色礼包

• 未达展示时间即“未通知游戏推送”的礼包，及“已删除或通知游戏撤回”的礼包，支持修改。
• 礼包记录修改后，星云将在到达“展示时间”时调用“发送角色礼包”接口向游戏下发礼包最新配置信息。

删除角色礼包

• 仅未达展示时间即“未通知游戏发送”的礼包，支持删除。
• 礼包记录删除后，则不向游戏推送此礼包配置信息。

撤回角色礼包

• 仅已达展示时间且未撤回，即状态为“已通知游戏发送”的礼包，支持撤回。
• 礼包记录撤回后，星云将即时调用“撤回礼包”接口通知游戏。

礼包记录查询

• 支持通过礼包标题、礼包价格、礼包内容、角色ID、通知状态等搜索礼包。
• 查询结果，默认按创建时间倒序显示；礼包价格、创建时间、更新时间，支持手动排序。

礼包购买情况查询

针对 礼包价格＞0元 的定制礼包，玩家发生购买行为将同步产生支付订单；
可于 星云开放平台 → 游戏中心 → 选择游戏 → 游戏数据 → 游戏订单查询，根据商品名称等查询条件进行礼包购买情况查询。