奖励系统

词汇表

奖励系统
一个鼓励用户使用真实货币进行购买的系统。
个人奖励链
一系列阶段性步骤奖励,完成每个阶段步骤后都会获得奖励。
步骤
奖励链中的步骤,用户通过完成步骤累积一定数量奖励积分后可收到奖励。
奖励积分
反映用户或公会在奖励系统中进度的积分。
奖励
用户累积一定数量奖励积分后获得的商品。
公会
一群玩家一起游戏并为共同目标努力的组织。
公会奖励链
一系列阶段性步骤奖励。当公会中的任何成员进行购买时,奖励积分会累计到公会的总奖励链进度中,与其他公会成员获得的积分合并计算。随着总积分增加,新的奖励阶段会解锁。每个解锁的奖励都可供所有公会成员领取。

运行机制

奖励系统可以激励用户使用真实货币在商店中购买商品。如果用户是公会成员,其购买将为整个公会贡献奖励积分。

您可以创建个人和公会奖励链,并为用户购买的商品提供奖励。游戏可以包含多个任意类型的奖励链。每个奖励链最多可以包含31个步骤。您需要为每个等级设定完成所需的奖励积分数量。

您还可以创建个性化奖励链。通过个性化功能,可根据用户属性仅向特定授权用户群体显示奖励链。您可以为单个用户或公会设计个性化奖励链。

注:
您可以向用户发放免费商品,并额外赠送奖励积分。累积的奖励积分会激励用户通过使用真实货币购买商品来获得更多积分。

在奖励链的每个步骤中,用户可以获得1至10个奖励。公会中的每个成员在每个步骤也可以获得1至10个奖励。

您可以向用户发放以下类型的商品奖励:

  • 虚拟物品
  • 虚拟货币
  • 虚拟货币套餐
  • 捆绑包

为确保奖励系统正常运行,必须配置用户身份认证。对于未经身份认证的用户,个人和公会奖励链都会显示,但没有进度。已经过身份认证但不是公会成员的用户只能看到其个人奖励链。公会奖励链将显示为不可用。

用户流程

  1. 用户访问网站。
  2. 用户看到商品目录、奖励系统和每个商品可获得的奖励积分数量。
  3. 用户进行登录。
  4. 然后用户即可查看其在奖励系统中的当前进度。
  5. 当用户进行购买时,其奖励链进度会相应提升。

如何获取

要设置奖励系统,需要以下详细信息:

  • 奖励系统的开始和结束日期

注:
如没有结束日期,奖励系统将无限期运行。

  • 用于推进个人和公会奖励链进度的奖励积分的图片、描述、SKU和名称
  • 奖励积分数量
  • 奖励链中的商品

请参阅下方示例。

奖励链:

描述示例限制
名称艾克索拉奖励系统字符数限制 — 35。
说明文字完成每一步都能获得特别奖励。赶快收集水晶碎片获得更酷的奖励吧!字符数限制 — 175。
时间段01.05.2023 — 31.05.2023
图片大小1065 x 515 px
个人奖励链步骤:
描述示例限制
步骤名称等级1字符数限制 — 35。
图片大小200 x 200 px支持的格式:PNG、JPG。
用户收到奖励要积累的奖励积分数量25
含商品SKU的列表以及用户在此步骤收到的奖励数量sword_1 x 1, coin_pack_50 x 2
奖励积分:
描述示例
名称水晶碎片
说明文字收集水晶碎片获得奖励。
SKUExampleSKU003
图片或图片URLCrystal
建议奖励积分价格:
步骤奖励积分
步骤15
步骤210
步骤315
步骤420
步骤530
步骤640
步骤760
步骤880
步骤9100
步骤10150
步骤11及后续步骤上一步 + 50
购买指定商品发放的奖励积分:
描述示例
购买即发放奖励积分的商品SKUHelmet_1
购买该商品后发放的积分数量10

在己侧实现以下功能:

要设置奖励系统,请实现以下API方法:

定义用户公会

如果不使用艾克索拉建站器,则您需要在用户属性中传递用户的公会信息,以便公会奖励链正常运行。

要为用户添加公会属性,请使用属性更新方法,并在请求正文中传递包含公会值的attributes数组。

示例

Copy
Full screen
Small screen
 1{
 2  "attributes": [
 3    {
 4      "key": "clan_id",
 5      "value": "beetles"
 6    }
 7  ],
 8  "publisher_id": 123456,
 9  "publisher_project_id": 123456
10}

如果您使用通过自定义ID进行认证API,可以在用户授权期间直接传递当前属性值。

您也可以使用API更新用户的当前公会。首先在登录管理器中更新用户属性,然后调用更新当前用户的公会API。如果属性包含新公会,用户将获得之前公会奖励链中未领取的奖励,并更新其公会归属。如果用户之前属于某个公会但现在不再是其成员,其公会成员身份将被撤销。此方法的响应包含用户已领取的奖励。

通过发布商帐户进行设置

在创建奖励链之前,需要创建奖励积分、奖励以及用户和公会可购买以获得奖励积分的商品

创建奖励积分

要创建奖励积分:

  1. 在发布商帐户中打开您的项目,前往LiveOps > 奖励部分。
  2. 奖励选项卡中,单击创建奖励积分
  1. 指定以下参数:
    • 添加图片(可选)。
    • 为奖励积分输入唯一的SKU。
    • 指明奖励积分是否用于公会。
    • 为奖励积分指定名称。
  1. 单击下一步
  2. 选择虚拟物品的SKU并指定用户每次购买可获得的奖励积分数量。
  3. 单击+添加所需物品数量。
  4. 单击保存

创建的奖励积分将显示在奖励链上方。公会奖励积分会相应标记。要更改特定奖励积分的设置,请在对应行中单击编辑

创建奖励链

要创建奖励链:

  1. 在发布商帐户中打开您的项目,前往LiveOps > 奖励部分。
  2. 单击创建奖励
  1. 选择新奖励链类型 — 个人奖励链公会奖励链
  2. 指定以下参数,如果选择个人奖励链:
    1. 指定奖励链名称。
    2. 填写描述。
    3. 在下拉列表中选择奖励积分。

    如果选择公会奖励链:
    1. 在公会类型下拉列表中选择公会类型
    2. 设置公会奖励链参数:
      1. 指定奖励链名称。
      2. 填写描述。
      3. 指定奖励链弹窗标题。
      4. 指定弹窗提示文本(说明用户如何为公会获得奖励)。
      5. 添加图片(可选)。
      6. 在下拉列表中选择奖励积分。

  1. 单击下一步
  2. 单击添加新步骤
  3. 指定以下参数,然后单击保存
    1. 步骤名称。
    2. 领取奖励所需的奖励积分数量。
    3. 该步骤所需的虚拟物品数量。
  4. 单击下一步
  1. 如需个性化奖励链:

    1. 个性化奖励链开关设为启用状态。
    2. 选择以下任一显示选项并单击下一步
      • 向特定用户显示奖励链。启用后,奖励链仅向满足指定条件的授权用户显示。
      • 向不满足条件的用户显示奖励链。启用后,仅在未找到匹配的奖励链时显示(例如用户未授权或其属性与任何个性化链不匹配)。
    3. 如果选择向特定用户显示奖励链:
      1. 单击添加条件并设置个性化条件:
        • 用户属性指用户特征,如国家/地区或年龄。可在登录管理器部分配置属性。
        • 属性类型用于定义属性值的格式:字符串、数字或日期。
        • 比较运算符用于确定如何将用户属性值与指定条件进行比较,例如等于大于小于包含
        • 属性值是用于比较的具体值。例如,如果用户属性为年龄,属性类型为数字,比较运算符为大于,属性值为18,则奖励链将仅向18岁以上的用户显示。
      2. 要添加其他个性化条件,请单击添加条件
    4. 单击下一步
  1. 创建所需数量的阶段步骤并单击保存
注:
每个等级所需的奖励积分应逐步增加。单个奖励链建议最多包含31个阶段步骤。
  1. 单击下一步
  2. 指定奖励链的有效期。
  3. 如需在特定时间更新奖励链,请将将奖励链设置为可更新开关设置为并指定更新模式。
  1. 单击保存
要激活奖励链:
  1. 在奖励目录中,选择奖励链。
  2. 单击•••并从下拉列表中选择激活

通过API调用进行设置

您可以使用奖励链和奖励积分方法组中管理子部分的方法来管理奖励系统。

  1. 通过创建奖励积分API创建可用于获取奖励的奖励积分。
  2. 使用设置商品的奖励积分API为特定商品分配奖励积分 — 用户购买这些商品后将获得相应的积分。
  3. 通过创建奖励链API创建奖励系统。要创建个性化奖励链,请在attribute_conditions数组中传递显示条件。

    您可以指定当用户没有条件中定义的属性时,是否向其显示个性化奖励链。方法是在can_be_missing参数中传递true

    您还可以定义一个在未找到匹配的个性化奖励链时向用户显示的奖励链。为此,请在is_always_visible参数中传递false

  4. 使用切换奖励链API激活奖励系统。

您也可以修改禁用删除奖励系统,以及移除商品的奖励积分。

本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2025年10月8日

发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!
无法发送您的反馈
请稍后重试或发送邮件至doc_feedback@xsolla.com与我们联系。