Бонусы

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

Основная информация

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

Примечание
Игровые ключи отправляются на email-адрес пользователя или в систему владения играми.

В качестве бонусных товаров могут использоваться:

  • пакеты виртуальной валюты;
  • игровые ключи;
  • виртуальные предметы;
  • бандлы.

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

  • При покупке одного товара пользователь может получить неограниченное количество бонусов.
  • Один товар может участвовать в неограниченном количестве бонусных акций.
  • Настройка ограничений на количество использований бонуса одним пользователем.
  • Настройка персонализированных бонусных акций.
Внимание
На бонусные акции нельзя настроить региональные ограничения.

Сценарий пользователя

Сценарий пользователя при покупке товара на сайте, который создан с помощью конструктора сайтов Xsolla:

  1. Пользователь переходит в магазин.
  2. Пользователь выбирает товар с лейблом Бонус.
  1. В карточке товара пользователь видит бонусные товары.
  1. Пользователь добавляет товары в корзину или переходит к покупке выбранного товара без добавления в корзину.
  2. Пользователь оплачивает покупку.
  3. Товары начисляются пользователю.

Логика работы ограничений

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

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

В зависимости от настроенных ограничений существуют разные сценарии пользователя при покупке акционных товаров с бонусом. Например, когда настроено ограничение на покупку бонусного товара, логика будет следующей:

  • Для товара Booster задано ограничение на покупку — не более 2 раз для одного пользователя.
  • Booster является бонусным товаром при покупке товара Empire Lootbox.
  • Пользователь 1 раз купил Booster и 1 раз купил Empire Lootbox, получив Booster в качестве бонуса. При попытке купить Empire Lootbox повторно, в ответе на метод создания заказа придет сообщение, что пользователь превысил ограничение на покупку товара Booster. В результате пользователь не сможет получить товар ни одним из этих способов.
Другие примеры Пример ограничения на использование бонусной акции:

  • Для бонусной акции задано ограничение на использование — не более 1 раза для одного пользователя.

  • Booster является бонусным товаром при покупке товара Empire Lootbox.

  • Пользователь 1 раз купил товар Empire Lootbox, получив Booster в качестве бонуса.

  • При попытке купить Empire Lootbox повторно, бонусный товар Booster не будет отображаться пользователю.

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

  • Для товара Booster задано ограничение на покупку — не более 1 раза для одного пользователя.

  • Booster является бонусным товаром при покупке товара Empire Lootbox.

  • Для бонусной акции задано ограничение на использование — не более 2 раз для одного пользователя.

  • Пользователь 1 раз купил товар Empire Lootbox, получив Booster в качестве бонуса.

  • При попытке купить Empire Lootbox повторно, в ответе на метод создания заказа придет сообщение, что пользователь превысил ограничение на покупку товара Booster. В результате пользователь не сможет получить товар ни одним из этих способов.

Настройка бонусной акции

Примечание

Чтобы создать акцию с бонусными товарами, вам необходимо сперва настроить товары, а затем перейти к настройке акции.

Для создания товаров вручную в проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары. Подробная информация об этом и других способах создания товаров приведена в разделе документации Каталог товаров.

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

Чтобы создать новую бонусную акцию:

  1. В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Акции.
  2. На вкладке Акции нажмите Создать акцию.
  1. Укажите основные параметры акции:
    1. Укажите Название акции.
    2. В раскрывающемся списке Тип акции выберите значение Бонус.
    3. Настройте акционные товары:
      1. В раскрывающемся списке Акционные товары выберите тип товара, при покупке которого пользователю будут начислены бонусные товары.
Примечание

Тип товара доступен для выбора, если в вашем проекте создан хотя бы один товар с этим типом.

Это применимо и к бонусным товарам.

      1. Выберите товары.
Примечание

Вы можете выбрать товары разного типа. Для переключения между разными типами товаров используйте поле Акционные товары. Информация о всех выбранных товарах отображается в области Список акционных товаров.

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

    1. Настройте бонусные товары:
      1. В раскрывающемся списке Бонусные товары выберите тип товара, который будет начисляться пользователю при покупке акционного товара.
      2. Выберите товары.
    2. Нажмите Далее.
  1. Настройте ограничения на действие акции:
    1. Чтобы акция распространялась только на первую покупку пользователя, активируйте переключатель Акция на первую покупку. При использовании этой настройки вы не сможете настроить другие ограничения.
    2. Чтобы ограничить количество получений бонуса одним пользователем, активируйте переключатель Ограничивать использование акции пользователем и укажите необходимое значение.
    3. Чтобы акция распространялась на пользователей, чьи атрибуты соответствуют заданным условиям, активируйте переключатель Акция для определенных пользователей и укажите условия проверки атрибутов.
    4. Нажмите Далее.
  1. Укажите период действия акции: часовой пояс, начало и конец периода. Чтобы не указывать конец периода действия акции, установите флажок Без даты окончания.
  2. Нажмите Далее.
  3. Проверьте настройки акции и нажмите Сохранить и выйти.

Чтобы акция стала доступна пользователям, активируйте ее. Для этого:

  1. В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Акции.
  2. В строке необходимой акции нажмите ••• и в раскрывающемся списке выберите Редактировать.
  1. В раскрывающемся списке в правом верхнем углу выберите Активировать акцию.

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

Внимание
Список параметров, которые необходимо передать при использовании методов API для обновления акций, не совпадает со списком параметров, которые возвращаются при использовании методов API для получения акций. При вызове методов API обновления акций необходимо передавать:
  • обязательные параметры;
  • параметры, значения которых вы хотите изменить;
  • все остальные параметры, которые были возвращены методом получения акций.

Для настройки и управления бонусными акциями через API используйте следующие методы:

ЗадачаМетод API
Создать акцию.Создание акции с бонусами. Чтобы применить акцию ко всем товарам проекта, передайте “condition”: null.
Активировать акцию.Передайте параметр “is_enabled”: true в методе Обновление акции с бонусами или вызовите метод Активация акции.
Обновить акцию.Обновление акции с бонусами. Чтобы применить изменения ко всем товарам проекта, передайте “condition”: null.
Деактивировать акцию.Деактивация акции.
Настроить бессрочную акцию.Создание акции с бонусами или Обновление акции с бонусами. Передайте в указанные методы параметр “date_end”:null.
Удалить акцию.Удаление бонусной акции.
Примечание
Если вы деактивируете или удалите активную акцию, она станет недоступна для пользователей.

Отображение бонусных товаров в магазине

Если вы продаете товары в собственном интерфейсе, вы можете получать информацию о товарах при вызове клиентских методов API для получения каталога (методы из подразделов Общие > Catalog, Виртуальные предметы и валюта > Catalog, Бандлы > Catalog).

Если ваш сайт создан с помощью конструктора сайтов Xsolla, за 30 дней до конца акции на карточке товара автоматически появляется таймер, который показывает оставшееся время действия акции:

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

Чтобы изменить цвет таймера и лейбла Бонус:

  1. В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
  2. Выберите ваш сайт и нажмите Открыть Site Builder.
  3. В боковом меню перейдите в раздел Тема.
  4. Выберите цвет в поле Secondary.
  1. Чтобы изменения вступили в силу, опубликуйте сайт:
    1. В правом верхнем углу конструктора сайтов нажмите Опубликовать.
    2. Установите флажки напротив страниц, которые вы хотите опубликовать.
    3. Нажмите Опубликовать.
Примечание

Если публикация сайта недоступна, убедитесь, что соблюдаются условия:

  • Отсутствуют незаполненные разделы на сайте (отмечены красным индикатором).
  • Подписан Лицензионный договор с Xsolla.
  • Главная страница опубликована или выбрана для публикации. Вы не можете опубликовать дочерние страницы раньше главной.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 13 февраля 2026

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

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