奖励系统

运行机制

奖励系统鼓励用户在商店中使用真实货币进行购买。每次购买后，用户都会获得奖励积分，并在奖励链中推进进度。如果用户属于公会，其购买所得的奖励积分也会计入整个公会。

奖励链

您可以创建个人和公会奖励链，并为用户购买的商品提供奖励。一个项目可以包含多个任意类型的奖励链。每个奖励链最多可以包含31个步骤。对于每个步骤，您需要定义领取奖励所需的奖励积分数量。

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

奖励积分

用户在奖励链中的进度由奖励积分决定。奖励积分分为两种类型：个人和公会，分别对应不同类型的奖励链。

如果多个累充奖励链使用相同的累充积分：

• 积分余额会在所有奖励链之间共享，包括新创建的奖励链。
• 在新创建的奖励链中，用户会保留此前已累计的积分。
• 重置奖励链会清除所有使用相同现有累充积分的奖励链中的积分余额。
• 奖励链周期结束后，累充积分不会立即重置。系统每小时执行4次重置，分别在:00、:15、:30和:45。例如，如果奖励链在12:03结束，则会在12:15重置。
  使用相同累充积分的奖励链之间请至少间隔15分钟⸺否则余额将没有足够时间完成重置，用户会带着此前的余额开始奖励链。如需立即重置进度，请使用重置累充奖励链API调用。

公会余额按其成员余额之和计算。因此，重置后公会余额也会被清零。

奖励

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

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

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

设置奖励系统

您可以通过发布商帐户或API配置奖励系统：

1. 创建奖励积分。请确保您的商店中包含用户购买后可获得奖励积分的商品。
2. 创建奖励链。

通过发布商帐户进行设置

要创建奖励积分：

1. 在发布商帐户中打开您的项目，前往LiveOps > 奖励部分。
2. 单击创建奖励积分。

3. 指定以下参数：
   • 添加图片（可选）。
   • 输入名称。
   • 输入唯一SKU。
   • 如果创建公会奖励积分，请开启用作公会奖励积分开关。该设置在奖励积分创建后无法更改。
   • 分配奖励积分：选择商品并指定用户购买每个商品时获得的奖励积分数量。如果商店暂未创建商品，您可以先保存当前设置，稍后再返回完成此步骤。

4. 单击添加行插入所需数量的行。
5. 单击创建奖励积分。

如要修改某个奖励积分的设置，请单击对应行中的编辑。

要创建奖励链：

1. 在发布商帐户中打开您的项目，前往LiveOps > 奖励部分。
2. 单击创建奖励。

3. 选择新奖励链类型 — 个人奖励链或公会奖励链。
4. 指定以下参数，如果选择个人奖励链：
   • 指定奖励链名称。
   • 填写描述。
   • 在下拉列表中选择奖励积分。

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

5. 单击下一步。
6. 单击添加新步骤。
7. 指定以下参数，然后单击保存：
   • 步骤名称。
   • 领取奖励所需的奖励积分数量。
   • 该步骤所需的虚拟物品数量。
8. 单击保存。

9. 添加所需数量的步骤后单击下一步。
10. 如需个性化奖励链：

1. 打开个性化奖励链开关。
2. 选择奖励链显示选项：
   • 向特定用户显示奖励链。设置个性化条件后，该链仅对满足指定条件的已授权用户显示。
   • 向不满足条件的用户显示奖励链。此类奖励链无需指定个性化条件，默认向未授权用户显示，以及在未找到匹配奖励链时向已授权用户显示。
3. 单击下一步。

11. 设置奖励链有效期：选择时区、开始日期和结束日期。如需创建无限期奖励链，请勾选无结束日期复选框。

注：

如需额外添加奖励链有效期，请单击+。若奖励链有多个有效期，每个有效期必须设置结束日期。奖励链在指定分钟的最后一秒结束。例如，结束时间设为12:00时，奖励链将持续至12:00:59。

12. 要在奖励链结束后自动重置进度，请勾选奖励链结束后刷新用户进度复选框。
13. 如需在特定时间更新奖励链，请打开将奖励链设置为可更新开关并指定更新模式。

14. 单击创建。

1. 在发布商帐户的项目中，前往LiveOps工具 > 奖励。
2. 在所需奖励链的行中单击•••，然后从下拉列表中选择激活。

通过API设置

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

显示奖励系统

通过建站器显示

为确保奖励系统正常运行，必须配置用户身份认证。对于未经身份认证的用户，个人和公会奖励链都会显示，但没有进度。

已经过身份认证但不是公会成员的用户只能看到其个人奖励链。公会奖励链将显示为不可用。

要在您的网站上显示奖励链：

3. 如果您的网站包含多个页面，请选择需要编辑的页面：
   1. 单击建站器顶部的当前页面标题。
   2. 从下拉列表中选择目标页面。
4. 在建站器的主区域，选择想添加新区块的位置并点击添加区块。
5. 在区块列表中选择奖励系统。

6. 在下拉列表中选择奖励链。

7. 自定义按钮和文本颜色（可选）。
8. 要预览奖励链，单击建站器右上角的预览按钮。

9. 要应用更改，请发布您的网站：
   1. 在建站器右上角，单击发布。
   2. 勾选要发布的页面旁边的复选框。
   3. 单击发布。

建站器中奖励积分的显示细节

您可以在单个区块中选择多个奖励链，并选择它们的显示方式 — 一个接一个显示或以选项卡形式显示。您可以单独自定义每个奖励链的外观。

商品卡片仅显示已添加到网站的奖励链的奖励积分。但是，当用户购买商品时，公会成员将获得所有已激活奖励链的奖励积分，无论这些奖励链是否在网站上显示。

示例：

假设已设置两个奖励链：一个个人奖励链和一个公会奖励链。个人奖励链使用Crystal作为奖励积分，公会奖励链使用Magic Bubble作为奖励积分。

商品目录中有一件名为Sword的商品，并已分配奖励积分。当公会成员购买该商品时，将获得20个Crystals和40个Magic Bubbles。

当您在建站器中添加商店区块并选择包含Sword商品的类型和商品组时：

1. 如果尚未在网站中添加任何奖励链，Sword商品将不会显示任何奖励积分。
2. 如果仅添加并激活了个人奖励链，Sword商品将仅显示20个Crystals。
3. 如果仅添加并激活了公会奖励链，Sword商品将仅显示40个Magic Bubbles。
4. 如果同时添加并激活了个人和公会奖励链，Sword商品将同时显示20个Crystals和40个Magic Bubbles。

对于公会成员来说，40个Magic Bubbles将显示为激活值。

对于非公会成员用户来说，40个Magic Bubbles将显示为锁定值。

通过API调用显示奖励链

1. 在您的应用程序UI中，实现用于显示奖励链步骤的元素。
2. 使用奖励链和奖励积分组中的以下客户端侧API调用实现链条操作逻辑：

3. 确保商品正确发放给用户。

设置用户公会

如果不使用建站器，则需要在艾克索拉登录管理器的用户属性中传入用户的公会信息，以确保公会奖励链正常运行。操作方法：

1. 在登录管理器中设置属性机制。

 1{
 2	"$schema": "https://json-schema.org/draft/2020-12/schema",
 3	"additionalProperties": false,
 4	"description": "JSON Schema example for user attributes. Not the actual schema.",
 5	"properties": {
 6
 7		"clan_id": {
 8			"description": "name of clan",
 9			"type": "string"
10		},
11		"custom-id": {
12			"description": "custom-id of a user.",
13			"type": "number"
14		},
15		"had_ban": {
16			"description": "Whether the user was banned.",
17			"type": "boolean"
18		},
19		"last_purchase": {
20			"description": "Date of user's last purchase.",
21			"type": "string"
22		},
23	},
24	"required": [],
25	"title": "Example",
26	"type": "object"
27}

2. 要添加或刷新clan_id属性，请使用属性更新方法，并在请求正文中传入包含公会值clan_id的attributes数组。

 1{
 2  "user": {
 3    "id": "1234567890",
 4    "picture": "https://example.com",
 5    "name": "test-name"
 6  },
 7  "attributes": [
 8    {
 9     "key": "clan_id",
10     "value": "beetles"
11    }
12  ]
13}

如果通过艾克索拉登录管理器进行身份认证，请调用更新当前用户的公会API来更新用户的公会。如果属性中包含新公会，用户将获得前一个公会奖励链中未领取的任何奖励，并且其公会归属将被更新。如果用户之前是公会成员但现已不属于任何公会，其公会成员资格将被撤销。此方法的响应中包含用户已领取的奖励。

网页商城的设置细节

配置属性机制后，请实现用户公会数据的传入。

通过用户ID进行身份认证时，在网页商城Webhook的用户验证Webhook响应中传递用户的公会：

• 要添加或刷新clan_id属性，请传递包含clan_id属性键的attributes对象数组。

Webhook响应示例：

 1{
 2  "user": {
 3    "id": "1234567890",
 4    "picture": "https://example.com",
 5    "name": "test-name"
 6  },
 7  "attributes": [
 8    {
 9     "key": "clan_id",
10     "value": "beetles"
11    }
12  ]
13}

• 如果用户已退出公会且尚未加入其他公会，则需要在removing_keys字段中传递clan_id值。

Webhook响应示例：

 1{
 2  "user": {
 3    "id": "1234567890",
 4    "picture": "https://example.com",
 5    "name": "test-name"
 6  },
 7  "removing_keys": [
 8    {
 9      "key": "clan_id"
10    }
11  ]
12}

通过API设置的细节

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

工作原理

奖励系统鼓励用户在商店中使用真实货币进行购买。每次购买后，用户都会获得奖励积分，并在奖励链中推进进度。如果用户属于公会，其购买所得的奖励积分也会计入整个公会。

每次购买获得累充积分的累充奖励链示例：

术语表

前提条件

确保您的商店包含用户可以购买以赚取累充积分的商品。

在创建公会累充奖励链之前，设置用户公会。

创建累充积分

要创建奖励积分：

2. 在累充积分列表区域，点击+图标。

3. 选择累充积分类型——个人累充积分或公会累充积分。累充积分类型在创建步骤中定义，之后无法更改。

4. 添加图片（可选）。

5. 输入名称。

6. 输入唯一的累充积分SKU。

7. 点击下一步。

8. 分配累充积分：

   1. 点击添加受影响的商品。

   2. 选择商品并指定用户购买每个商品时获得的累充积分数量。

   3. 点击选择。

   如果您的商店尚未包含任何商品，您可以保存当前设置并稍后返回此步骤。

9. 点击下一步。

10. 检查累充积分设置。

11. 点击创建。

创建累充奖励链

创建累充奖励链：

2. 通过以下方法之一创建奖励：
   1. 在工具栏中，点击+图标并选择累充奖励链。
   2. 在累充奖励链列表区域，点击+图标。
   3. 在画布上的任意位置打开上下文菜单并选择累充奖励链。

3. 选择累充奖励链类型——个人累充奖励链或公会累充奖励链。累充奖励链类型在创建步骤中定义，之后无法更改。

4. 指定基本的累充奖励链参数：

   1. 如果选择个人累充奖励链：
   2. 指定累充奖励链名称。
   3. 提供描述。
   4. 如果选择公会累充奖励链：
      1. 在公会类型下拉列表中选择公会类型。
      2. 指定累充奖励链名称。
      3. 提供描述。
      4. 指定累充奖励链弹窗标题。
      5. 指定弹窗提示文本（说明用户如何为公会获得奖励）。
      6. 添加奖励弹窗图片（可选）。

5. 点击下一步。

6. 设置累充积分——创建新的累充积分或从现有的中选择。

7. 点击下一步。

8. 为累充奖励链的每个步骤添加奖励。要为单个步骤添加奖励：

   1. 点击添加新步骤。

   2. 选择用户在此步骤中获得的奖励商品，并指定每个商品的数量。

   3. 点击添加商品。

9. 在步骤列表中，指定领取奖励所需的累充积分数量。分配给每个后续步骤的累充积分必须高于前一个步骤。每个步骤的累充积分上限为100,000。

10. 要更改累充奖励链中奖励的顺序，请使用☰图标将行拖动到所需位置（可选）。

11. 添加完每个步骤的奖励后，点击下一步。

12. 指定累充奖励链的有效期：时区、开始日期和结束日期。如果您不想指明有效期的结束日期，请勾选无结束日期复选框。

注：

如需额外添加累充奖励链有效期，请点击添加周期。如果累充奖励链有多个有效期，每个有效期必须设置结束日期。累充奖励链在指定分钟的最后一秒结束。例如，结束时间设为12:00时，累充奖励链将持续至12:00:59。

如果在多个累充奖励链中使用相同的累充积分，请确保一个累充奖励链周期结束与下一个开始之间至少间隔15分钟。累充积分和步骤进度由后台任务在每小时的:00、:15、:30和:45运行时重置（而不是在周期结束时）。如果下一个周期在这些时间之前开始，用户可能仍会保留其先前的余额。如果您希望立即重置步骤进度，请调用重置累充奖励链API方法。

13. 要在累充奖励链结束后自动重置进度，请打开重置累充积分开关。

14. 如需在特定时间更新累充奖励链，请打开将累充奖励链设置为可更新开关并指定更新计划。

15. 如果您想个性化累充奖励链：

    1. 打开个性化累充奖励链开关。

    2. 选择累充奖励链的显示选项：

       • 显示给符合条件的用户——在这种情况下，累充奖励链仅显示给符合指定条件的授权用户。

       • 显示给不符合条件的用户——对于这样的累充奖励链，您无需指定个性化条件——它默认应用。这意味着它显示给未授权用户，以及在未找到匹配的个性化累充奖励链时显示给授权用户。

    3. 如果您选择显示给符合条件的用户选项，请指定条件：

       1. 指定用户属性类型——字符串、数字或日期。

       2. 从下拉列表中选择用户属性。

       3. 选择比较运算符。

       4. 指定用户属性值。

    4. 如需添加更多条件，请点击添加条件并填写显示的字段（可选）。

16. 点击下一步。

17. 检查累充奖励链。

18. 要立即激活累充奖励链（可选），请打开以激活状态创建开关。

19. 点击创建。

20. 要将创建的累充奖励链添加到网站（可选）：

    1. 点击编辑表单横幅中的Open或Open in Site Builder，在建站器中打开网站。
    2. 按照显示奖励系统部分的说明进行操作。

注：

激活状态的累充奖励链无法编辑。要更改促销活动的设置，请先停用它。

您可以通过以下方式激活或停用累充奖励链：

• 从累充奖励链卡片
• 从累充奖励链列表
• 在编辑累充奖励链时

显示奖励系统

通过建站器显示

为确保奖励系统正常运行，必须配置用户身份认证。对于未经身份认证的用户，个人和公会奖励链都会显示，但没有进度。

已经过身份认证但不是公会成员的用户只能看到其个人奖励链。公会奖励链将显示为不可用。

要在您的网站上显示奖励链：

3. 如果您的网站包含多个页面，请选择需要编辑的页面：
   1. 单击建站器顶部的当前页面标题。
   2. 从下拉列表中选择目标页面。
4. 在建站器的主区域，选择想添加新区块的位置并点击添加区块。
5. 在区块列表中选择奖励系统。

6. 在下拉列表中选择奖励链。

7. 自定义按钮和文本颜色（可选）。
8. 要预览奖励链，单击建站器右上角的预览按钮。

9. 要应用更改，请发布您的网站：
   1. 在建站器右上角，单击发布。
   2. 勾选要发布的页面旁边的复选框。
   3. 单击发布。

建站器中奖励积分的显示细节

您可以在单个区块中选择多个奖励链，并选择它们的显示方式 — 一个接一个显示或以选项卡形式显示。您可以单独自定义每个奖励链的外观。

商品卡片仅显示已添加到网站的奖励链的奖励积分。但是，当用户购买商品时，公会成员将获得所有已激活奖励链的奖励积分，无论这些奖励链是否在网站上显示。

示例：

假设已设置两个奖励链：一个个人奖励链和一个公会奖励链。个人奖励链使用Crystal作为奖励积分，公会奖励链使用Magic Bubble作为奖励积分。

商品目录中有一件名为Sword的商品，并已分配奖励积分。当公会成员购买该商品时，将获得20个Crystals和40个Magic Bubbles。

当您在建站器中添加商店区块并选择包含Sword商品的类型和商品组时：

1. 如果尚未在网站中添加任何奖励链，Sword商品将不会显示任何奖励积分。
2. 如果仅添加并激活了个人奖励链，Sword商品将仅显示20个Crystals。
3. 如果仅添加并激活了公会奖励链，Sword商品将仅显示40个Magic Bubbles。
4. 如果同时添加并激活了个人和公会奖励链，Sword商品将同时显示20个Crystals和40个Magic Bubbles。

对于公会成员来说，40个Magic Bubbles将显示为激活值。

对于非公会成员用户来说，40个Magic Bubbles将显示为锁定值。

通过API调用显示奖励链

1. 在您的应用程序UI中，实现用于显示奖励链步骤的元素。
2. 使用奖励链和奖励积分组中的以下客户端侧API调用实现链条操作逻辑：

3. 确保商品正确发放给用户。

设置用户公会

如果不使用建站器，则需要在艾克索拉登录管理器的用户属性中传入用户的公会信息，以确保公会奖励链正常运行。操作方法：

1. 在登录管理器中设置属性机制。

 1{
 2	"$schema": "https://json-schema.org/draft/2020-12/schema",
 3	"additionalProperties": false,
 4	"description": "JSON Schema example for user attributes. Not the actual schema.",
 5	"properties": {
 6
 7		"clan_id": {
 8			"description": "name of clan",
 9			"type": "string"
10		},
11		"custom-id": {
12			"description": "custom-id of a user.",
13			"type": "number"
14		},
15		"had_ban": {
16			"description": "Whether the user was banned.",
17			"type": "boolean"
18		},
19		"last_purchase": {
20			"description": "Date of user's last purchase.",
21			"type": "string"
22		},
23	},
24	"required": [],
25	"title": "Example",
26	"type": "object"
27}

2. 要添加或刷新clan_id属性，请使用属性更新方法，并在请求正文中传入包含公会值clan_id的attributes数组。

 1{
 2  "user": {
 3    "id": "1234567890",
 4    "picture": "https://example.com",
 5    "name": "test-name"
 6  },
 7  "attributes": [
 8    {
 9     "key": "clan_id",
10     "value": "beetles"
11    }
12  ]
13}

如果通过艾克索拉登录管理器进行身份认证，请调用更新当前用户的公会API来更新用户的公会。如果属性中包含新公会，用户将获得前一个公会奖励链中未领取的任何奖励，并且其公会归属将被更新。如果用户之前是公会成员但现已不属于任何公会，其公会成员资格将被撤销。此方法的响应中包含用户已领取的奖励。

网页商城的设置细节

配置属性机制后，请实现用户公会数据的传入。

通过用户ID进行身份认证时，在网页商城Webhook的用户验证Webhook响应中传递用户的公会：

• 要添加或刷新clan_id属性，请传递包含clan_id属性键的attributes对象数组。

Webhook响应示例：

 1{
 2  "user": {
 3    "id": "1234567890",
 4    "picture": "https://example.com",
 5    "name": "test-name"
 6  },
 7  "attributes": [
 8    {
 9     "key": "clan_id",
10     "value": "beetles"
11    }
12  ]
13}

• 如果用户已退出公会且尚未加入其他公会，则需要在removing_keys字段中传递clan_id值。

Webhook响应示例：

 1{
 2  "user": {
 3    "id": "1234567890",
 4    "picture": "https://example.com",
 5    "name": "test-name"
 6  },
 7  "removing_keys": [
 8    {
 9      "key": "clan_id"
10    }
11  ]
12}

通过API设置的细节

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