In-Game Store / Настройка акционных кампаний
  На главную

In-Game Store

Настройка акционных кампаний

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

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

Внимание
Вы можете использовать персонализированный каталог только вместе с продуктом Login.

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

  1. Настроить для текущего проекта атрибуты пользователя.
  2. Задать в разделе Login схему атрибутов пользователя.

Атрибуты — это характеристики пользователя, хранящиеся в виде пар ключ-значение. На основании атрибутов можно:

  • сегментировать пользователей;
  • подготавливать персональные витрины товаров для каждой группы пользователей в Web Shop.

Для обеспечения целостности передаваемых данных вы можете задать правила валидации атрибутов в виде JSON-схемы в Личном кабинете. Вы можете управлять атрибутами с помощью методов Login API или вебхуков. Значения атрибутов пользователей можно редактировать в Личном кабинете. Используйте инструкцию по настройке атрибутов пользователя.

Купон предназначен для предоставления пользователям бесплатных товаров. Заказывать товар или покупать корзину в этом случае не требуется. Купон содержит код, который пользователь вводит в игре, на сайте игры или в мобильном приложении игры. При применении купона пользователю в инвентарь начисляется вознаграждение. В качестве вознаграждения может использоваться:

Подробная информация доступна в разделе Купоны.

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

Подробная информация доступна в разделе Промокоды.

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

Скидочная акция дает возможность настроить скидку на один или несколько товаров. На один товар может действовать неограниченное количество скидочных акций. Скидки при этом не суммируются, а применяются к стоимости товара поочередно. Скидки могут действовать на следующие товары:

Подробная информация доступна в разделе Скидочные акции.

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

Кампания с купонами

Чтобы запустить кампанию с купонами:

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

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

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

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

  1. Проверьте настройки и нажмите кнопку Сохранить и выйти.

Примечание
Нельзя редактировать активные скидочные акции.

  1. Нажмите Store в боковом меню и перейдите в раздел Акции и награды.
  2. Выберите акцию, нажмите ••• и выберите Редактировать.

  1. Перейдите на вкладку Коды.
  2. Выберите тип генерации купонов.
  1. Сгенерируйте код купона или введите код вручную.
  2. Активируйте акцию.

Погашение купона по коду

Примечание
Для работы с Xsolla API вы можете использовать готовые методы SDK для игровых движков и платформ:

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

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

Copy
Full screen
Small screen
  • http
selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

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

Copy
Full screen
Small screen
  • 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
  }
  ]
}
  1. Если is_selectable=false, дополнительные параметры в запросе передавать не нужно.

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

Примечание
Для работы с Xsolla API вы можете использовать готовые методы SDK для игровых движков и платформ:

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

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

Copy
Full screen
Small screen
  • 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
  1. Если is_selectable=false, дополнительные параметры в запросе передавать не нужно.

Кампания с промокодами

Чтобы запустить кампанию с промокодами:

  1. Настройте акционную кампанию с промокодами.
  2. Реализуйте методы погашения промокода.
  3. Реализуйте методы награды по промокоду.

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

  1. Откройте проект в Личном кабинете.
  2. Нажмите Store в боковом меню и перейдите в раздел Акции и награды.

  1. Нажмите Создать акцию.

  1. Задайте необходимые параметры:
    1. Укажите название акции.
    2. Выберите тип Промокоды.
  2. Выберите, что пользователь получит после погашения промокода: ничего, скидку на все товары в корзине, на определенные товары; бонусный товар. Вы можете выбрать несколько вариантов.
  3. Укажите процент скидки по промокоду.
  4. Нажмите Далее.

  1. Укажите общее количество погашений и количество погашений для пользователя.
  2. Нажмите Далее.

  1. Укажите период действия акции.
  2. Нажмите Далее.

  1. Проверьте настройки и нажмите кнопку Сохранить и выйти.

Примечание
Нельзя редактировать активные скидочные акции.
  1. Нажмите Store в боковом меню и перейдите в раздел Акции и награды.
  2. Выберите акцию, нажмите ••• и выберите Редактировать.
  1. Перейдите на вкладку Коды.
  2. Выберите тип генерации промокодов.
  3. Сгенерируйте код купона или введите код вручную.
  1. Активируйте акцию.

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

Примечание
Для работы с Xsolla API вы можете использовать готовые методы SDK для игровых движков и платформ:

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

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

Copy
Full screen
Small screen
  • http
selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

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

Copy
Full screen
Small screen
  • 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
    }
    ]
}
  1. Если is_selectable=false, дополнительные параметры в запросе передавать не нужно.

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

Примечание
Для работы с Xsolla API вы можете использовать готовые методы SDK для игровых движков и платформ:

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

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

Copy
Full screen
Small screen
  • 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
  1. Если is_selectable=false, дополнительные параметры в запросе передавать не нужно.

Кампания с бонусами

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

Чтобы настроить акционную кампанию с бонусом:

  1. Откройте проект в Личном кабинете.
  2. Нажмите Store в боковом меню и перейдите в раздел Акции и награды.

  1. Нажмите Создать акцию.

  1. Задайте необходимые параметры:
    1. Укажите название акции.
    2. Выберите тип Бонус.
  2. Укажите акционные товары.

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

  1. Если вы хотите, чтобы акция распространялась только на пользователей, делающих первую покупку, установите переключатель Акция на первую покупку в положение Вкл. Переключатели Акция для определенных пользователей и Ограничивать использование акции пользователем будут включены автоматически, и будет создан набор условий срабатывания акции. Если необходимо, добавьте дополнительные условия.
  2. Нажмите Далее.

  1. Укажите период действия акции.
  2. Нажмите Далее.

  1. Проверьте настройки и нажмите кнопку Сохранить и выйти.

Примечание
Нельзя редактировать активные скидочные акции.

  1. Нажмите Store в боковом меню и перейдите в раздел Акции и награды.
  2. Выберите акцию, нажмите ••• и выберите Редактировать.

  1. Активируйте акцию.

Скидочная кампания

Примечание
На скидки нельзя настроить региональные ограничения.

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

Чтобы настроить акцию со скидкой:
  1. Откройте проект в Личном кабинете.
  2. Нажмите Store в боковом меню.

  1. Нажмите Акции и награды > Создать акцию.

  1. Задайте необходимые параметры:
    1. Укажите название акции.
    2. Выберите тип Скидка.
  2. Выберите один или несколько товаров, на которые будет распространяться скидка.
  3. Укажите процент скидки.
  4. Нажмите Далее.

  1. Если вы хотите, чтобы акция распространялась только на пользователей, делающих первую покупку, установите переключатель Акция на первую покупку в положение Вкл. Переключатели Акция для определенных пользователей и Ограничивать использование акции пользователем будут включены автоматически, и будет создан набор условий срабатывания акции. Если необходимо, добавьте дополнительные условия.
  2. Нажмите Далее.

  1. Укажите период действия акции.
  2. Нажмите Далее.

  1. Проверьте настройки и нажмите кнопку Сохранить и выйти.

Примечание
Нельзя редактировать активные скидочные акции.

  1. Нажмите Store в боковом меню и перейдите в раздел Акции и награды.
  2. Выберите акцию, нажмите ••• и выберите Редактировать.

  1. Активируйте акцию.

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

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

Чтобы создать акцию через методы API:

  1. Вызовите метод Создание акции со скидками для товара с необходимыми параметрами.
  2. Вызовите метод Обновление акции со скидками с параметром “is_enabled”:true, чтобы активировать акцию.

Чтобы отредактировать акцию через метод API, вызовите метод Обновление акции со скидками с новыми параметрами акции. Редактирование акции также доступно для акций со статусом Active.

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

Copy
Full screen
Small screen
  • json

"items": null
Copy
Full screen
Small screen
  • json

"items": [{
     “sku”: “strw2030”
  }, {
     “sku”: “strw4060”
  }, {
     “sku”: “cupred200”
  }
]
Copy
Full screen
Small screen
  • json

"discount": {
    “percent”: ”49.9”
}
Copy
Full screen
Small screen
  • json
"items": [{
     “sku”: “storm_shield”
  }, {
     “sku”: “heaven_crystals_pack_x500”
  },{
     “sku”: “strw2030”
  }
]
Copy
Full screen
Small screen
  • json
"items": [{
     “sku”: “brilliant_game_sku_steam”
  }
  ]
Copy
Full screen
Small screen
  • json

“date_end”: null
Copy
Full screen
Small screen
  • json
"attribute_conditions": [
{
"attribute": "has_purchase",
"operator": "eq",
"value": "0",
"type": "number"
}
],
"limits": {
"per_user": 1
}
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 25 ноября 2024

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

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