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