Бандлы

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

Бандл — набор товаров, который продается как единое целое.

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

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

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

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

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

Чтобы создать бандл:

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары.
2. Нажмите Добавить и в раскрывающемся списке выберите Бандл.

3. Задайте необходимые параметры:
   • изображение (опционально);
   • артикул;
   • одну или несколько групп, которым должен принадлежать бандл;
   • название бандла;
   • описание бандла (опционально).
4. Настройте атрибуты для бандла одним из следующих способов (опционально):
   • Добавьте атрибуты и их значения в формате JSON.
   • Создайте атрибуты и их значения вручную и настройте их связь с товарами.
5. Нажмите Далее.
6. Если вы используете персонализацию на стороне партнера, выберите тип бандла — стандартный или динамический. Для бандлов динамического типа вы можете не создавать товары на стороне Xsolla, а передавать содержимое бандла, сформированное на стороне вашего сервера в момент запроса каталога. Если персонализация на стороне партнера не подключена, переключатель с выбором типа бандла не отображается и создается бандл стандартного типа.

7. Добавьте товары в бандл:
   1. Выберите тип товара.
   2. Укажите один или несколько артикулов товаров, входящих в бандл.
   3. Задайте количество для каждого артикула.

8. Нажмите Далее.
9. Настройте цену бандла в поле Платно или бесплатно:
   • Чтобы создать бесплатный бандл, выберите Бесплатный бандл.
   • Чтобы задать цену, выберите Платный бандл и укажите цену в реальной или виртуальной валюте. Бандл с нулевой ценой создать нельзя. При необходимости настройте региональные цены.
10. Чтобы ограничить количество бандлов, доступное для покупки, активируйте переключатель Ограничивать покупку бандлов пользователем и введите необходимое число.

11. Чтобы настроить частоту обновления ограничений:
    1. В раскрывающемся списке выберите период:
       • Каждый день.
       • Каждую неделю.
       • Каждый месяц.
       • Настроить интервал. Интервал рассчитывается от даты начала периода показа бандла в магазине.
       • Без регулярного обновления.
    2. Задайте расписание обновления, указав параметры, соответствующие периоду.

12. Нажмите Далее.

13. Настройте отображение бандла в магазине:
    1. Выберите статус.
    2. Настройте ограничение времени отображения бандлов (опционально): укажите часовой пояс, начало и конец периода отображения. Чтобы не указывать конец периода отображения бандла, установите флажок Без даты окончания.

14. Нажмите Далее.
15. Проверьте все настройки и нажмите Сохранить.

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

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

1"content": [
2  {
3     "sku": "brilliant_game_sku_steam",
4     "quantity": 1
5  }
6]

Чтобы настроить ограничение на количество бандлов, доступное для покупки, передайте в методе Создание бандла или Обновление бандла параметры:

• limits — с указанием количества;
• limits.recurrent_schedule — с частотой обновления ограничения.

Также вы можете настроить ограничение времени отображения бандла в магазине и региональные ограничения на бандл.

Отображение бандлов в каталоге товаров

Отображение бандлов зависит от способа реализации каталога — через конструктор сайтов или с помощью API.

Отображение через конструктор сайтов

Чтобы бандлы отобразились на вашем сайте:

1. Создайте бандлы.
2. В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
3. В панели необходимого сайта нажмите Открыть Site Builder.

4. В блоке Магазин перейдите в Раздел магазина.
5. В поле Тип товара выберите Бандлы.

6. В поле Группа товара укажите группу.
7. Выберите стиль карточки товара.

8. При необходимости кастомизируйте стиль карточки товара, для этого активируйте соответствующие переключатели в настройках стиля карточки.

9. Чтобы изменения вступили в силу, опубликуйте сайт:
   1. В правом верхнем углу конструктора сайтов нажмите Опубликовать.
   2. Установите флажки напротив страниц, которые вы хотите опубликовать.
   3. Нажмите Опубликовать.

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

Получение информации о бандлах через API

Если отображение каталога реализовано с помощью API, информация о бандлах возвращается в методах подраздела Catalog:

• Получение списка бандлов
• Получение списка бандлов по указанной группе
• Получение указанного бандла

Настройка вебхуков

Вы можете настроить, какие данные о товарах передаются в вебхуках Успешная оплата заказа и Отмена заказа в массиве items.

Начисление бандлов пользователям

Способ начисления зависит от настроек интеграции в вашем проекте:

• Если настроена интеграция с PlayFab, виртуальные валюты и предметы начисляются в инвентарь PlayFab.
• Если вы используете собственную систему начислений, начисление пользователю виртуальных валют и предметов происходит полностью на вашей стороне. Мы рекомендуем настроить обработчик вебхуков и получать информацию о заказе на серверной части вашего приложения. Данные для начисления приходят в вебхуке Успешная оплата заказа.
• Если передача содержимого бандла не отключена, после покупки бандла все товары, входящие в бандл, передаются в вебхуке Успешная оплата заказа в массиве items как список отдельных товаров. Если в составе бандла содержится другой бандл, он также передается как список отдельных товаров.

Подробная информация об этом и других способах получения данных о покупке приведена в разделе Отслеживание статуса заказа.