捆绑包
运行机制
捆绑包是作为一个单元出售的一组商品。
主要功能：
- 将不同类型的商品添加至捆绑包：
- 虚拟货币（包括取决于平台的货币）
- 虚拟货币套餐
- 用于预先选中的平台的游戏密钥
- 虚拟物品，包括时效性商品
- 捆绑包
- 配置捆绑包在真实货币和虚拟货币下的价格。
- 免费捆绑包。
- 限制捆绑包可购买的数量。
- 限制捆绑包在商店中的显示时间。
捆绑包在成功购买后自动解开。如果捆绑包中包含捆绑包，则包含的捆绑包自动解开为里面的独立商品。
解开后的捆绑包中的商品交付方法取决于商品类型：
卖家如通过取消交易（假设）退回捆绑包，则捆绑包中所有已发放的商品将自动撤回。如果用户已消耗部分商品，剩余商品仍将撤回。
限制：
- 不能在捆绑包中添加以下商品：
- 同样的捆绑包
- 实体商品
- 不能创建空捆绑包。
- 如果捆绑包中包含密钥，则提供的密钥用完时将暂停销售该捆绑包。
- 捆绑包价格应为固定的真实和/或虚拟货币价格。
- 只能通过API配置捆绑包的区域销售限制。
限制捆绑包可购买的数量
您可以限制捆绑包的购买次数。例如可以限制：
- 单个用户可购的捆绑包数量
- 仅可购买一次的新人捆绑包
如果用户已达到指定的购买限制，则该捆绑包不会在目录中显示。如捆绑包包含有购买限制的虚拟货币套餐或物品，而用户已购的数量已达到允许的数量，则该捆绑包不在目录中显示。
您可以显示捆绑包的最大可购数量以及该用户的剩余捆绑包可购数量。
要在发布商帐户中创建捆绑包时设置购买数量限制，请将限制单个用户可购买此捆绑包的次数开关设置为开，并指定捆绑包的可购次数。
您可以使用捆绑包方法组中的目录子部分下的方法获取捆绑包的信息。
在响应中，除捆绑包的信息之外，还将收到以下信息：
- 单个用户捆绑包的最大可购数量
- 该用户的剩余捆绑包可购数量
关于如何设置或更新限制的更多信息，请参阅用户限制说明。
- json
{
"items": [
{
"sku": "kg_1",
"name": "kg_10.00_bundle",
"type": "bundle",
"description": "pricePoint_44056_1",
"image_url": null,
"long_description": null,
"attributes": {
"external_id": "genre",
"name": "Genre",
"values": [
{
"external_id": "genre_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "Casual"
},
{
"external_id": "genre_eba07bfd0f982940773cba3744d97264dd58acd7",
"value": "Strategy"
},
{
"external_id": "genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8",
"value": "Mobile"
}
]
},
"is_free": false,
"order": 999,
"groups": [],
"price": {
"amount": 9.99,
"currency": "USD",
"amount_without_discount": 9.99
},
"total_content_price": {
"amount": 10.99,
"currency": "USD",
"amount_without_discount": 10.99
},
"media_list": [],
"virtual_prices": [],
"can_be_bought": true,
"bundle_type": "standard",
"limits": {
"$ref": "./Catalog_item_limits.yaml"
},
"content": [
{
"sku": "big_rocket",
"name": "Big Rocket",
"description": "Big Rocket - short description.",
"image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
"type": "virtual_currency",
"quantity": 100,
"virtual_item_type": "non_consumable",
"attributes": {
"external_id": "size",
"name": "Size",
"values": [
{
"external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "Large"
}
]
},
"is_free": false,
"groups": [],
"price": {
"amount": 10.99,
"currency": "USD",
"amount_without_discount": 10.99
},
"virtual_prices": [],
"limits": {
"per_user": {
"total": 5,
"available": 5
},
"per_item": null
},
}
}
]
}
]
}
艾克索拉会确保不超过购买限制数并阻止用户购买超过设定限制的捆绑包。
打开支付界面并支付某个捆绑包后，所有包含该捆绑包的未支付订单将失效。
示例：假设某个捆绑包有购买数量限制，在下单之前，用户可以在多个浏览器选项卡中打开该捆绑包的支付表单。这样会自动为同一个捆绑包创建多个订单。在某个选项卡中购买了该捆绑包后，艾克索拉将自动让该捆绑包的所有其他未付订单失效。
限制捆绑包在商店中的显示时间
您可以设置商品在商店中的显示时间，以实现以下目的：- 保持目录与某段时间的相关性，例如节假日促销期间
- 提前创建捆绑包但不在目录中显示
- 通过在捆绑包旁边显示计时器，激励用户购买
要通过发布商帐户为某个捆绑包设置在商店中的显示时间限制，请选择时间段，然后指定时区及开始和结束日期。如不希望指定捆绑包的显示结束日期，请勾选无结束日期复选框。
要通过API设置在商店中显示捆绑包的时间限制，请在
periods[0].date_from，包含YYYY-MM-DDThh:mm:ss±TMZ格式的商品显示开始日期和时间，其中TMZ是hh:mmGMT格式的时区periods[0].date_until，包含YYYY-MM-DDThh:mm:ss±TMZ格式的商品显示结束日期和时间，其中TMZ是hh:mmGMT格式的时区。如不要指定商品显示结束时间，请传入null
可为商店中的捆绑包设置多个显示时间段。方法是在
示例：
"periods": [
{
"date_from": "2022-06-10T14:00:00+03:00",
"date_until": "2022-06-30T14:00:00+03:00"
},
{
"date_from": "2022-07-10T14:00:00+03:00",
"date_until": "2022-07-30T14:00:00+03:00"
},
{
"date_from": "2022-08-10T14:00:00+03:00",
"date_until": "2022-08-30T14:00:00+03:00"
}
]
适用对象
适用于想通过捆绑包的形式以低于原始总价的价格销售一组商品从而提高销量及吸引新玩家的合作伙伴，以及集成了以下产品（之一或两者）的合作伙伴：
如何获取
集成过程
设置捆绑包
通过以下方式之一设置捆绑包：通过发布商帐户进行设置
- 前往发布商帐户 > 商店 > 捆绑包，然后单击创建捆绑包。
- 为捆绑包指定以下参数：
- 图像
- 名称
- 描述
- 内容
- 价格
- 在商店中显示
- 检查设置并单击保存。
通过API方法进行设置
要设置捆绑包，可使用向捆绑包添加游戏密钥
要在捆绑包中添加一个用于所选平台的游戏密钥，请向
- http
"content": [{
“sku”: “brilliant_game_sku_steam”,
“quantity”: 1
}
]
设置区域限制
要为捆绑包设置区域限制，请向
- http
"regions": [{
“id”: “123”
}, {
“id”: “456”
}
]
设置区域价格
要为捆绑包设置区域价格，请向
- http
"regional_prices": [{
“region_id”: “123”,
“country_iso”: “CHN”,
“amount”: 40,
“currency_iso”: “CNY”,
“is_default”: true,
“is_enabled”: true
}
]
获取目录中的捆绑包
要获取捆绑包目录，可使用发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
