Бандлы

Как это работает

Бандл — комплект, состоящий из нескольких товаров, которые продаются как единое целое.

Основные возможности:

• Добавление в состав бандла товаров разных типов:
  • виртуальная валюта (в том числе платформозависимая);
  • пакет виртуальной валюты;
  • игровые ключи для заранее выбранных DRM;
  • виртуальные предметы, включая непродлеваемые подписки;
  • бандлы.
• Настройка цены для бандла в реальной и/или виртуальной валюте.

Распаковка бандла происходит автоматически после: 

• покупки;
• начисления в инвентарь игрока через методы управления инвентарем.

Способ доставки товаров из распакованного бандла зависит от типа товара:

• пакеты виртуальной валюты, виртуальные предметы, непродлеваемые подписки, бандлы доставляются:
  • в инвентарь (способ по умолчанию)
  • в PlayFab, если настроена интеграция
• игровые ключи доставляются:
  • на почту (способ по умолчанию)
  • в PlayFab, если настроена интеграция

При возврате бандла, например, при отмене транзакции, у пользователя списываются все товары, которые были в его составе. Если какие-то из товаров на момент возврата уже потрачены игроком, спишется только доступный остаток.

Ограничения:

• В состав бандла нельзя добавить:
• этот же бандл;
• физический товар.
• Нельзя создать пустой бандл.
• Продажа бандла будет приостановлена, если кончились свободные для продажи ключи из состава бандла.
• Цена бандла должна быть задана только фиксированным значением в реальной и/или виртуальной валюте.
• Региональные ограничения на бандл настраиваются только через методы API.

Для кого подходит

Для партнеров, которые хотят продавать наборы товаров по цене ниже стоимости его содержимого, что способствует увеличению продаж и привлечению игроков, и у которых подключен один из следующих продуктов (или оба):

• Внутриигровой магазин с настроенными модулями Виртуальная валюта или Виртуальные товары.
• Buy Button с настроенным модулем Игровые ключи.

Как настроить

Предварительные действия

1. Зарегистрируйтесь в Личном кабинете Иксолла.
2. Перейдите к вашему проекту.

3. Перейдите в Настройки проекта > Настройки интеграции и убедитесь, что переключатель Интегрировать методы Commerce API установлен в положение Вкл.

4. Настройте модули для продукта Внутриигровой магазин или Buy Button.

Сценарий интеграции

1. Настройте бандл.
2. Реализуйте получение бандлов в каталоге.

Настройка бандла

Настройте бандлы одним из следующих способов:

• через Личный кабинет;
• через методы API.

Настройка через Личный кабинет

1. В разделе Магазин > Бандлы в Личном кабинете нажмите кнопку Создать бандл.
2. Настройте бандл:
   1. Загрузите изображение.
   2. Укажите название.
   3. Укажите описание.
   4. Настройте содержимое.
   5. Настройте стоимость.
   6. Настройте отображение в магазине.
3. Проверьте настройки и нажмите кнопку Сохранить.

Настройка через методы API

Для настройки бандлов используются методы подраздела Admin из группы методов Bundles.

Добавление в бандл игрового ключа

Чтобы добавить в бандл игровой ключ для выбранной DRM, передайте в метод Create bundle или Update bundle массив объектов с артикулами нужных DRM.

"content": [{
     “sku”: “brilliant_game_sku_steam”,
     “quantity”: 1
  }
]

Настройка региональных ограничений

Чтобы настроить региональные ограничения на бандл, передайте в метод Create bundle или Update bundle массив объектов с идентификаторами регионов, в которых бандл будет доступен для продажи.

"regions": [{
     “id”: “123”
  }, {
     “id”: “456”
  }
]

Настройка региональных цен

Чтобы настроить региональные цены на бандл, передайте в метод Create bundle или Update bundle массив объектов с настройками цен для регионов.

"regional_prices": [{
     “region_id”: “123”,
     “country_iso”: “CHN”,
     “amount”: 40,
     “currency_iso”: “CNY”,
     “is_default”: true,
     “is_enabled”: true
  }
]

Получение бандлов в каталоге

Для получения каталога бандлов используются методы подраздела Catalog из группы методов Bundles.