Промокоды

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

Акции с промокодами — маркетинговый инструмент для привлечения внимания потенциальных пользователей к продукту и повышения уровня продаж. После активации промокода пользователь получает:

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

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

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

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

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

Сценарий пользователя:

1. Пользователь вводит промокод в соответствующее поле в интерфейсе.
2. Стоимость товаров пересчитывается, добавляются бонусные товары.
3. Пользователь совершает оплату покупки, после чего промокод считается погашенным.
4. Если промокод содержал бонусные предметы, они доставляются пользователю одним из способов:
• в инвентарь (виртуальный предмет или пакет виртуальной валюты);
• на email-адрес (игровой ключ);
• в систему владения играми (игровой ключ).

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

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

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

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

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

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

1. В модуле Магазин > Акции в Личном кабинете создайте акцию.
2. Задайте необходимые параметры:
1. Укажите название акции.
2. Выберите тип Промокоды.
3. Создайте Внешний ID — уникальный идентификатор акции, используемый для управления акциями с помощью методов получения вознаграждения и погашения промокода.
4. Укажите процент скидки по промокоду. Скидка может быть применена ко всей корзине или к указанным товарам.
5. Выберите бонусные товары, которые получит пользователь при погашении промокода. Возможные варианты:
• без вознаграждения;
• пакет виртуальной валюты;
• виртуальный предмет (один или несколько, в том числе бандлы и предметы с ограниченным сроком действия);
• игровой ключ.
6. Укажите общее количество погашений и количество погашений на пользователя.
7. Укажите срок действия кампании.
8. Проверьте настройки и сохраните акцию.
9. Перейдите в раздел редактирования акции.
10. На вкладке Коды выберите тип генерации промокодов.
11. Сгенерируйте или введите вручную промокод.
12. Сохраните изменения.
13. Активируйте акцию.

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

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

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

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

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

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

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

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

Для создания промокода с игровым ключом:

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

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

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

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

• Введенная вручную строка (максимум 128 символов). Подходит для кампании из единственного промокода с многократным использованием.
• Сгенерированная строка — строка из цифр и букв латинского алфавита длиной 10 символов. Подходит для кампании с большим количеством промокодов.

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

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

Получение вознаграждения по промокоду

Реализуйте вызов метода Get promo code rewards для получения списка предметов, которые могут быть начислены пользователю при погашении промокода. В зависимости от значения параметра is_selectable в ответе, возможны два сценария:

1. Если в ответе is_selectable=true, для каждого элемента item с type=unit необходимо отобразить форму выбора элементов из объекта unit_items, в которой пользователь сможет выбрать только один элемент для каждого типа unit.

{
   "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

2. Если is_selectable=false, дополнительные параметры в запросе передавать не нужно.

Погашение промокода

Реализуйте вызов метода Redeem promo code, чтобы использовать промокод. В зависимости от значения параметра is_selectable в ответе метода Get promo code rewards, возможны два сценария:

1. Если is_selectable=true, при вызове метода Redeem promo code необходимо передать объект selected_unit_items в следующем формате:

selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

Пример ответа:

{
  {
    "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
    }
    ]
}

2. Если is_selectable=false, дополнительные параметры в запросе передавать не нужно.

Оценить страницу

Что может сделать страницу еще лучше? Отправить

В другой раз

Спасибо за обратную связь!