跳到主要内容
版本：v3

礼包系统功能介绍

产品简介​

TDS 全套礼包系统，旨在帮助开发者快速生成、核销礼包码。

产品定位​

  • 开发者无须投入大量开发成本设计礼包券码生成+核销系统，接入相关能力，1 天内即可完成礼包系统开发，快速生成礼包码进入分发运营阶段。
  • 通过礼包系统生成的券码可直接通过现有兑换接口，实现在游戏客户端内或者网页内快速兑换核销。

产品优势​

  • 支持游戏生成不同类型券码：通兑码或唯一码，覆盖常见通用运营场景。
  • 支持券码定制，自定义兑换条件，道具灵活配置等个性化运营配置，满足丰富活动场景。
  • 降本提效，为开发者节省海量券码产生的存储费用；根据厂商需求及市场变化不断优化迭代，降低产品设计及维护成本。
  • 提供整体活动、单条券码的消费数据情况，运营可清晰查看当前活动券码消耗及库存，判断活动效果。

礼包系统使用流程​

礼包系统使用指引​

礼包系统入口​

进入 「开发者中心」→「游戏服务」→「运营工具」→「礼包系统」

创建/编辑礼包活动​

配置区服​

  • 未配置区服，请先前往 「服务器管理」 配置区服信息
  • 已配置区服，根据实际发放需求，勾选区服信息

配置礼包基础信息​

  • 礼包活动名称
    • 填写礼包名称（该名称不做显示用途）
  • 礼包活动有效期
    • 填写礼包活动时间，礼包码的生效周期等于该活动时间，超时礼包码失效，无法兑换
  • 礼包码类型
    • 通兑码：一个码支持多用户兑换，当一个活动配置多个通兑码时，一个用户仅可成功兑换其中一个码；通兑码支持定制，长度限制最长为 13 个字符，仅限数字、英文
    • 唯一码：一个码仅支持一个用户兑换
  • 礼包码生成规则
    • 随机生成：13 位礼包码均由系统随机生成
    • 输入前缀（仅针对唯一码）：唯一码支持定制前缀，为了保证生成券码数量，前缀长度建议不超过 6 位
  • 自定义条件
    • 游戏在基础条件限制上新增自定义条件，自定义条件可以叠加，自定义条件最大数量不超过 10 个。未有自定义条件可不勾选
    • 条件：填写限制条件名称（赛季、注册时间等）；判断条件：等于，小于，小于等于，大于，大于等于；值：填写限制条件的值
    • 例如：注册时间为 2022 年的用户才可领取该礼包：注册时间（条件）等于（判断逻辑）2022（值）
  • 礼包码物品及数量
    • 物品名称：实际发放物品名称，例如原石、甜甜鸡
    • 数量：实际发放物品数量
提示

注意：

  • 每次仅能新增一个物品，切勿将多个物品填写进同一行。新增物品种类最多不超过 10 个。

  • 每个礼包活动一个用户仅可兑换一次。

上架礼包活动​

前往 「礼包活动」 列表，点击开关，上架礼包活动使券码生效

注意：礼包活动上架后礼包码才可被成功兑换，活动上线时务必打开此开关。

编辑礼包活动​

点击 「编辑」 进入编辑礼包活动页面，仅「区服」、「礼包活动名称」、「礼包活动有效期」支持编辑

活动补码/补量​

唯一码补码

点击「补码」，输入新增礼包码个数，点击「生成并导出」系统将自动下载新增的券码至本地

通兑码补量

点击「补量」，输入通兑码新增兑换次数，点击「确认」新增数量，同时系统将再次自动导出该通兑码至本地

提示

注意：通兑码不会新生成礼包码，仅在原兑换码上新增兑换次数，如需新增礼包码，前往「创建礼包码」新增活动

历史记录​

前往礼包系统首页，点击 「数据」 查看历史生成记录

服务器配置​

  • 服务器名称
    • 填写游戏服务器名称
  • 服务器 code
    • 道具发放通知接收地址
  • 接受道具下发通知地址
    • check_url
  • 接收二次校验结果通知地址
    • 开启二次校验服务需填写此字段，如不开启，则不需要

数据查询​

单一 CDKEY 或 单一用户数据

  • 输入「CDKEY」即可查询到对应礼包码消费状态
  • 输入「uid」即可查询单个用户消费礼包码历史记录

礼包活动数据

  • 入口：礼包活动首页
  • 输入任意以下筛选条件，即可查询礼包活动整体消费库存情况
    • 礼包码类型
    • 礼包码活动
    • 礼包活动 ID 或名称

常见 FAQ​

Q：提示报错「保存用户 client id 失败」？

A：为了确保礼包服务能正常使用，请先前往：开发者中心 →「游戏服务」→「应用配置」，开启服务，获取 client id。

Q：为什么看不见「游戏服务」tab？

A：游戏管理员新增用户角色时，需在权限设置中，勾选应用配置权限，才可看到「游戏服务」tab 及其内容。