Скидочные акции
Как это работает
Скидочные акции — маркетинговый инструмент для привлечения внимания потенциальных клиентов к продукту и повышения уровня продаж.
Основные возможности:
- Настройка скидки на товар или несколько товаров.
- На один товар может действовать неограниченное количество скидочных акций.
- Создание каталога товаров с автоматическим расчетом цен товаров. Методы построения каталога возвращают для каждого товара объект
price
, в котором указаны цены товара с учетом действующих скидок и без них.
- json
1"price": {
2 "amount": "2.3900000000000000",
3 "amount_without_discount": "2.9900000000000000",
4 "currency": "USD"
5}
Ограничения:
- Скидки настраиваются только в процентах, в диапазоне от 1 до 99.
- На скидочные акции нельзя настроить региональные ограничения.
Скидку можно настроить на неограниченное количество товаров, к одному товару можно применить неограниченное количество скидок.
Для игры или списка игр можно настроить разные типы акций: скидки, купоны, промокоды и бонусы.
Если для игры или списка игр настроено несколько скидочных акций, которые действуют в момент покупки, скидки применяются к стоимости товара последовательно. Порядок применения скидок при этом не имеет значения.
Например:
Цена игрового ключа — $10. В Личном кабинете для игровых ключей созданы акции:
- скидочная акция Черная пятница с размером скидки 10% и периодом действия 4–30 ноября;
- скидочная акция Распродажа с размером скидки 20% и периодом действия 15 ноября — 15 декабря;
- акция с промокодом на скидку 5% и периодом действия 1–30 ноября.
20 ноября в момент покупки игрового ключа действуют обе скидочные акции и акция с промокодом.
Итоговая стоимость игрового ключа будет определена из расчета (($10 - 10%) - 20%) - 5% и составит $6,84.
Пользователь может увидеть информацию об акциях:
- при просмотре каталога игр;
- оформлении заказа.
Если для создания магазина вы используете Site Builder, в каталоге игр отображается размер скидки, зачеркнутая цена без скидки и цена со скидкой.

Если вы создаете свою версию магазина, реализуйте отображение акций в каталоге на основании данных, полученных в методе Получение списка игр. В ответе, кроме информации об игре, вы получите информацию об акциях:
- название;
- дата начала и окончания;
- размер скидки для акции с типом Скидка;
- цена товара со скидкой и без скидки для акции с типом Скидка;
- бонусный товар для акции с типом Бонус.
- json
1{
2 "items": [
3 {
4 "sku": "game_1",
5 "name": "Game name",
6 "groups": [
7 {
8 "external_id": "all",
9 "name": "All games"
10 },
11 {
12 "external_id": "Xsolla",
13 "name": "Xsolla games"
14 }
15 ],
16 "type": "unit",
17 "unit_type": "game",
18 "description": "Game description",
19 "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
20 "attributes": {
21 "$ref": "../examples/client-attribute-game.yaml#/value"
22 },
23 "promotions": [],
24 "unit_items": [
25 {
26 "sku": "game_key_01",
27 "type": "game_key",
28 "is_free": false,
29 "price": {
30 "amount": "30.5",
31 "amount_without_discount": "30.5",
32 "currency": "USD"
33 },
34 "virtual_prices": [],
35 "can_be_bought": true,
36 "drm_name": "Steam",
37 "drm_sku": "steam",
38 "has_keys": true,
39 "is_pre_order": true,
40 "release_date": "2020-08-11T10:00:00+03:00"
41 },
42 {
43 "sku": "game_key_02",
44 "type": "game_key",
45 "is_free": false,
46 "price": {
47 "amount": "30.5",
48 "amount_without_discount": "30.5",
49 "currency": "USD"
50 },
51 "virtual_prices": [],
52 "can_be_bought": true,
53 "drm_name": "Origin",
54 "drm_sku": "origin",
55 "has_keys": false,
56 "is_pre_order": false,
57 "release_date": null
58 }
59 ]
60 },
61 {
62 "sku": "game_2",
63 "name": "Game name",
64 "groups": [
65 {
66 "external_id": "all",
67 "name": "All games"
68 }
69 ],
70 "type": "unit",
71 "unit_type": "game",
72 "description": "Game description",
73 "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
74 "attributes": [
75 {
76 "external_id": "OS",
77 "name": "OS",
78 "values": [
79 {
80 "external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
81 "value": "Windows"
82 }
83 ]
84 }
85 ],
86 "promotions": [],
87 "unit_items": [
88 {
89 "sku": "game_key_01",
90 "type": "game_key",
91 "is_free": false,
92 "price": {
93 "amount": "30.5",
94 "amount_without_discount": "30.5",
95 "currency": "USD"
96 },
97 "virtual_prices": [],
98 "can_be_bought": true,
99 "drm_name": "Steam",
100 "drm_sku": "steam",
101 "has_keys": false,
102 "is_pre_order": false,
103 "release_date": null
104 }
105 ]
106 }
107 ]
108}
При оформлении заказа пользователь увидит информацию о примененных акциях:
- результат применения скидочной акции:
- размер скидки по акции;
- зачеркнутая цена без скидки;
- цена со скидкой.
- результат применения бонусной акции:
- бонусные товары;
- значение Free в строке цены для бонусных товаров.
- результат применения промокода:
- размер скидки по промокоду;
- зачеркнутая цена без скидки;
- цена со скидкой;
- бонусные товары;
- значение Free в строке цены для бонусных товаров.

Как настроить
Настройка скидочной акции
Вы можете настроить скидочные акции одним из следующих способов:- через Личный кабинет;
- через методы API.
Настройка через Личный кабинет
При настройке скидочных акций через Личный кабинет доступны следующие возможности:- настройка скидки с целочисленными процентами;
- настройка скидочных акций, действующих заданный период;
- настройка скидок, действующих на один или несколько пакетов игровых ключей для конкретных платформ.
- настроить скидки с дробными процентами;
- настроить скидочные акции с бессрочным периодом действия;
- редактировать активные скидочные акции.
Расширенные возможности для настройки скидочных акций доступны через методы API.
- В разделе Store > LiveOps и инструменты увеличения продаж в Личном кабинете нажмите кнопку Создать акцию.
- Задайте необходимые параметры:
- Укажите название акции.
- В поле Тип акции выберите Скидка.
- Установите процент скидки.
- Выберите тип товара.

- Выберите один или несколько товаров, на которые будет распространяться скидка.

- Нажмите Далее.
- При необходимости вы можете ограничивать количество использований акции. Для этого на странице Условия и ограничения установите переключатель Ограничивать использование акции пользователем в положение Вкл и введите необходимое число.
- Для настройки персонализированной акции установите переключатель Акция для определенных пользователей в положение Вкл. Чтобы настроить персонализацию, воспользуйтесь инструкцией.
- Нажмите Далее.
- Укажите период действия акции.
- Нажмите Далее.
- Проверьте настройки и нажмите кнопку Сохранить и выйти.

- Чтобы активировать акцию:
- В каталоге акций найдите только что созданную акцию.
- Нажмите на значок ••• и в раскрывающемся списке выберите Редактировать.
- В правом верхнем углу в раскрывающемся списке выберите Активировать акцию.

Настройка через методы API
Для работы со скидочными акциями используются методы подраздела Скидки из группы методов Акции.
Чтобы создать акцию через методы API:
- Вызовите метод Создание акции со скидками для товара с необходимыми параметрами.
- Вызовите метод Обновление акции со скидками с параметром
“is_enabled”:true
, чтобы активировать акцию.
Чтобы отредактировать акцию через метод API, вызовите метод Обновление акции со скидками с новыми параметрами акции. Редактирование акции также доступно для акций со статусом
При создании или редактировании скидочной акции через методы API вы также можете:
- Настроить действие скидки на все товары проекта. Передайте в метод Создание акции со скидками для товара или Обновление акции со скидками параметр
“items”:null
.
- json
1"items": null
- Настроить скидку на физические товары. Передайте в метод Создание акции со скидками для товара или Обновление акции со скидками массив объектов с артикулами физических товаров.
- json
1"items": [{
2 “sku”: “strw2030”
3 }, {
4 “sku”: “strw4060”
5 }, {
6 “sku”: “cupred200”
7 }
8]
- Настроить скидку с дробными процентами. Передайте в метод Создание акции со скидками для товара или Обновление акции со скидками параметр
discount.percent
с дробной скидкой.
- json
1"discount": {
2 “percent”: ”49.9”
3}
- Настроить скидку на товары разных категорий. Передайте в метод Создание акции со скидками для товара или Обновление акции со скидками массив объектов с артикулами нужных товаров.
- json
1"items": [{
2 “sku”: “storm_shield”
3 }, {
4 “sku”: “heaven_crystals_pack_x500”
5 },{
6 “sku”: “strw2030”
7 }
8]
- Настроить скидку на отдельные DRM для игры. Передайте в метод Создание акции со скидками для товара или Обновление акции со скидками массив объектов с артикулами нужных DRM.
- json
1"items": [{
2 “sku”: “brilliant_game_sku_steam”
3 }
4 ]
- Настроить бессрочную акцию. Передайте в метод Создание акции со скидками для товара или Обновление акции со скидками параметр
“date_end”:null
.
- json
1“date_end”: null
- Настроить предложение первой покупки. Для этого передайте в методе Создание акции со скидками для товара или Обновление акции со скидками объект в массиве
attribute_conditions
:
- json
1"attribute_conditions": [
2{
3"attribute": "has_purchase",
4"operator": "eq",
5"value": "0",
6"type": "number"
7}
8],
9"limits": {
10"per_user": 1
11}
Кастомизация условий скидочной акции
Вы можете настроить скидку, которая применяется при выполнении различных условий, например:- скидка с условием на сумму корзины;
- скидка с условием на количество товаров в корзине;
- скидка на один товар при покупке другого.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.