捆绑包

工作原理

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

主要功能：

• 向捆绑包添加不同类型的商品：
  • 虚拟货币
  • 虚拟货币套餐
  • 针对预选平台的游戏Key
  • 虚拟物品
  • 捆绑包
• 免费捆绑包。
• 在真实货币和虚拟货币下配置捆绑包定价。可以为多种真实或虚拟货币设置价格。在此情况下请务必选择默认货币。
• 为捆绑包设置区域价格。
• 限制可购买的捆绑包数量。
• 设置捆绑包在商店中的显示时间限制。
• 按区域限制捆绑包可用性。

限制：

• 不能将同一个捆绑包添加到该捆绑包中。
• 不能创建空的捆绑包。
• 如果捆绑包包含游戏Key且可用Key已用尽，将暂停销售该捆绑包。
• 仅可通过API调用为捆绑包设置区域限制。

设置方法

要创建捆绑包：

2. 点击Create manually，并从下拉列表中选择Bundle。

3. 在 General settings 部分，填写以下内容：
   • SKU
   • 商品所属的一个或多个组（可选）
   • 名称
   • 简短描述
   • 扩展描述—如需添加，请打开相应的开关（可选）

4. 在 Media 部分，上传一张或多张图片或视频（可选）——可从设备上传或通过链接添加。使用艾克索拉建站器创建的网站中，所有商品卡片都会显示被标记为 Main 的文件，其余文件仅在带有媒体图库的商品卡片中可见。被标记为 Main 的文件也会在目录检索API调用的响应中返回。

5. 在Bundle items部分，选择要添加到捆绑包的SKU。至少需要一个商品。

6. 在Price settings部分，设置价格或创建免费商品：
   • 如需设置价格，选择Paid item，打开Pricing in real currency和/或Pricing in virtual currency开关，并指定价格。如需，配置区域价格。
   • 如需创建免费商品，选择Free item。

7. 若要限制可购买的商品数量：
   1. 在Limits部分打开开关并指定数量。
   2. 配置重置频率。为此，从下拉列表中选择一个周期：
      • Daily。
      • Weekly。
      • Monthly。
      • Custom interval。区间从商品在商店开始显示之日开始计算。
      • No regular refresh。
   3. 根据所选周期设置重置计划，填写相应参数。

8. 配置商品的显示时间限制（可选）：

   1. 在Add specific display period部分打开开关。
   2. 指定时区以及该时间段的开始和结束时间。

   如需不指定商品显示结束时间，请打开No end date开关。

9. 按以下任一方式配置属性（可选）：
   1. 以JSON格式添加属性及其值。
   2. 手动创建属性及其值，并将其关联到商品。

10. 如果该付费商品将用于任何随机奖励机制（如战利品箱或扭蛋），启用Mark as paid randomized reward开关。

11. 点击Create。

12. 在打开的窗口中，选择商品状态，然后点击Continue。

创建的商品会显示在 All items 部分。

通过API设置

要设置捆绑包，可以使用Bundles组中Admin子部分的API调用。

要向捆绑包添加某个平台的游戏Key，请在创建捆绑包或更新捆绑包调用中，向content数组传入所需平台的SKU。

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

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

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

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

在商店中显示捆绑包

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

通过建站器显示

要在网站上显示捆绑包：

1. 创建捆绑包。
2. 在发布商帐户的项目中，前往Storefronts > Websites部分。
3. 在目标网站的面板中，点击Open Site Builder。

1. 创建捆绑包。

2. 在移动端游戏专用帐户的项目中，前往Web Shop部分。

3. 点击目标网站的面板。

4. 如果网站包含多个页面，请选择需要的页面：

   1. 点击编辑器顶部的当前页面标题。
   2. 在下拉列表中选择所需页面。

5. 在Store区块中，前往Store部分。

6. 在Item type字段中，选择Bundles。

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

9. 如有需要，可在卡片布局设置中打开相应开关以自定义卡片布局。

10. 完成所有必要更改并准备发布网站后：

    1. 在建站器右上角，点击Publish。
    2. 勾选要发布的页面。
    3. 点击Publish。

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

通过API获取捆绑包信息

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

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

设置Webhook

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

向用户发放捆绑包

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

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

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