Ограничение количества использований акций
Как это работает
Вы можете настроить ограничение на количество использований акции пользователем, а также задать периоды автоматического обновления ограничений. Настройка ограничений доступна для бонусных и скидочных акций. Вы можете настроить периодическое обновление ограничений:
- чтобы позволить пользователям совершать повторные покупки с использованием акции;
- синхронизировать данные с вашей системой, если продажа товаров осуществляется на нескольких платформах публикации игр.
Для корректного отображения количества использований акции, которое доступно пользователю, необходимо настроить аутентификацию.
Для неавторизованного пользователя всегда отображается максимальное количество использований акции, по которой он может купить товар. Чтобы отобразить пользователю оставшееся количество использований акции с учетом действующего ограничения, необходимо передавать данные авторизации пользователей на этапе запроса:
- каталога товаров с использованием методов подраздела Catalog из группы методов Виртуальные предметы и валюта;
- каталога игр с использованием методов подраздела Catalog из группы методов Игровые ключи.
Xsolla контролирует соблюдение ограничений и не позволяет пользователям использовать акцию с превышением заданного ограничения. При открытии платежного интерфейса и оплате товара с использованием акции все неоплаченные заказы с этим товаром становятся недействительными.
Пример: пользователь может открыть форму оплаты акционного товара в нескольких вкладках браузера или в разных браузерах, пока товар не был куплен. Это автоматически приводит к созданию нескольких заказов на один товар. После покупки товара на одной вкладке Xsolla аннулирует все неоплаченные заказы с товаром.
Настройка и обновление ограничений
Настройка и обновление через Личный кабинет
Для создания акции с ограниченным количеством использований:
- В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Акции.
- Нажмите Создать акцию.
- Укажите название акции.
- В раскрывающемся списке выберите тип Скидка или Бонус.
- В зависимости от выбранного типа акции заполните остальные поля.
- Нажмите Далее.
- Для ограничения количества использований акции на странице Условия и ограничения установите переключатель Ограничивать использование акции пользователем в положение Вкл и введите необходимое число использований.
- Для настройки персонализированной акции установите переключатель Акция для определенных пользователей в положение Вкл. Чтобы настроить персонализацию, воспользуйтесь инструкцией.
- Нажмите Далее.
- Укажите период действия акции: часовой пояс, начало и конец периода. Чтобы не указывать конец периода действия акции, установите флажок Без даты окончания.
- Нажмите Далее.
- Проверьте настройки и нажмите Сохранить и выйти.
- Чтобы активировать акцию:
- В каталоге акций найдите только что созданную акцию.
- В строке с необходимой акцией нажмите ••• и в раскрывающемся списке выберите Редактировать.
- В правом верхнем углу в раскрывающемся меню выберите Активировать акцию.
- В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Акции.
- В строке необходимой акции нажмите ••• и в раскрывающемся списке выберите Редактировать.
- Если нужная вам акция активна, деактивируйте ее в правом верхнем углу в раскрывающемся списке.
- В разделе Условия и ограничения задайте ограничение или нажмите Обновить лимит сейчас, чтобы обновить заданное ограничение на использование акции.
- Проверьте настройки и нажмите Сохранить изменения.
- Чтобы активировать акцию, в правом верхнем углу в раскрывающемся меню выберите Активировать акцию.
Настройка и обновление через методы API
Чтобы задать ежедневные, еженедельные или ежемесячные ограничения, передайте массив limits в методы API:
Для обновления ограничений и управления ими используйте методы API из раздела Ограничения:| Возможность | Метод API |
|---|---|
| Обновить ограничения для всех акций для конкретного пользователя. | Обновление лимитов акций для пользователя. |
| Обновить ограничения для всех или конкретных пользователей. | Обновление лимита акций для пользователей. |
| Изменить ограничения на использование определенной акции для конкретного пользователя. | Настройка лимита акций для пользователя. |
| Получить информацию, какие ограничения настроены для определенного товара для конкретного пользователя. | Получение лимита акций для пользователя. |
| Увеличить доступное количество использований акции для конкретного пользователя. | Увеличение лимита акций для пользователя. |
| Уменьшить доступное количество покупок товара для конкретного пользователя. | Уменьшение лимита акций для пользователя. |
Отображение ограничений в каталоге товаров
Ограничения на использование акций отображаются в каталоге в зависимости от способа его реализации — через конструктор сайтов или с помощью API.
Отображение через конструктор сайтов
Если вы используете конструктор сайтов, ограничения отображаются автоматически. После настройки ограничения использования акции на сайте в карточке товара появляется:
- размер скидки для скидочных акций;
- уведомление о бонусе для бонусных акций;
- строка с количеством доступных к покупке акционных товаров.

Получение информации об ограничениях через API
Если отображение каталога реализовано с помощью API, информация об ограничениях на использование акции возвращается в массиве promotions.limits в методах получения каталога товаров:
- Получение списка виртуальных предметов
- Получение списка виртуальных валют
- Получение списка пакетов виртуальной валюты
- Получение списка бандлов
- Получение списка игр
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.