Промокоды
Как это работает
Акции с промокодами позволяют пользователю покупать товары со скидками и получать бонусные товары, которые настроены в акции. Поле для ввода промокода может отображаться в каталоге или корзине.
Основное отличие: промокоды погашаются при совершении покупки, а купоны — сразу после того, как пользователь вводит код и применяет его.
- скидку, которая применяется ко всей покупке или к указанным товарам;
один из бонусных товаров:
- игровой ключ;
- пакет виртуальной валюты;
- виртуальный предмет, в том числе бандл или предмет с ограниченным сроком действия.
Основные возможности:
- предоставление в качестве вознаграждения по промокоду только скидки, только бонусного товара или скидки и товара одновременно;
- настройка общего количества погашений промокода в рамках кампании;
- настройка количества погашений промокода для одного пользователя в рамках кампании;
- установка региональных ограничений по запросу;
- многократная генерация промокодов;
- добавление в корзину бонусного товара после применения промокода;
- применение скидки к товарам после использования промокода.
Ограничения:
- К покупке можно применить только один промокод.
- Для получения скидки или бонусного товара пользователь должен оплатить товары из корзины.
- Если к промокоду привязаны товары с региональным ограничением, пользователь из региона с заданным ограничением не сможет получить товары по данному промокоду.
Пример: по промокоду бонусом предоставляются щит и меч. На щит действует региональное ограничение – доступен для покупки только в США. Если пользователь не из США вводит промокод, в ответе на методы Verify promotion code или Redeem promo code вернется ошибка. Пользователь не сможет получить ни один из товаров по промокоду.
Сценарий интеграции
Ниже описаны сценарии для авторизованного пользователя.
Для неавторизованного пользователя всегда отображается максимальное количество использований акции. Чтобы отобразить пользователю оставшееся количество использований акции с учетом действующего ограничения, необходимо передавать данные авторизации пользователей на этапе запроса каталога товаров с использованием методов подраздела Catalog из группы методов Virtual Items & Currency.
Для товара можно настроить разные типы акций: скидки, купоны, промокоды и бонусы.
Если для товара настроено несколько акций, которые действуют в момент покупки, скидки применяются к стоимости товара последовательно. Порядок применения скидок при этом не имеет значения.
Например:
Цена виртуального товара — $10. В Личном кабинете для виртуальных товаров созданы акции:
- скидочная акция Черная пятница с размером скидки 10% и периодом действия 4–30 ноября;
- скидочная акция Распродажа с размером скидки 20% и периодом действия 15 ноября — 15 декабря;
- акция с промокодом на скидку 5% и периодом действия 1–30 ноября.
20 ноября в момент покупки товара действуют обе скидочные акции и акция с промокодом.
Итоговая стоимость виртуального товара будет определена из расчета (($10 - 10%) - 20%) - 5% и составит $6,84.
Как настроить
Предварительные действия
- Зарегистрируйтесь в Личном кабинете.
- Подключите Store и настройте модули Виртуальные товары и Виртуальная валюта.
Настройка акции с промокодом
Вы можете настроить акцию с промокодом одним из следующих способов:
- через Личный кабинет;
- через методы API.
При любом варианте настройки акции необходимо реализовать вызовы методов API для проверки корректности промокода и погашения промокода.
Настройка через Личный кабинет
При настройке акций с промокодом через Личный кабинет вы можете:
- настраивать период действия акции;
- ограничивать количество использований акции пользователем;
- настраивать акции, действующие для всех типов товаров, таких как:
- пакеты виртуальной валюты;
- виртуальные предметы, включая предметы с ограниченным сроком действия;
- игровые ключи;
- бандлы.
При настройке через Личный кабинет нельзя редактировать акции со статусом Активная.
Расширенные возможности для настройки акций доступны через методы API.
- Откройте проект в Личном кабинете.
- В боковом меню нажмите Store и откройте модуль Акции и награды.
- Нажмите Создать акцию.
- Задайте необходимые параметры:
- Укажите название акции.
- Выберите тип Промокоды.
- Создайте Внешний ID — уникальный ID акции, используемый для управления акциями с помощью методов API.
- Укажите процент скидки по промокоду. Скидка может быть применена ко всей покупке или к указанным товарам.
- Выберите бонусные товары, которые получит пользователь при погашении промокода:
- без вознаграждения;
- пакет виртуальной валюты;
- виртуальный предмет (один или несколько, в том числе бандлы и предметы с ограниченным сроком действия);
- игровой ключ.
- Укажите общее количество погашений и количество погашений на пользователя.
- Укажите срок действия кампании.
- Проверьте настройки и сохраните акцию.
- Перейдите в раздел редактирования акции.
- На вкладке Коды выберите тип генерации промокодов.
- Сгенерируйте или введите вручную промокод.
- Сохраните изменения.
- Активируйте акцию.
Промокод с пакетом виртуальной валюты
Для создания промокода с пакетом виртуальной валюты:- Создайте пакет виртуальной валюты.
- Укажите пакет виртуальной валюты в качестве бонусного товара.
Промокод с виртуальным предметом
Для создания промокода с виртуальным предметом:
- Создайте виртуальный предмет.
- Укажите виртуальный предмет в качестве бонусного товара.
Для одного промокода вы можете выбрать несколько виртуальных предметов с разными артикулами, в том числе бандлы и предметы с ограниченным сроком действия.
Промокод с игровым ключом
Для создания промокода с игровым ключом:- Создайте пакет игровых ключей.
Укажите артикул созданного пакета игровых ключей в качестве бонуса и способ выбора платформы, для которой приобретается игра:
- Промокод генерируется для заранее выбранной конкретной платформы.
- Пользователь выбирает конкретную платформу при использовании промокодов.
Генерация промокодов
В кампании может быть множество промокодов. Формат промокода может быть представлен в следующих вариантах:- Введенная вручную строка (максимум 128 символов). Подходит для кампании из единственного промокода с многократным использованием.
- Сгенерированная строка — строка из цифр и букв латинского алфавита длиной 10 символов. Подходит для кампании с большим количеством промокодов.
winter2021
и WINTER2021
— разные промокоды.Региональные ограничения
Региональные ограничения устанавливаются на всю акционную кампанию. Установка региональных ограничений выполняется по запросу.Настройка через методы API
Используйте методы подразделов Promo Codes из группы методов Promotions, чтобы управлять акцией с промокодом.
Настройка акции:
Задача | Метод API |
---|---|
Создать акцию с промокодом | Create promo code promotion |
Активировать акцию с промокодом | Activate promo code promotion |
Отредактировать акцию | Update promo code promotion с новыми параметрами акции. Редактирование акции также доступно для акций со статусом Активная |
Деактивировать акцию | Deactivate promo code promotion |
Настроить бессрочную акцию | Create promo code promotion или Update promo code promotion. Передайте в указанные методы параметр “date_end”:null . |
Задача | Метод API |
---|---|
Проверить корректность промокода | Verify promotion code |
Погасить промокод | Redeem promo code |
Получить список платформ распространения игры для отображения пользователю, если в качестве бонуса по промокоду предоставляется игровой ключ | Get promo code rewards |
Задача | Метод API |
---|---|
Получить оставшееся количество использований промокода для конкретного пользователя | Get promo code limit for specified user |
Увеличить оставшееся количество использований промокода для конкретного пользователя | Increase promo code limit for specified user |
Установить новое ограничение на использование промокода для конкретного пользователя | Set promo code limit for specified user |
Уменьшить оставшееся количество использований промокода для конкретного пользователя | Decrease promo code limit for specified user |
Если поле ввода промокода размещено в каталоге, после ввода промокода повторно запросите каталог товаров для пользователя, передав промокод в параметре promo_code
построения каталога из подраздела Catalog.
Если вы реализуете быструю покупку одного предмета, используя метод Create order with specified item, передайте информацию о промокоде в параметре promo_code
. Это позволит осуществить покупку с учетом промокода.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.