Бандлы

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

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

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

  • Добавление в состав бандла товаров разных типов:
    • виртуальная валюта (в том числе платформозависимая);
    • пакет виртуальной валюты;
    • игровые ключи для заранее выбранных 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 предназначены для построения каталога в магазине на клиенте. Для их использования авторизация не требуется.
Была ли статья полезна?
Спасибо!
Что может сделать статью еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.