Промокоды и купоны

Промокоды

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

Промокоды погашаются при совершении покупки, а купоны — сразу после того, как пользователь вводит код и применяет его.

Настройка персонализации доступна при любом типе аутентификации в Веб-магазине — через ID пользователя или Xsolla Login.

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

Пользователь переходит на сайт с настроенным блоком Промокоды.

Пользователь нажимает Войти и авторизуется через ID пользователя или Xsolla Login.
Пользователь вводит код в специальное поле в интерфейсе и нажимает кнопку справа от поля.

Открывается модальное окно:
- при активации промокода — с информацией о скидках и/или бонусных товарах;
- погашении купона — с информацией о полученных бонусных товарах.

Если код некорректный, под полем для ввода кода будет описана ошибка.
Пример: Лимит погашений исчерпан.

Для акции с промокодами:
1. Отображается обновленный каталог с учетом скидок и бонусных товаров по промокоду.

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

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

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

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

Чтобы добавить на ваш сайт блок с возможностью погашения кодов:

Создайте акции с промокодами или купонами в разделе LiveOps-инструменты > Акции.
Добавьте поле для ввода кодов на сайт, созданный с помощью Xsolla, в разделе Каналы продаж > Веб-сайты.

Подробная информация о настройке купонов и промокодов приведена на соответствующей вкладке в разделе Как это работает.

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

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

Акции с промокодами — маркетинговый инструмент для повышения конверсии в покупку и увеличения среднего чека. Промокод применяется к заказу и позволяет пользователю получить:

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

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

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

Чтобы установить региональные ограничения на акцию, напишите на [email protected].

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

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

Пример: По промокоду бонусом предоставляются щит и меч. На щит действует региональное ограничение — доступен для покупки только в США. Если пользователь не из США вводит промокод, в ответе на методы Подтвердите промокод или Погашение промокода вернется ошибка. Пользователь не сможет получить ни один из товаров по промокоду.

Вы также можете добавить акции с купонами в свой магазин.

Основные отличия:

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

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

До оплаты покупки пользователь может отменить применение промокода.

Правила применения скидок

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

Пример:

Цена игрового ключа — $10. В Личном кабинете для игровых ключей созданы акции:

Цена виртуального предмета составляет $10. В вашем аккаунте созданы следующие скидочные акции для виртуальных предметов:

скидочная акция Черная пятница с размером скидки 10% и периодом действия 4–30 ноября;
скидочная акция Распродажа с размером скидки 20% и периодом действия 15 ноября — 15 декабря;
акция с промокодом на скидку 5% и периодом действия 1–30 ноября.

20 ноября в момент покупки товара действуют обе скидочные акции и акция с промокодом.

Итоговая стоимость игрового ключа будет определена из расчета (($10 - 10%) - 20%) - 5% = $10 × (100%-10%) × (100%-20%) × (100%-5%) = $10 × 0,9 × 0,8 × 0,95 и составит $6,84.

Настройка кампании с промокодами

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

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

Настройка в Личном кабинете

Настройка акции также доступна через канвас.

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

В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Акции.
На вкладке Акции нажмите Создать акцию.

Укажите Название акции.
В раскрывающемся списке Тип акции выберите значение Промокод.
В поле Внешний ID укажите ID акции, используемый для управления акциями с помощью методов API.
Чтобы при погашении промокода применялась скидка на покупку любого товара или корзины:

1. Установите переключатель Скидка на покупку в положение Вкл.

1. В поле Скидка укажите процент скидки.

Чтобы при погашении промокода применялась скидка на конкретные товары:

1. Установите переключатель Скидка на выбранные товары в положение Вкл.

1. В поле Размер скидки укажите процент скидки.

1. В раскрывающемся списке Тип товара выберите тип товара, на который будет предоставляться скидка при погашении промокода.

1. Выберите товары.

Чтобы предоставлять бонусные товары при погашении промокода:

1. Установите переключатель Бонусные товары в положение Вкл.

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

1. Выберите товары, которые будут предоставляться при погашении промокода.

1. Для виртуальных предметов укажите количество для каждого предмета.

1. Для игровых ключей укажите, когда будет определена платформа:
  - Если вы хотите заранее назначить конкретную платформу (например, Steam), в раскрывающемся списке Тип выбора DRM-платформы выберите Выбор DRM при генерации кода. Затем выберите платформу из раскрывающегося списка DRM-платформа.
  - Если вы хотите предоставить выбор пользователю, в раскрывающемся списке Тип выбора DRM-платформы выберите Игрок выбирает DRM при активации кода.

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

Скидка на заказ или товары указывается целым числом и не может превышать 99%. При настройке скидки на конкретные товары или бонусных товаров учтите следующие особенности:

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

Настройте ограничения по погашениям промокода:

1. Чтобы ограничить количество погашений промокодов в рамках акции среди всех пользователей, установите переключатель Ограничить общее количество погашений в положение Вкл и укажите максимальное количество погашений.

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

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

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

Укажите период действия акции: часовой пояс, начало и конец периода. Чтобы не указывать конец периода действия акции, установите флажок Без даты окончания.

Чтобы добавить еще один период действия акции, нажмите +. Если у акции несколько периодов, каждый из них должен иметь дату окончания. Акция завершается в последнюю секунду указанной минуты. Например, если указано время 12:00, акция завершится в 12:00:59.

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

Чтобы добавить промокоды в акцию:

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

Перейдите на вкладку Коды.
Чтобы автоматически сгенерировать коды:

1. В раскрывающемся списке Формат кода выберите Созданный автоматически.

1. Укажите количество кодов для генерации и нажмите Сгенерировать.

Чтобы добавить коды вручную:

1. В раскрывающемся списке Формат кода выберите Введенный вручную.

1. Введите промокод и нажмите Создать.

1. Повторите предыдущий шаг, чтобы добавить необходимое количество кодов.

Скачайте CSV-файл с кодами (опционально).

Промокод чувствителен к регистру. Например, winter123 и WINTER123 — разные промокоды.

В кампанию можно добавлять новые коды неограниченное количество раз. Однако общее количество добавленных кодов не должно превышать 50 000.

Если вам требуется загрузить большое количество кодов, которые вы сгенерировали самостоятельно, напишите на [email protected].

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

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

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

При настройке акции через API вы можете указывать дробное значение скидки.

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

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

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

Задача	Метод API
Создать акцию с промокодом.	Создание акции с промокодами.
Активировать акцию с промокодом.	Активация акции с промокодами.
Отредактировать акцию.	Обновление акции с промокодами с новыми параметрами акции. Редактирование акции также доступно для акций со статусом Активная.
Деактивировать акцию.	Деактивация акции с промокодами.
Настроить периоды действия акции.	Создание акции с промокодами или Обновление акции с промокодами. Передайте в указанные методы поле `promotion_periods` с массивом объектов с датами, где `date_from` — начало периода действия акции, а `date_until` — окончание. Чтобы сделать акцию бессрочной, укажите только один период и передайте `“promotion_periods[0].date_until": null`.
Удалить акцию.	Удаление акции с промокодами.

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

Настройка применения промокода в приложении или на сайте

Применение промокода в собственном интерфейсе

В интерфейсе приложения (в каталоге или корзине) реализуйте следующие элементы:
- поле для ввода промокода;
- элементы для отображения вознаграждения и скидок по промокоду;
- форму для выбора вознаграждения по промокоду;
- кнопку для применения промокода.
Реализуйте логику работы с промокодами с помощью следующих клиентских методов API:

Задача	Метод API
Проверить корректность промокода.	Подтвердите промокод.
Получить список платформ распространения игры для отображения пользователю, если в качестве бонуса по промокоду предоставляется игровой ключ.	Получение вознаграждений по промокоду. Если в ответе возвращается `is_selectable=true`, для каждого элемента `item` с `type=unit` необходимо отобразить форму выбора элементов из объекта `unit_items`, в которой пользователь сможет выбрать только один элемент для каждого типа `unit`. Параметр `type=unit` передается для игровых ключей. Пользователю в этом случае потребуется выбрать платформу игры.
Отобразить обновленный каталог с учетом скидок и бонусных товаров по промокоду.	Методы из подраздела Catalog. В запросе необходимо передать промокод в параметре `promo_code`.
Купить указанный товар без добавления в корзину и погасить промокод.	Создание заказа с указанным товаром. В запросе необходимо передать промокод в параметре `promo_code`.
Применить промокод и обновить данные о составе и стоимости корзины (применить скидки и добавить бонусные товары).	Погашение промокода. В запросе необходимо передать промокод в параметре `coupon_code`.

Чтобы дополнительно проверять, сколько еще раз пользователь может применить промокод в рамках акции, используйте серверный метод API Информация об ограничении на применение промокодов для указанного пользователя.

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

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

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

Применение промокода на сайте, созданном с помощью Xsolla

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

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

В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.

Откройте проект в вашем аккаунте и перейдите в раздел Web Shop.
В разделе Сайты выберите ваш сайт и нажмите Открыть Site Builder.

Если ваш сайт содержит несколько страниц, выберите нужную страницу:
1. Нажмите на название текущей страницы в верхней части конструктора.
2. Выберите страницу из раскрывающегося списка.
В основной части конструктора выберите место, где вы хотите добавить новый блок, и нажмите Добавить блок.
Выберите блок Промокоды.
Кастомизируйте внешний вид блока (опционально):
- Измените тексты заголовка и описания блока.
- Настройте пользовательский фон блока.
- Измените стиль кнопки.
- Измените текст кнопки для погашения купона.

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

Чтобы изменения вступили в силу, опубликуйте сайт:

1. В правом верхнем углу конструктора сайтов нажмите Опубликовать.

1. Установите флажки напротив страниц, которые вы хотите опубликовать.

1. Подтвердите, что сайт готов к публикации, и нажмите Опубликовать.

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

Отсутствуют незаполненные разделы на сайте (отмечены красным индикатором).
Подписан Лицензионный договор с Xsolla.
Главная страница опубликована или выбрана для публикации. Вы не можете опубликовать дочерние страницы раньше главной.

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

Купонные акции — это маркетинговый инструмент для привлечения внимания потенциальных пользователей к продукту и повышения уровня продаж. При погашении купона пользователю начисляется один или несколько бонусных товаров. В качестве бонусных товаров могут использоваться:

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

Купон содержит код. Чтобы использовать купон, пользователь вводит код в игре или в магазине игры, в том числе в Web Shop.

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

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

Чтобы установить региональные ограничения на акцию, напишите на [email protected].

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

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

Пример: По купону в качестве бонуса предоставляются щит и меч. На щит действует региональное ограничение — доступен для покупки только в США. Если пользователь не из США вводит код купона, в ответе на методы Подтвердите промокод или Погашение кода купона вернется ошибка. Пользователь не сможет получить ни один из товаров по купону.

Вы также можете добавить акции с промокодами в свой магазин.

Основные отличия:

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

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

Авторизованный пользователь переходит в магазин.
Пользователь вводит код купона.
Xsolla возвращает список бонусов доступных по купону (опционально).
Пользователь выбирает бонусы (опционально).
Пользователь погашает купон.
Товары, привязанные к купону, начисляются пользователю так же, как при покупке товара.

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

Предварительные настройки

Перед тем как настроить купонную акцию, вам необходимо настроить товары, которые будут выдаваться в качестве бонуса.

Настройка в Личном кабинете

Настройка акции также доступна через канвас.

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

В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Акции.
На вкладке Акции нажмите Создать акцию.

Укажите основные параметры акции:

1. Укажите Название акции.

1. В раскрывающемся списке Тип акции выберите значение Купон.

1. В поле Внешний ID укажите ID акции, используемый для управления акциями с помощью методов API.

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

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

1. Выберите товары, которые будут предоставляться при погашении купона.

1. Для виртуальных предметов укажите количество для каждого предмета.

1. Для игровых ключей укажите, когда будет определена платформа:
  - Если вы хотите заранее назначить конкретную платформу (например, Steam), в раскрывающемся списке Тип выбора DRM-платформы выберите Выбор DRM при генерации кода. Затем выберите платформу из раскрывающегося списка DRM-платформа.
  - Если вы хотите предоставить выбор пользователю, в раскрывающемся списке Тип выбора DRM-платформы выберите Игрок выбирает DRM при активации кода.

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

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

Настройте лимиты на погашение купона:

1. Чтобы ограничить количество погашений купонов в рамках акции среди всех пользователей, установите переключатель Ограничить общее количество погашений купонов в положение Вкл и укажите максимальное количество погашений.

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

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

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

Укажите период действия акции: часовой пояс, начало и конец периода. Чтобы не указывать конец периода действия акции, установите флажок Без даты окончания.

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

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

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

Перейдите на вкладку Коды.
Чтобы автоматически сгенерировать коды:

1. В раскрывающемся списке Формат кода выберите Созданный автоматически.

1. Укажите количество кодов для генерации и нажмите Сгенерировать.

Чтобы добавить коды вручную:

1. В раскрывающемся списке Формат кода выберите Введенный вручную.

1. Введите код купона и нажмите Создать.

1. Повторите предыдущий шаг, чтобы добавить необходимое количество кодов.

Скачайте CSV-файл с кодами (опционально).

Код купона чувствителен к регистру. Например, winter123 и WINTER123 — разные купоны.

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

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

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

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

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

Задача	Метод API
Создать акцию с купоном.	Создание акции с купонами.
Активировать акцию с купоном.	Активация акции с купонами.
Отредактировать акцию.	Обновление акции с купонами с новыми параметрами акции. Редактирование акции также доступно для акций со статусом Активная.
Деактивировать акцию.	Деактивация акции с купонами.
Настроить периоды действия акции.	Создание акции с купонами или Обновление акции с купонами. Передайте в указанные методы поле `promotion_periods` с массивом объектов с датами, где `date_from` — начало периода действия акции, а `date_until` — окончание. Чтобы сделать акцию бессрочной, укажите только один период и передайте `“promotion_periods[0].date_until": null`.
Удалить акцию.	Удаление акции с купонами.

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

Настройка погашения купона в приложении или на сайте

Погашение купона в собственном интерфейсе

Чтобы пользователи могли использовать купоны в вашем приложении или на веб-сайте:

В интерфейсе приложения реализуйте следующие элементы:
- поле для ввода кода купона;
- форму отображения вознаграждения по купону;
- кнопку для погашения кода купона.
Реализуйте логику работы с купонами с помощью следующих клиентских методов API:

Для вызова клиентских методов Xsolla API вы можете использовать готовые методы SDK. Подробная информация приведена в разделах:

Задача Метод API

Проверить корректность купона. Подтвердите промокод.

Погасить купон. Погашение кода купона.

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

Задача	Метод API
Проверить корректность купона.	Подтвердите промокод.
Погасить купон.	Погашение кода купона.
Получить список платформ распространения игры для отображения пользователю, если в качестве бонуса по купону предоставляется игровой ключ	Получение вознаграждений по купону. Если в ответе возвращается `is_selectable=true`, для каждого элемента `item` с `type=unit` необходимо отобразить форму выбора элементов из объекта `unit_items`, в которой пользователь сможет выбрать только один элемент для каждого типа `unit`. Параметр `type=unit` передается для игровых ключей. Пользователю в этом случае потребуется выбрать платформу.

Получение вознаграждений по купону.

Если в ответе возвращается is_selectable=true, для каждого элемента item с type=unit необходимо отобразить форму выбора элементов из объекта unit_items, в которой пользователь сможет выбрать только один элемент для каждого типа unit.

Параметр type=unit передается для игровых ключей. Пользователю в этом случае потребуется выбрать платформу.

Чтобы дополнительно проверять, сколько еще раз пользователь может применить купон в рамках акции, используйте серверный метод API Информация об ограничении на применение купонов для указанного пользователя.

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

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

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

Погашение купона на сайте, созданном с помощью Xsolla

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

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

В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.

Откройте проект в вашем аккаунте и перейдите в раздел Web Shop.
В разделе Сайты выберите ваш сайт и нажмите Открыть Site Builder.

Если ваш сайт содержит несколько страниц, выберите нужную страницу:
1. Нажмите на название текущей страницы в верхней части конструктора.
2. Выберите страницу из раскрывающегося списка.
В основной части конструктора выберите место, где вы хотите добавить новый блок, и нажмите Добавить блок.
Выберите блок Промокоды.
Кастомизируйте внешний вид блока (опционально):
- Измените тексты заголовка и описания блока.
- Настройте пользовательский фон блока.
- Измените стиль кнопки.
- Измените текст кнопки для погашения купона.

Чтобы изменения вступили в силу, опубликуйте сайт:

1. В правом верхнем углу конструктора сайтов нажмите Опубликовать.

1. Установите флажки напротив страниц, которые вы хотите опубликовать.

1. Подтвердите, что сайт готов к публикации, и нажмите Опубликовать.

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

Отсутствуют незаполненные разделы на сайте (отмечены красным индикатором).
Подписан Лицензионный договор с Xsolla.
Главная страница опубликована или выбрана для публикации. Вы не можете опубликовать дочерние страницы раньше главной.

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

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

Пример:

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

Скидочная акция Черная пятница со скидкой 10% с 4 по 30 ноября
Скидочная акция Распродажа со скидкой 20% с 15 ноября по 15 декабря
Промоакция с промокодом на скидку 5% с 4 по 30 ноября

20 ноября в момент покупки товара действуют обе скидочные акции и акция с промокодом.

Итоговая стоимость игрового ключа будет определена из расчета (($10 - 10%) - 20%) - 5% и составит $6,84.

Создание новой промоакции с промокодом

Чтобы создать промоакцию с промокодом:

В вашем проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Canvas.

В проекте в вашем аккаунте для мобильных игр перейдите в раздел Operation > LiveOps.

Начните создание промоакции одним из следующих способов:
- Вариант 1:

1. 1. На панели инструментов нажмите на иконку.
  2. В области списка акций нажмите значок +.

1. 1. Выберите promo codes и нажмите Create.

- Вариант 2: В панели инструментов нажмите значок + и выберите Promo codes.

- Вариант 3: Откройте контекстное меню в любом месте на канвасе и выберите Promo codes.

Укажите основные настройки:
- Название акции.
- Внешний ID — уникальный ID акции, используемый для управления акциями через методы API.
Определите, когда пользователь может активировать промокод, выбрав один из вариантов в поле Redemption timeframe:
- Before purchase — промокод можно активировать без совершения покупки. В этом случае пользователь может получить только бонусные товары. Настройки скидки для этого варианта недоступны.
- Anytime — промокод можно активировать только во время покупки. В этом случае пользователь может получить бонусные товары, скидки на определенные товары и/или скидку на всю корзину.
Добавьте бонусные товары:
1. Активируйте переключатель Bonus items.
2. Нажмите Select items.
3. В открывшемся окне отметьте галочками нужные товары и укажите их количество.
4. Нажмите Add items.

Чтобы добавить скидку на всю покупку (опционально, недоступно для типа активации Before purchase):
1. Активируйте переключатель Apply discount to entire purchase.
2. Укажите процент скидки.
Чтобы добавить скидку на определенные товары (опционально, недоступно для типа активации Before purchase):
1. Активируйте переключатель Apply discount on selected items only.
2. Укажите процент скидки.
3. Нажмите Select items.
4. В открывшемся окне отметьте галочками нужные товары.
5. Нажмите Add items.

Нажмите Next.
Добавьте условия и ограничения (опционально):
1. Чтобы ограничить общее количество активаций промокода, активируйте переключатель Promo code redemptions limit и введите нужное количество.
2. Чтобы ограничить количество активаций на одного пользователя, активируйте переключатель Promo code redemptions limit per user и введите нужное количество.
3. Чтобы ограничить количество активаций на уникальный промокод, активируйте переключатель Unique promo code redemptions и введите нужное количество.
Нажмите Next.
Укажите срок действия акции.
Нажмите Next.
Проверьте настройки акции.
Чтобы активировать акцию сразу (опционально), активируйте переключатель Create in Active status.
Нажмите Create.

Чтобы добавить созданную промоакцию с промокодом на сайт (по желанию):
1. Откройте сайт в конструкторе, нажав Open или Open in Site Builder на баннере в форме редактирования.
2. Следуйте инструкциям из раздела Set up promo code usage in your application or website.

Промоакции с промокодами создаются в деактивированном состоянии по умолчанию и не содержат промокодов для активации.

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

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

При настройке промоакции через канвас следующие опции недоступны:

Настройка промоакции с ключами игры.
Настройка скидки с дробными процентами.
Настройка промоакции без даты окончания.

Расширенные возможности для настройки промоакций с промокодами доступны через Личный кабинет и методы API.

Добавление промокодов

Чтобы добавить промокоды в акцию:

Откройте акцию для редактирования.

Нажмите Add promo codes.
Добавьте необходимое количество промокодов:
- Чтобы сгенерировать промокоды автоматически:
  1. Выберите Auto-generated и укажите количество промокодов.
  2. Нажмите Generate.
- Чтобы добавить промокод вручную:
  1. Выберите Manually entered.
  2. Нажмите Create.

Промокоды чувствительны к регистру. Например, winter2021 и WINTER2021 — разные промокоды.

Чтобы экспортировать файл со списком промокодов (опционально), нажмите Download CSV.

Активация акции

Вы можете активировать акцию следующими способами:

Из карточки акции:

Из списка акций:

При редактировании акции:

Активные акции не могут быть отредактированы. Чтобы изменить настройки акции, сначала деактивируйте ее.

Настройка применения промокода в приложении или на сайте

Применение промокода в собственном интерфейсе

В интерфейсе приложения (в каталоге или корзине) реализуйте следующие элементы:
- поле для ввода промокода;
- элементы для отображения вознаграждения и скидок по промокоду;
- форму для выбора вознаграждения по промокоду;
- кнопку для применения промокода.
Реализуйте логику работы с промокодами с помощью следующих клиентских методов API:

Задача	Метод API
Проверить корректность промокода.	Подтвердите промокод.
Получить список платформ распространения игры для отображения пользователю, если в качестве бонуса по промокоду предоставляется игровой ключ.	Получение вознаграждений по промокоду. Если в ответе возвращается `is_selectable=true`, для каждого элемента `item` с `type=unit` необходимо отобразить форму выбора элементов из объекта `unit_items`, в которой пользователь сможет выбрать только один элемент для каждого типа `unit`. Параметр `type=unit` передается для игровых ключей. Пользователю в этом случае потребуется выбрать платформу игры.
Отобразить обновленный каталог с учетом скидок и бонусных товаров по промокоду.	Методы из подраздела Catalog. В запросе необходимо передать промокод в параметре `promo_code`.
Купить указанный товар без добавления в корзину и погасить промокод.	Создание заказа с указанным товаром. В запросе необходимо передать промокод в параметре `promo_code`.
Применить промокод и обновить данные о составе и стоимости корзины (применить скидки и добавить бонусные товары).	Погашение промокода. В запросе необходимо передать промокод в параметре `coupon_code`.

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

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

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

Применение промокода на сайте, созданном с помощью Xsolla

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

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

В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.

Откройте проект в вашем аккаунте и перейдите в раздел Web Shop.
В разделе Сайты выберите ваш сайт и нажмите Открыть Site Builder.

Если ваш сайт содержит несколько страниц, выберите нужную страницу:
1. Нажмите на название текущей страницы в верхней части конструктора.
2. Выберите страницу из раскрывающегося списка.
В основной части конструктора выберите место, где вы хотите добавить новый блок, и нажмите Добавить блок.
Выберите блок Промокоды.
Кастомизируйте внешний вид блока (опционально):
- Измените тексты заголовка и описания блока.
- Настройте пользовательский фон блока.
- Измените стиль кнопки.
- Измените текст кнопки для погашения купона.

Чтобы изменения вступили в силу, опубликуйте сайт:

1. В правом верхнем углу конструктора сайтов нажмите Опубликовать.

1. Установите флажки напротив страниц, которые вы хотите опубликовать.

1. Подтвердите, что сайт готов к публикации, и нажмите Опубликовать.

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

Отсутствуют незаполненные разделы на сайте (отмечены красным индикатором).
Подписан Лицензионный договор с Xsolla.
Главная страница опубликована или выбрана для публикации. Вы не можете опубликовать дочерние страницы раньше главной.

Спасибо за обратную связь!

Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.

Последнее обновление: 24 августа 2026

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

Содержание

Сценарий пользователя
Как настроить
Как это работает
Основная информация
Сценарий пользователя
Правила применения скидок
Настройка кампании с промокодами
Настройка в Личном кабинете
Настройка через методы API
Настройка применения промокода в приложении или на сайте
Применение промокода в собственном интерфейсе
Применение промокода на сайте, созданном с помощью Xsolla
Как это работает
Настройка купонной акции
Предварительные настройки
Настройка в Личном кабинете
Настройка через методы API
Настройка погашения купона в приложении или на сайте
Погашение купона в собственном интерфейсе
Погашение купона на сайте, созданном с помощью Xsolla
Создание новой промоакции с промокодом
Добавление промокодов
Активация акции
Настройка применения промокода в приложении или на сайте
Применение промокода в собственном интерфейсе
Применение промокода на сайте, созданном с помощью Xsolla