捆绑包

运行机制

捆绑包是作为一个单元出售的一组商品。

主要功能：

• 可向捆绑包添加不同类型的商品：
  • 虚拟货币
  • 虚拟货币套餐
  • 预选平台的游戏密钥
  • 虚拟物品
  • 捆绑包
• 免费捆绑包。
• 以真实货币和虚拟货币配置捆绑包定价。您可以设置多种真实货币或虚拟货币的价格。本场景下请确保选择一种默认货币。
• 为捆绑包设置区域价格。
• 限制可购买的捆绑包数量。
• 设置捆绑包在商店中的显示时间限制。
• 按区域限制捆绑包的可购性。

• 不能在自身中嵌套同一捆绑包。
• 不能创建空的捆绑包。
• 如果捆绑包包含密钥且可用密钥已用尽，该捆绑包的销售将暂停。
• 为捆绑包设置区域限制仅可通过API调用实现。

如何设置

通过发布商帐户进行设置

要创建捆绑包：

1. 在发布商帐户的项目中，前往商品目录 > 全部商品部分。
2. 单击添加，从下拉列表中选择捆绑包。

3. 指定以下参数：
   • 图片（可选）。
   • SKU。
   • 捆绑包所属的一个或多个组。
   • 名称。
   • 描述（可选）。
4. 配置捆绑包属性（可选），可使用以下方法之一：
   • 以JSON格式添加属性及其值。
   • 手动创建属性和值，并将其关联到具体商品。
5. 单击下一步。
6. 如果启用了合作伙伴侧的个性化，您可以选择标准捆绑包或动态捆绑包类型。动态捆绑包允许您跳过在艾克索拉中创建商品，改为在请求目录时返回由您服务器生成的捆绑包内容。如果未启用合作伙伴侧个性化，则不会显示捆绑包类型选择器，系统将自动创建标准捆绑包。

7. 向捆绑包添加商品：
   1. 选择商品类型。
   2. 指定要包含在捆绑包中的一个或多个商品SKU。
   3. 为每个SKU设置数量。

8. 单击下一步。
9. 在付费或免费字段中设置捆绑包价格：
   • 如要创建免费捆绑包，请选择免费捆绑包。
   • 设置价格：选择付费捆绑包并以真实货币或虚拟货币指定价格。您不能创建价格为零的捆绑包。如有需要，可配置区域价格。
10. 如要限制每位用户可购买的捆绑包数量，请打开限制每位用户的捆绑包购买次数开关并输入所需数量。

11. 要配置限制重置频率：
    1. 从下拉列表中选择周期：
       • 每日。
       • 每周。
       • 每月。
       • 自定义间隔 — 从捆绑包的显示开始日期起计算。
       • 不刷新。
    2. 根据所选周期设置重置时间表。

12. 单击下一步。

13. 配置捆绑包在商店中的显示方式：
    1. 选择状态。
    2. 设置显示时间限制（可选）：指定时区以及时间段的开始和结束时间。如果不想指定商品显示的结束时间，请勾选无结束日期复选框。

14. 单击下一步。
15. 检查设置并单击保存。

通过API设置

要设置捆绑包，可使用捆绑包组中管理子部分下的调用。

1"content": [
2  {
3     "sku": "brilliant_game_sku_steam",
4     "quantity": 1
5  }
6]

要限制可供购买的捆绑包数量，请使用创建捆绑包或更新捆绑包API调用并配置以下参数：

• limits — 指定可供购买的捆绑包最大数量。
• limits.recurrent_schedule — 定义数量限制的重置频率。

您还可以配置捆绑包在商店中的显示时间限制并设置区域限制。

在商店中显示捆绑包

捆绑包在目录中的显示方式取决于实现方式，即通过建站器还是通过API实现。

通过建站器显示

要在网站上显示捆绑包：

1. 创建捆绑包。
2. 在发布商帐户的项目中，前往商店 > 网站部分。
3. 在所需网站的窗格中，单击打开建站器。

4. 在商店区块中，前往商店部分。
5. 在商品类型字段中，选择捆绑包商品。

6. 在商品组字段中，选择其所属组。
7. 选择商品卡片布局。

8. 如有需要，可通过在卡片布局设置中打开相应的开关来自定义卡片布局。

9. 完成所有必要更改并准备发布网站后：
   1. 在建站器右上角，单击发布。
   2. 勾选您要发布的页面。
   3. 单击发布。

网站发布后，包含捆绑包的区段将可用。如果未显示捆绑包，请检查其状态是否设置为可用以及是否启用了基于时间的显示限制。

通过API获取捆绑包信息

如果目录是通过API配置的，可通过目录子部分中的以下调用返回捆绑包数据：

• 获取捆绑包列表
• 获取指定组的捆绑包列表
• 获取指定的捆绑包

设置Webhook

您可以通过items数组配置在订单成功支付和订单取消Webhook中包含的商品数据。

向用户发放捆绑包

根据商品类型和集成设置，捆绑包将通过以下方式之一发放给用户：

• 如果已集成PlayFab，虚拟货币和商品将自动发放到用户的PlayFab物品库中。
• 如果使用自定义交付系统，所有虚拟物品和货币将在己侧发放。建议设置Webhook处理程序以在后端接收订单数据。必要的数据包含在订单成功支付Webhook中。
• 如果未禁用捆绑包内容交付，购买捆绑包后，捆绑包中包含的所有商品将作为单独的商品列在订单成功支付Webhook的items数组中。如果捆绑包包含另一个捆绑包，它也将被解包并作为单独的商品传递。

有关此方法和其他获取购买数据方法的更多详细信息，请参阅设置订单状态跟踪部分。