Бандлы

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание
Предварительно необходимо настроить регионы в проекте через методы 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.

Примечание
Методы из подраздела Catalog предназначены для построения каталога в магазине на клиенте. Для их использования авторизация не требуется.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Оценить страницу
Оценить страницу
Что может сделать страницу еще лучше?

В другой раз

Спасибо за обратную связь!
Последнее обновление: 25 июня 2021

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!