Скидочные акции

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

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

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

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

"price": {
  "amount": "2.3900000000000000",
  "amount_without_discount": "2.9900000000000000",
  "currency": "USD"
}

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

• Скидки настраиваются только в процентах, в диапазоне от 1 до 99.
• На скидочные акции нельзя настроить региональные ограничения.

Скидку можно настроить на неограниченное количество товаров, к одному товару можно применить неограниченное количество скидок.

Пользователь может увидеть информацию об акциях:

• при просмотре каталога игр;
• оформлении заказа.

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

Если вы создаете свою версию магазина, реализуйте отображение акций в каталоге на основании данных, полученных в методе Get games list. В ответе, кроме информации об игре, вы получите информацию об акциях:

• название;
• дата начала и окончания;
• размер скидки для акции с типом Скидка;
• цена товара со скидкой и без скидки для акции с типом Скидка;
• бонусный товар для акции с типом Бонус.

{
  "items": [
    {
      "sku": "game_1",
      "name": "Game name",
      "groups": [
        {
          "external_id": "all",
          "name": "All games"
        },
        {
          "external_id": "Xsolla",
          "name": "Xsolla games"
        }
      ],
      "type": "unit",
      "unit_type": "game",
      "description": "Game description",
      "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
      "attributes": {
        "$ref": "../examples/client-attribute-game.yaml#/value"
      },
      "promotions": [],
      "unit_items": [
        {
          "sku": "game_key_01",
          "type": "game_key",
          "is_free": false,
          "price": {
            "amount": "30.5",
            "amount_without_discount": "30.5",
            "currency": "USD"
          },
          "virtual_prices": [],
          "can_be_bought": true,
          "drm_name": "Steam",
          "drm_sku": "steam",
          "has_keys": true,
          "is_pre_order": true,
          "release_date": "2020-08-11T10:00:00+03:00"
        },
        {
          "sku": "game_key_02",
          "type": "game_key",
          "is_free": false,
          "price": {
            "amount": "30.5",
            "amount_without_discount": "30.5",
            "currency": "USD"
          },
          "virtual_prices": [],
          "can_be_bought": true,
          "drm_name": "Origin",
          "drm_sku": "origin",
          "has_keys": false,
          "is_pre_order": false,
          "release_date": null
        }
      ]
    },
    {
      "sku": "game_2",
      "name": "Game name",
      "groups": [
        {
          "external_id": "all",
          "name": "All games"
        }
      ],
      "type": "unit",
      "unit_type": "game",
      "description": "Game description",
      "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
      "attributes": [
        {
          "external_id": "OS",
          "name": "OS",
          "values": [
            {
              "external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
              "value": "Windows"
            }
          ]
        }
      ],
      "promotions": [],
      "unit_items": [
        {
          "sku": "game_key_01",
          "type": "game_key",
          "is_free": false,
          "price": {
            "amount": "30.5",
            "amount_without_discount": "30.5",
            "currency": "USD"
          },
          "virtual_prices": [],
          "can_be_bought": true,
          "drm_name": "Steam",
          "drm_sku": "steam",
          "has_keys": false,
          "is_pre_order": false,
          "release_date": null
        }
      ]
    }
  ]
}

При оформлении заказа пользователь увидит информацию о примененных акциях:

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

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

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

• через Личный кабинет;
• через методы API.

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

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

При настройке через Личный кабинет нельзя:

• настроить скидки с дробными процентами;
• настроить скидочные акции с бессрочным периодом действия;
• редактировать активные скидочные акции.

1. В разделе Store > Акции и награды в Личном кабинете нажмите кнопку Создать акцию.

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

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

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

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

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

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

• 3. В правом верхнем углу в раскрывающемся списке выберите Активировать акцию.

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

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

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

1. Вызовите метод Create discount promotion for item с необходимыми параметрами.
2. Вызовите метод Update item promotion с параметром “is_enabled”:true, чтобы активировать акцию.

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

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

• Настроить действие скидки на все товары проекта. Передайте в метод Create discount promotion for item или Update item promotion параметр “items”:null.

"items": null

• Настроить скидку на физические товары. Передайте в метод Create discount promotion for item или Update item promotion массив объектов с артикулами физических товаров.

"items": [{
     “sku”: “strw2030”
  }, {
     “sku”: “strw4060”
  }, {
     “sku”: “cupred200”
  }
]

• Настроить скидку с дробными процентами. Передайте в метод Create discount promotion for item или Update item promotion параметр discount.percent с дробной скидкой.

"discount": {
    “percent”: ”49.9”
}

• Настроить скидку на товары разных категорий. Передайте в метод Create discount promotion for item или Update item promotion массив объектов с артикулами нужных товаров.

"items": [{
     “sku”: “storm_shield”
  }, {
     “sku”: “heaven_crystals_pack_x500”
  },{
     “sku”: “strw2030”
  }
]

• Настроить скидку на отдельные DRM для игры. Передайте в метод Create discount promotion for item или Update item promotion массив объектов с артикулами нужных DRM.

"items": [{
     “sku”: “brilliant_game_sku_steam”
  }
  ]

• Настроить бессрочную акцию. Передайте в метод Create discount promotion for item или Update item promotion параметр “date_end”:null.

“date_end”: null

• Настроить предложение первой покупки. Для этого передайте в методе Create discount promotion for item или Update item promotion объект в массиве attribute_conditions:

"attribute_conditions": [
{
"attribute": "has_purchase",
"operator": "eq",
"value": "0",
"type": "number"
}
],
"limits": {
"per_user": 1
}

Кастомизация условий скидочной акции

• скидка с условием на сумму корзины;
• скидка с условием на количество товаров в корзине;
• скидка на один товар при покупке другого.