Настройка акционных кампаний
После того как вы интегрировали магазин в игру, вы можете настроить купоны, промокоды, бонусы или скидочные акции, чтобы привлекать внимание потенциальных клиентов к продукту и повышать продажи.
Также вам доступна возможность проводить персонализированные акции, то есть настраивать кампании для определенного круга пользователей. Это возможно только для скидочных кампаний и акционных кампаний с бонусами.
Купон предназначен для предоставления пользователям бесплатных товаров. Заказывать товар или покупать корзину в этом случае не требуется. Купон содержит код, который пользователь вводит в игре, на сайте игры или в мобильном приложении игры. При применении купона пользователю в инвентарь начисляется вознаграждение. В качестве вознаграждения может использоваться:
Подробная информация доступна в разделе Купоны.Промокод предназначен для применения скидки к корзине пользователя или добавления бесплатных товаров в корзину во время покупки. После активации промокода и оплаты товаров в корзине пользователь получает один из вариантов вознаграждения:
- скидку, которая применяется к корзине пользователя;
- бонусный предмет:
- пакет виртуальной валюты;
- виртуальный предмет (в том числе бандл или предметы с ограниченным сроком действия).
Бонус предоставляется пользователю при покупке акционного товара. Пользователь может получить следующие бонусные предметы:
- пакет виртуальной валюты;
- виртуальный предмет (в том числе бандл или предметы с ограниченным сроком действия).
Скидочная акция дает возможность настроить скидку на один или несколько товаров. На один товар может действовать неограниченное количество скидочных акций. Скидки при этом не суммируются, а применяются к стоимости товара поочередно. Скидки могут действовать на следующие товары:
- пакет виртуальной валюты;
- виртуальный предмет (в том числе предметы с ограниченным сроком действия).
Кампания с купонами
Чтобы запустить кампанию с купонами:
- Настройте акционную кампанию с купонами.
- Реализуйте методы погашения купонов по коду.
- Реализуйте методы получения награды по купону.
Настройка акционной кампании с купонами
- Откройте ваш проект в Личном кабинете.
- Нажмите Магазин в боковом меню и перейдите в раздел Акции.
- Нажмите Создать акцию.
- Задайте необходимые параметры:
- Укажите название акции.
- Выберите тип Купоны.
- Выберите вознаграждение, которое получит пользователь при погашении купона:
- Пакет виртуальной валюты.
- Виртуальный предмет (один или несколько, в том числе бандлы и предметы с ограниченным сроком действия).
- Добавьте:
- Идентификатор акции в поле Внешний ID.
- Бонусные товары, которые будут предоставлены пользователю при использовании купона.
- Типы товаров и их количество.
- Нажмите Далее.
- Укажите общее количество погашений и количество погашений для пользователя.
- Укажите срок действия кампании.
- Нажмите Далее.
- Проверьте настройки и нажмите Сохранить и выйти.
- Нажмите Магазин в боковом меню и перейдите в раздел Акции.
- Выберите акцию, нажмите ••• и выберите Редактировать план.
- Перейдите на вкладку Коды.
- Выберите тип генерации купонов.
- Сгенерируйте код купона или введите код вручную.
- Активируйте акцию.
Погашение купона по коду
Реализуйте вызов метода is_selectable
в ответе метода
- Если
is_selectable=true
, при вызове методаRedeem coupon 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
, дополнительные параметры в запросе передавать не нужно.
Получение вознаграждения по купону
Реализуйте вызов метода 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_rockstar",
"name": "Xsollus: Gold Edition (rockstar)",
"type": "game_key",
"drm_name": "Rockstar Games Launcher",
"drm_sku": "rockstar"
}]
},
"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_playstation",
"name": "Xsollus: Bonus Pack (playstation)",
"type": "game_key",
"drm_name": "Playstation",
"drm_sku": "playstation"
}, {
"sku": "xsollus_bonus_pack_edition_xbox",
"name": "Xsollus: Bonus Pack (xbox)",
"type": "game_key",
"drm_name": "XBox",
"drm_sku": "xbox"
}]
},
"quantity": 3
}],
"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
, дополнительные параметры в запросе передавать не нужно.
Получение вознаграждения по промокоду
Реализуйте вызов метода 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
, дополнительные параметры в запросе передавать не нужно.
Кампания с бонусами
Чтобы настроить акционную кампанию с бонусом:
- Откройте ваш проект в Личном кабинете.
- Нажмите Магазин в боковом меню и перейдите в раздел Акции.
- Нажмите Создать акцию.
- Задайте необходимые параметры:
- Укажите название акции.
- Выберите тип Бонус.
- Укажите акционные товары.
- Укажите товар, который будет предоставляться пользователю при покупке акционного предмета.
- Нажмите Далее.
- Если вы хотите, чтобы акция распространялась только на определенных пользователей, переведите переключатель Trigger promotion only for specific users в положение Вкл и укажите параметры условия.
- Нажмите Далее.
- Укажите срок действия кампании.
- Нажмите Далее.
- Проверьте настройки и нажмите Сохранить и выйти.
- Нажмите Магазин в боковом меню и перейдите в раздел Акции.
- Выберите акцию, нажмите ••• и выберите Редактировать план.
- Активируйте акцию.
Скидочная кампания
Настройка скидочной кампании через Личный кабинет
Чтобы настроить акцию со скидкой:
- Откройте ваш проект в Личном кабинете.
- Нажмите Магазин в боковом меню и перейдите в раздел Акции.
- Нажмите Создать акцию.
- Задайте необходимые параметры:
- Укажите название акции.
- Выберите тип Скидка.
- Выберите один или несколько товаров, на которые будет распространяться скидка.
- Укажите процент скидки.
- Нажмите Далее.
- Если вы хотите, чтобы акция распространялась только на определенных пользователей, переведите переключатель Trigger promotion only for specific users в положение Вкл и укажите параметры условия.
- Нажмите Далее.
- Укажите срок действия кампании.
- Нажмите Далее.
- Проверьте настройки и нажмите Сохранить и выйти.
- Нажмите Магазин в боковом меню и перейдите в раздел Акции.
- Выберите акцию, нажмите ••• и выберите Редактировать план.
- Активируйте акцию.
Настройка скидочной кампании через методы API
Для работы со скидочными акциями используются методы подраздела
Чтобы создать акцию через методы API:
- Вызовите метод
Create discount promotion for item с необходимыми параметрами. - Вызовите метод
Update item promotion с параметром“is_enabled”:true
, чтобы активировать акцию.
Чтобы отредактировать акцию через метод API, вызовите метод
При создании или редактировании скидочной акции через методы API вы также можете:
- Настроить действие скидки на все товары проекта. Передайте в метод
Create discount promotion for item илиUpdate item promotion параметр“items”:null
.
- Настроить скидку на физические товары. Передайте в метод
Create discount promotion for item илиUpdate item promotion массив объектов с артикулами физических товаров.
- Настроить скидку с дробными процентами. Передайте в метод
Create discount promotion for item илиUpdate item promotion параметрdiscount.percent
с дробной скидкой.
- Настроить скидку на товары разных категорий. Передайте в метод
Create discount promotion for item илиUpdate item promotion массив объектов с артикулами нужных товаров.
- Настроить скидку на отдельные DRM для игры. Передайте в метод
Create discount promotion for item илиUpdate item promotion массив объектов с артикулами нужных DRM.
- Настроить бессрочную акцию. Передайте в метод
Create discount promotion for item илиUpdate item promotion параметр“date_end”:null
.
Кастомизация условий скидочной акции
Вы можете настроить скидку, которая применяется при выполнении различных условий, например:
- скидка с условием на сумму корзины;
- скидка с условием на количество товаров в корзине;
- скидка на один товар при покупке другого.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.