Бандлы

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

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

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

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

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

Если в составе бандла содержится другой бандл, он распакуется на отдельные товары.

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

Note:
Если логика внутриигрового магазина реализована на ваших серверах, вы можете настроить оповещение о покупке товаров. В оповещении будет содержаться бандл и все предметы из его состава.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Notice:
Методы из подраздела Admin не предназначены для построения каталога в магазине на клиенте. Они не должны использоваться на лендингах, в веб-магазинах и внутриигровой логике.

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

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

Copy
Full screen
Small screen
"content": [{
     “sku”: “brilliant_game_sku_steam”,
     “quantity”: 1
  }
]

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

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

Note:
Предварительно необходимо настроить регионы в проекте через методы API или запрос к аккаунт-менеджеру проекта.
Copy
Full screen
Small screen
"regions": [{
     “id”: “123”
  }, {
     “id”: “456”
  }
]

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

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

Note:
Предварительно необходимо настроить регионы в проекте через методы API или запрос к аккаунт-менеджеру проекта.
Copy
Full screen
Small screen
"regional_prices": [{
     “region_id”: “123”,
     “country_iso”: “CHN”,
     “amount”: 40,
     “currency_iso”: “CNY”,
     “is_default”: true,
     “is_enabled”: true
  }
]

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

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

Note:
Методы из подраздела Catalog предназначены для построения каталога в магазине на клиенте. Для их использования авторизация не требуется.