In-Game Store / Промокоды
  На главную

In-Game Store

Промокоды

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

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

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

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

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

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

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

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

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

Примечание

Ниже описаны сценарии для авторизованного пользователя.

Для неавторизованного пользователя всегда отображается максимальное количество использований акции. Чтобы отобразить пользователю оставшееся количество использований акции с учетом действующего ограничения, необходимо передавать данные авторизации пользователей на этапе запроса каталога товаров с использованием методов подраздела Catalog из группы методов Виртуальные предметы и валюта.

Внимание

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

Если для товара настроено несколько акций, которые действуют в момент покупки, скидки применяются к стоимости товара последовательно. Порядок применения скидок при этом не имеет значения.

Например:

Цена виртуального товара — $10. В Личном кабинете для виртуальных товаров созданы акции:

  • скидочная акция Черная пятница с размером скидки 10% и периодом действия 4–30 ноября;
  • скидочная акция Распродажа с размером скидки 20% и периодом действия 15 ноября — 15 декабря;
  • акция с промокодом на скидку 5% и периодом действия 1–30 ноября.

20 ноября в момент покупки товара действуют обе скидочные акции и акция с промокодом.

Итоговая стоимость виртуального товара будет определена из расчета (($10 - 10%) - 20%) - 5% и составит $6,84.

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

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

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

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

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

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

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

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

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

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

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

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

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

Для создания промокода с пакетом виртуальной валюты:
  1. Создайте пакет виртуальной валюты.
  2. Укажите пакет виртуальной валюты в качестве бонусного товара.

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

Для создания промокода с виртуальным предметом:

  1. Создайте виртуальный предмет.
  2. Укажите виртуальный предмет в качестве бонусного товара.

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

Промокод с игровым ключом

Для создания промокода с игровым ключом:
  1. Создайте пакет игровых ключей.
  2. Укажите артикул созданного пакета игровых ключей в качестве бонуса и способ выбора платформы, для которой приобретается игра:

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

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

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

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

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

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

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

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

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

ЗадачаМетод API
Создать акцию с промокодомСоздание акции с промокодами
Активировать акцию с промокодомАктивация акции с промокодами
Отредактировать акциюОбновление акции с промокодами с новыми параметрами акции. Редактирование акции также доступно для акций со статусом Активная
Деактивировать акциюДеактивация акции с промокодами
Настроить бессрочную акциюСоздание акции с промокодами или Обновление акции с промокодами. Передайте в указанные методы параметр “date_end”:null.
Проверка и применение промокода:
ЗадачаМетод API
Проверить корректность промокодаПодтвердите промокод
Погасить промокодПогашение промокода
Получить список платформ распространения игры для отображения пользователю, если в качестве бонуса по промокоду предоставляется игровой ключGet promo code rewards
Управление ограничениями:
ЗадачаМетод API
Получить оставшееся количество использований промокода для конкретного пользователяИнформация об ограничении на применение промокодов для указанного пользователя
Увеличить оставшееся количество использований промокода для конкретного пользователяIУвеличение количества применений промокодов для указанного пользователя
Установить новое ограничение на использование промокода для конкретного пользователяУстановка ограничения на применение промокодов для указанного пользователя
Уменьшить оставшееся количество использований промокода для конкретного пользователяУменьшение количества применений промокодов для указанного пользователя

Если поле ввода промокода размещено в каталоге, после ввода промокода повторно запросите каталог товаров для пользователя, передав промокод в параметре promo_codeпостроения каталога из подраздела Catalog.

Если вы реализуете быструю покупку одного предмета, используя метод Создание заказа с указанным товаром, передайте информацию о промокоде в параметре promo_code. Это позволит осуществить покупку с учетом промокода.

Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 8 ноября 2024

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

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