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

In-Game Store

Купоны

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

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

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

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

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

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

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

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

Примечание
Чтобы погасить купон и получить бонусные товары, пользователь должен быть авторизован.
  1. В вашем магазине отобразите поле, в которое пользователь вводит код купона.
  2. С помощью метода Verify promotion code проверьте корректность введенного кода купона.
  3. Используйте метод Redeem coupon code, чтобы погасить купон. Если в качестве бонуса предоставляется игровой ключ, он доставляется на 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

Используйте методы подразделов 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
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 3 октября 2024

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

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