Купоны
Как это работает
Акции с купонами — маркетинговый инструмент, при помощи которого пользователям предоставляются коды для получения бонусных товаров. Пользователь может ввести купон в специальное поле в магазине и погасить его.
После погашения купона пользователь получает один из бонусных товаров:
- игровой ключ;
- пакет виртуальной валюты;
- виртуальный предмет, в том числе бандл или предмет с ограниченным сроком действия.
Основные возможности:
- настройка общего количества погашений в рамках кампании;
- настройка количества погашений для одного пользователя в рамках кампании;
- многократная генерация кодов для купонов;
- применение региональных ограничений для акций и товаров, привязанных к купону.
Ограничения:
- Если в качестве бонусного товара к купону привязаны игровые ключи, после погашения ключ будет отправлен пользователю на email-адрес. Если в кампании закончились ключи, пользователь не сможет погасить купон.
- Если к купонной акции применяются региональные ограничения, пользователь из этого региона не сможет погасить купон.
- Если к купону привязаны товары с региональным ограничением, пользователь из этого региона не сможет получить товар по этому купону.
Пример: по купону бонусом предоставляются щит и меч. На щит действует региональное ограничение – доступен для покупки только в США. Если пользователь не из США вводит код купона, в ответе на методы Verify promotion code или Redeem coupon code вернется ошибка. Пользователь не сможет получить ни один из товаров по купону.
Сценарий интеграции
- В вашем магазине отобразите поле, в которое пользователь вводит код купона.
- С помощью метода Verify promotion code проверьте корректность введенного кода купона.
- Используйте метод Redeem coupon code, чтобы погасить купон. Если в качестве бонуса предоставляется игровой ключ, он доставляется на email-адрес пользователя.
Как настроить
Предварительные действия
- Зарегистрируйтесь в Личном кабинете.
- Подключите Магазин и настройте модули Виртуальные товары и Виртуальная валюта.
Настройка акции с купоном
Вы можете настроить акцию с купоном одним из следующих способов:
- через Личный кабинет;
- через методы API.
При любом варианте настройки акции необходимо реализовать вызовы методов API для проверки корректности купона и погашения купона.
Настройка через Личный кабинет
При настройке акций с купоном через Личный кабинет вы можете:
- настраивать период действия акции;
- ограничивать количество использований акции пользователем;
- настраивать акции, действующие для всех типов товаров, таких как:
- пакеты виртуальной валюты;
- виртуальные предметы, включая предметы с ограниченным сроком действия;
- игровые ключи;
- бандлы.
При настройке через Личный кабинет нельзя редактировать акции со статусом Активная.
Расширенные возможности для настройки акций доступны через методы API.
Чтобы настроить акцию через Личный кабинет:
- Откройте ваш проект в Личном кабинете.
- В боковом меню нажмите Магазин.
- В панели Акции нажмите:
- Подключить – если у вас еще нет акций;
- Настроить – если вы ранее уже подключали акции.
- Нажмите Создать акцию.
- Задайте необходимые параметры:
- Укажите название акции.
- Выберите тип Купоны.
- Создайте Внешний ID — уникальный ID акции, используемый для управления акциями с помощью методов API.
- Выберите вознаграждение, которое получит пользователь при погашении купона:
- Пакет виртуальной валюты.
- Игровой ключ.
- Виртуальный предмет (один или несколько, в том числе бандлы и предметы с ограниченным сроком действия).

- Укажите общее количество погашений и количество погашений на пользователя.

- Укажите срок действия кампании.

- Проверьте настройки и сохраните акцию.

- Перейдите в раздел редактирования акции.
- На вкладке Коды выберите тип генерации промокодов.
- Сгенерируйте или введите вручную промокод.
- Сохраните изменения.
- Активируйте акцию.
Купон с пакетом виртуальной валюты
Для купона с пакетом виртуальной валюты необходимо указать используемый пакет валюты. Чтобы создать пакет:
- Перейдите в настройки модуля Виртуальная валюта и задайте следующие параметры:
- изображение;
- артикул;
- название;
- стоимость за единицу;
- валюта по умолчанию.
- Создайте необходимое количество пакетов виртуальной валюты и каждому задайте следующие параметры:
- изображение;
- артикул;
- название;
- описание;
- используемая валюта;
- количество валюты в пакете;
- цена;
- валюта по умолчанию.
- Включите отображение пакетов в Магазине.
Купон с игровым ключом
Для купона с игровым ключом необходимо указать артикул ключа и способ выбора DRM:
- Купон генерируется для заранее выбранной DRM, параметр устанавливается при генерации купонов.
- Пользователь выбирает DRM при использовании купона.
Купон с виртуальным предметом
Для купона с виртуальным предметом необходимо выбрать артикул добавляемого предмета и его количество. Для одного купона вы можете выбрать несколько виртуальных предметов с разными артикулами, в том числе бандлы и предметы с ограниченным сроком действия.
Генерация купонов
В кампании может быть множество купонов. Формат кода купона может быть представлен в следующих вариантах:
- Введенная вручную строка (максимум 128 символов). Подходит для кампании из единственного купона с многократным использованием.
- Сгенерированная строка — строка из цифр и букв латинского алфавита длиной 10 символов. Подходит для кампании с большим количеством купонов.
winter2021
и WINTER2021
— разные купоны.Региональные ограничения
Региональные ограничения устанавливаются на всю акционную кампанию. Установка региональных ограничений выполняется по запросу.
Настройка через методы API
Используйте методы подразделов Coupons из группы методов Promotions, чтобы управлять акцией с купоном.
Настройка акции:
Задача | Метод API |
---|---|
Создать акцию с купоном | Create coupon promotion |
Активировать акцию с купоном | Activate coupon promotion |
Отредактировать акцию | Update coupon promotion с новыми параметрами акции. Редактирование акции также доступно для акций со статусом Активная |
Деактивировать акцию | Deactivate coupon promotion |
Настроить бессрочную акцию | Create coupon promotion или Update coupon promotion. Передайте в указанные методы параметр “date_end”:null . |
Проверка и применение купона:
Задача | Метод API |
---|---|
Проверить корректность купона | Verify promotion code |
Погасить купон | Redeem coupon code |
Получить список платформ распространения игры для отображения пользователю, если в качестве бонуса по купону предоставляется игровой ключ | Get coupon rewards |
Управление ограничениями:
Задача | Метод API |
---|---|
Получить оставшееся количество использований купона для конкретного пользователя | Get coupon limit for specified user |
Увеличить оставшееся количество использований купона для конкретного пользователя | Increase coupon limit for specified user |
Установить новое ограничение на использование купона для конкретного пользователя | Set coupon limit for specified user |
Уменьшить оставшееся количество использований купона для конкретного пользователя | Decrease coupon limit for specified user |
Была ли статья полезна?
Оценить страницу
В другой раз
Спасибо за обратную связь!
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.