Промокоды
Как это работает
Акции с промокодами — маркетинговый инструмент для привлечения внимания потенциальных пользователей к продукту и повышения уровня продаж. После активации промокода пользователь получает:
- скидку, которая применяется ко всей корзине или к указанным товарам;
- один из бонусных товаров:
- игровой ключ;
- пакет виртуальной валюты;
- виртуальный предмет — в том числе бандл или предметы с ограниченным сроком действия.
Основные возможности:
- выбор в качестве бонуса только скидки, только бонусного предмета или скидки и предмета одновременно;
- настройка общего количества погашений промокода в рамках кампании;
- настройка количества погашений промокода для одного пользователя в рамках кампании;
- установка региональных ограничений по запросу;
- многократная генерация промокодов;
- добавление в корзину бонусного товара после применения промокода;
- применение скидки к товарам после использования промокода.
Ограничения:
- к корзине можно применить только один промокод;
- для получения скидки или бонуса пользователь должен оплатить товары из корзины;
- если к промокоду привязаны товары с региональным ограничением, пользователь из этого региона не сможет получить товар по данному промокоду.
Как это работает
Сценарий пользователя:
- Пользователь вводит промокод в соответствующее поле в интерфейсе.
- Стоимость товаров пересчитывается, добавляются бонусные товары.
- Пользователь совершает оплату покупки, после чего промокод считается погашенным.
- Если промокод содержал бонусные предметы, они доставляются пользователю одним из способов:
- в инвентарь (виртуальный предмет или пакет виртуальной валюты);
- на email-адрес (игровой ключ);
- в систему владения играми (игровой ключ).
Для игры или списка игр можно настроить разные типы акций: скидки, купоны, промокоды и бонусы.
Если для игры или списка игр настроено несколько скидочных акций, которые действуют в момент покупки, скидки применяются к стоимости товара последовательно. Порядок применения скидок при этом не имеет значения.
Например:
Цена игрового ключа — $10. В Личном кабинете для игровых ключей созданы акции:
- скидочная акция Черная пятница с размером скидки 10% и периодом действия 4–30 ноября;
- скидочная акция Распродажа с размером скидки 20% и периодом действия 15 ноября — 15 декабря;
- акция с промокодом на скидку 5% и периодом действия 1–30 ноября.
20 ноября в момент покупки игрового ключа действуют обе скидочные акции и акция с промокодом.
Итоговая стоимость игрового ключа будет определена из расчета (($10 - 10%) - 20%) - 5% и составит $6,84.
- результат применения скидочной акции:
- размер скидки по акции;
- зачеркнутая цена без скидки;
- цена со скидкой.
- результат применения бонусной акции:
- бонусные товары;
- значение Free в строке цены для бонусных товаров.
- результат применения промокода:
- размер скидки по промокоду;
- зачеркнутая цена без скидки;
- цена со скидкой;
- бонусные товары;
- значение Free в строке цены для бонусных товаров.
Как настроить
Предварительные действия
Сценарий интеграции
- Настройте акционную кампанию с промокодами.
- Реализуйте методы получения вознаграждения по промокоду.
- Реализуйте методы погашения промокода.
Если вы реализуете быструю покупку одного ключа, используя метод Создание заказа с указанным товаром, пользователь переходит к оплате без перехода в корзину.
При этом на стороне Xsolla формируется корзина, которая не отображается пользователю. Это необходимо, чтобы корректно применить все действующие скидки к покупке пользователя и отобразить ему сумму с учетом всех скидок в форме оплаты.
Настройка кампании с промокодами
- В модуле Store > Акции и награды в Личном кабинете создайте акцию.
- Задайте необходимые параметры:
- Укажите название акции.
- Выберите тип Промокоды.
- Создайте Внешний ID — уникальный ID акции, используемый для управления акциями с помощью методов получения вознаграждения и погашения промокода.
- Укажите процент скидки по промокоду. Скидка может быть применена ко всей корзине или к указанным товарам.
- Выберите бонусные товары, которые получит пользователь при погашении промокода. Возможные варианты:
- без вознаграждения;
- пакет виртуальной валюты;
- виртуальный предмет (один или несколько, в том числе бандлы и предметы с ограниченным сроком действия);
- игровой ключ.
- Укажите общее количество погашений и количество погашений на пользователя.
- Укажите срок действия кампании.
- Проверьте настройки и сохраните акцию.
- Перейдите в раздел редактирования акции.
- На вкладке Коды выберите тип генерации промокодов.
- Сгенерируйте или введите вручную промокод.
- Сохраните изменения.
- Активируйте акцию.
Промокод с пакетом виртуальной валюты
Для создания промокода с пакетом виртуальной валюты:
- Создайте пакет виртуальной валюты.
- Укажите пакет виртуальной валюты в качестве бонусного товара.
Чтобы создать пакеты виртуальной валюты:
- Перейдите в настройки модуля Store > Виртуальная валюта и создайте виртуальную валюту. Для этого нажмите Новая виртуальная валюта и добавьте:
- изображение (опционально);
- артикул виртуальной валюты;
- название виртуальной валюты;
- стоимость за единицу;
- валюта по умолчанию;
- атрибут (опционально).
- Создайте необходимое количество пакетов виртуальной валюты. Для этого нажмите Новый пакет и добавьте:
- изображение (опционально);
- артикул пакета;
- название пакета;
- краткое описание пакета;
- виртуальную валюту в составе пакета;
- количество валюты в пакете;
- цены пакета в реальной и (или) виртуальной валюте;
- валюту по умолчанию;
- атрибут (опционально).
- Нажмите Создать пакет.
Промокод с виртуальным предметом
Для создания промокода с виртуальным предметом:
- Создайте виртуальный предмет.
- Укажите виртуальный предмет в качестве бонусного товара.
Чтобы создать виртуальные предметы:
- Перейдите в настройки модуля Store > Виртуальные предметы и нажмите Создать предмет.
- Для каждого предмета добавьте:
- изображение (опционально);
- артикул;
- одну или несколько групп, которым должен принадлежать предмет (опционально);
- название предмета;
- описание предмета;
- свойство предмета — расходуемый, нерасходуемый или с ограниченным сроком действия;
- цены в реальной и виртуальной валюте.
- Нажмите Создать предмет.
Промокод с игровым ключом
Для создания промокода с игровым ключом:- Создайте пакет игровых ключей.
Укажите артикул созданного пакета игровых ключей в качестве бонуса и способ выбора платформы, для которой приобретается игра:
- Промокод генерируется для заранее выбранной конкретной платформы.
- Пользователь выбирает конкретную платформу при использовании промокодов.
Генерация промокодов
В кампании может быть множество промокодов. Формат промокода может быть представлен в следующих вариантах:- Введенная вручную строка (максимум 128 символов). Подходит для кампании из единственного промокода с многократным использованием.
- Сгенерированная строка — строка из цифр и букв латинского алфавита длиной 10 символов. Подходит для кампании с большим количеством промокодов.
winter2021
и WINTER2021
— разные промокоды.Региональные ограничения
Региональные ограничения устанавливаются на всю акционную кампанию. Установка региональных ограничений выполняется по запросу.Получение вознаграждения по промокоду
Реализуйте вызов методаis_selectable
в ответе, возможны два сценария:- Если в ответе
is_selectable=true
, для каждого элементаitem
сtype=unit
необходимо отобразить форму выбора элементов из объектаunit_items
, в которой пользователь сможет выбрать только один элемент для каждого типаunit
.
- http
{
"bonus": [{
"item": {
"sku": "xsollus_gold_edition",
"name": "Xsollus: Gold Edition",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"unit_items": [{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_gold_edition_playstation",
"name": "Xsollus: Gold Edition (playstation)",
"type": "game_key",
"drm_name": "Playstation",
"drm_sku": "playstation"
}, {
"sku": "xsollus_gold_edition_xbox",
"name": "Xsollus: Gold Edition (xbox)",
"type": "game_key",
"drm_name": "XBox",
"drm_sku": "xbox"
}, {
"sku": "xsollus_gold_edition_nintendo_eshop",
"name": "Xsollus: Gold Edition (nintendo_eshop)",
"type": "game_key",
"drm_name": "Nintendo Switch eShop",
"drm_sku": "nintendo_eshop"
}]
},
"quantity": 1
}, {
"item": {
"sku": "xsollus_bonus_pack_edition",
"name": "Xsollus: Bonus Pack",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"unit_items": [{
"sku": "xsollus_bonus_pack_edition_steam",
"name": "Xsollus: Bonus Pack (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_bonus_pack_edition_origin",
"name": "Xsollus: Bonus Pack (origin)",
"type": "game_key",
"drm_name": "Origin",
"drm_sku": "origin"
}, {
"sku": "xsollus_bonus_pack_edition_drmfree",
"name": "Xsollus: Bonus Pack (drmfree)",
"type": "game_key",
"drm_name": "DRM Free",
"drm_sku": "drmfree"
}, {
"sku": "xsollus_bonus_pack_edition_gog",
"name": "Xsollus: Bonus Pack (gog)",
"type": "game_key",
"drm_name": "GOG",
"drm_sku": "gog"
}, {
"sku": "xsollus_bonus_pack_edition_rockstar",
"name": "Xsollus: Bonus Pack (rockstar)",
"type": "game_key",
"drm_name": "Rockstar Games Launcher",
"drm_sku": "rockstar"
}]
},
"quantity": 3
}],
"discount": {
"percent": null
},
"is_selectable": true
- Если
is_selectable=false
, дополнительные параметры в запросе передавать не нужно.
Погашение промокода
Реализуйте вызов методаis_selectable
в ответе метода - Если
is_selectable=true
, при вызове методаRedeem promo code необходимо передать объектselected_unit_items
в следующем формате:
- http
selected_unit_items:{
unit_1_sku: "selected_unit_item_sku",
unit_2_sku: "selected_unit_item_sku"
}
Пример ответа:
- http
{
{
"items": [
{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 1
},
{
"sku": "xsollus_bonus_pack_edition_origin",
"name": "Xsollus: Bonus Pack (origin)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Origin",
"drm_sku": "origin",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 3
}
]
}
- Если
is_selectable=false
, дополнительные параметры в запросе передавать не нужно.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.