Бандлы

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

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

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

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

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

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

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

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

2. Нажмите кнопку Create manually и выберите Bundle в выпадающем списке.

3. В разделе General settings укажите:
   • артикул
   • одну или несколько групп, к которым должен относиться товар (необязательно)
   • название
   • краткое описание
   • расширенное описание — чтобы добавить его, включите соответствующий переключатель (необязательно)

4. В разделе Media загрузите одно или несколько изображений или видео (необязательно) — с вашего устройства или по ссылке. В Магазине, созданном с помощью Xsolla site editor, все карточки товаров отображают файл, помеченный как Main, а остальные файлы доступны только в карточках с медиагалереей. Файл, помеченный как Main, также возвращается в ответах методов API получения каталога.

5. В разделе Bundle items выберите SKU, которые нужно добавить в бандл. Необходимо добавить минимум один предмет.

6. В разделе Price settings задайте цену или создайте бесплатный предмет:
   • Чтобы задать цену, выберите Paid item, включите переключатель Pricing in real currency и/или Pricing in virtual currency и укажите цену. При необходимости настройте региональные цены.
   • Чтобы создать бесплатный предмет, выберите Free item.

7. Чтобы ограничить количество предметов, доступных для покупки:
   1. Включите переключатель в разделе Limits и укажите количество.
   2. Настройте частоту сброса лимита. Для этого выберите период из выпадающего списка:
      • Daily.
      • Weekly.
      • Monthly.
      • Custom interval. Интервал рассчитывается от даты начала отображения предмета в магазине.
      • No regular refresh.
   3. Настройте расписание сброса, указав параметры, которые соответствуют выбранному периоду.

8. Чтобы настроить ограничение времени отображения предмета (необязательно):

   1. Включите переключатель в разделе Add specific display period.
   2. Укажите часовой пояс, начало и конец периода.

   Чтобы не указывать конец периода отображения предмета, включите переключатель No end date.

9. Настройте атрибуты одним из способов (необязательно):
   1. Добавьте атрибуты и их значения в формате JSON.
   2. Создайте атрибуты и их значения вручную и привяжите их к предметам.

10. Если платный предмет будет использоваться в любых механиках со случайной наградой (например, лутбоксах или гача), включите переключатель Mark as paid randomized reward.

11. Нажмите кнопку Create.

12. В открывшемся окне выберите статус предмета и нажмите Continue.

Созданный предмет появится в разделе All items.

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

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

Чтобы добавить в бандл ключ игры для выбранной платформы, передайте массив content с SKU нужных платформ в методы Создание бандла или Обновление бандла.

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

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

• limits — максимальное количество бандлов, доступных для покупки.
• limits.recurrent_schedule — как часто происходит сброс лимита.

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

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

Бандлы отображаются в каталоге в зависимости от реализации — через конструктор сайтов или через API.

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

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

1. Создайте бандлы.
2. В проекте в Личном кабинете перейдите в раздел Storefronts > Websites.
3. В панели нужного сайта нажмите кнопку Open Site Builder.

1. Создайте бандлы.

2. В проекте в аккаунте для мобильных игр перейдите в раздел Web Shop.

3. Нажмите на панель нужного сайта.

4. Если на сайте несколько страниц, выберите нужную:

   1. Нажмите на название текущей страницы в верхней части редактора.
   2. Выберите нужную страницу из выпадающего списка.

5. В блоке Store перейдите в раздел Store.

6. В поле Item type выберите Bundles.

7. В поле Item group выберите группу.
8. Выберите макет карточки товара.

9. При необходимости настройте макет карточки, включив соответствующие переключатели в настройках макета.

10. После внесения всех необходимых изменений и подготовки сайта к запуску:

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

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

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

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

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

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

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

Выдача бандлов пользователю

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

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

Подробности см. в разделе Настройка отслеживания статуса заказа.