In-Game Store / Купоны
  На главную

In-Game Store

Купоны

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

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

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

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

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

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

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

Сценарий интеграции

Примечание
Чтобы погасить купон и получить бонусные товары, пользователь должен быть авторизован.
  1. В вашем магазине отобразите поле, в которое пользователь вводит код купона.
  2. С помощью метода Подтвердите промокод проверьте корректность введенного кода купона.
  3. Используйте метод Погашение кода купона, чтобы погасить купон. Если в качестве бонуса предоставляется игровой ключ, он доставляется на email-адрес пользователя.

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

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

  1. Зарегистрируйтесь в Личном кабинете.
  2. Подключите Магазин и настройте модули Виртуальные товары и Виртуальная валюта.

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

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

При любом варианте настройки акции необходимо реализовать вызовы методов API для проверки корректности купона и погашения купона.

Настройка через Личный кабинет

При настройке акций с купоном через Личный кабинет вы можете:

  • настраивать период действия акции;
  • ограничивать количество использований акции пользователем;
  • настраивать акции, действующие для всех типов товаров, таких как:

При настройке через Личный кабинет нельзя редактировать акции со статусом Активная.

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

Примечание
Созданные акции по умолчанию отключены. Чтобы активировать акцию, перейдите в редактирование акции после ее создания и в правом верхнем углу в раскрывающемся списке выберите Активировать акцию.
Чтобы настроить акцию через Личный кабинет:
  1. Откройте проект в Личном кабинете.
  2. В боковом меню нажмите Store.
  3. В панели Акции и награды нажмите:
    • Подключить — если у вас еще нет акций;
    • Настроить — если вы ранее уже подключали акции.
  1. Нажмите Создать акцию.
  1. Задайте необходимые параметры:
    1. Укажите название акции.
    2. Выберите тип Купоны.
    3. Создайте Внешний ID — уникальный ID акции, используемый для управления акциями с помощью методов API.
    4. Выберите вознаграждение, которое получит пользователь при погашении купона:
  1. Укажите общее количество погашений и количество погашений на пользователя.
  1. Укажите срок действия кампании.
  1. Проверьте настройки и сохраните акцию.
  1. Перейдите в раздел редактирования акции.
  2. На вкладке Коды выберите тип генерации промокодов.
  3. Сгенерируйте или введите вручную промокод.
  4. Сохраните изменения.
  5. Активируйте акцию.

Купон с пакетом виртуальной валюты

Для купона с пакетом виртуальной валюты необходимо указать используемый пакет валюты. Чтобы создать пакет:
  1. Перейдите в настройки модуля Виртуальная валюта и задайте следующие параметры:
    • изображение;
    • артикул;
    • название;
    • стоимость за единицу;
    • валюта по умолчанию.
  2. Создайте необходимое количество пакетов виртуальной валюты и каждому задайте следующие параметры:
    • изображение;
    • артикул;
    • название;
    • описание;
    • используемая валюта;
    • количество валюты в пакете;
    • цена;
    • валюта по умолчанию.
  3. Включите отображение пакетов в Магазине.

Купон с игровым ключом

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

Купон с виртуальным предметом

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

Генерация купонов

В кампании может быть множество купонов. Формат кода купона может быть представлен в следующих вариантах:
  1. Введенная вручную строка (максимум 128 символов). Подходит для кампании из единственного купона с многократным использованием.
  2. Сгенерированная строка — строка из цифр и букв латинского алфавита длиной 10 символов. Подходит для кампании с большим количеством купонов.
Коды купонов генерируются в редакторе акции после создания акционной кампании. Возможна многократная генерация кодов. Загрузка введенных вручную кодов купонов выполняется по запросу.
Примечание
Код купона чувствителен к регистру. Например, winter2021 и WINTER2021 — разные купоны.

Региональные ограничения

Региональные ограничения устанавливаются на всю акционную кампанию. Установка региональных ограничений выполняется по запросу.

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

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

Настройка акции:

ЗадачаМетод API
Создать акцию с купономСоздание акции с купонами
Активировать акцию с купономАктивация акции с купонами
Отредактировать акциюОбновление акции с купонами с новыми параметрами акции. Редактирование акции также доступно для акций со статусом Активная
Деактивировать акциюДеактивация акции с купонами
Настроить бессрочную акциюСоздание акции с купонами или Обновление акции с купонами. Передайте в указанные методы параметр “date_end”:null.
Проверка и применение купона:
ЗадачаМетод API
Проверить корректность купонаПодтвердите промокод
Погасить купонПогашение кода купона
Получить список платформ распространения игры для отображения пользователю, если в качестве бонуса по купону предоставляется игровой ключПолучение вознаграждений по купону
Управление ограничениями:
ЗадачаМетод API
Получить оставшееся количество использований купона для конкретного пользователяИнформация об ограничении на применение купонов для указанного пользователя
Увеличить оставшееся количество использований купона для конкретного пользователяУвеличение количества применений купона для указанного пользователя
Установить новое ограничение на использование купона для конкретного пользователяУстановка ограничения на применение купонов для указанного пользователя
Уменьшить оставшееся количество использований купона для конкретного пользователяУменьшение лимита купонов для указанного пользователя
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 3 октября 2024

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

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!