# Основная информация

Акции — это маркетинговый инструмент для привлечения внимания потенциальных пользователей к товару и повышения уровня продаж. Используя Xsolla API, вы можете настроить следующие акции:

* Скидки — сниженная цена на выбранные товары.
* Бонусы — товары, которые начисляются пользователю вместе с покупкой другого товара.
* Купоны — коды, при вводе которых пользователю начисляется один или несколько бонусных товаров.
* Промокоды — коды, которые позволяют пользователю получить бонусный товар, скидку на определенный товар или на всю корзину. В отличие от купонов, промокоды погашаются не в момент ввода кода, а при совершения покупки.
* Уникальные предложения — скрытые товары, которые отображаются в каталоге пользователям, которые ввели код уникального предложения. Если код не введен, товары не отображаются.

Сценарий настройки акции на примере скидочной акции:
1. Создайте товары с помощью методов подраздела **Admin** из группы [Виртуальные предметы и валюта](/ru/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/), [Бандлы](/ru/api/catalog/bundles-admin/admin-create-bundle) или [Игровые ключи](/ru/api/catalog/game-keys-admin).
2. Создайте акцию с помощью метода [Создание акции со скидками для товара](/ru/api/liveops/promotions-discounts/create-item-promotion/). В массиве `items` передайте артикулы нужных товаров.
3. Настройте периоды действия акции. Для этого вызовите метод [Создание акции со скидками для товара](/ru/api/liveops/promotions-discounts/create-item-promotion/) или [Обновление акции со скидками](/ru/api/liveops/promotions-discounts/update-item-promotion/) и передайте в нем поле `promotion_periods` с массивом объектов с датами, где `date_from` — начало периода действия акции, а `date_until` — окончание.
4. Активируйте акцию с помощью метода [Обновление акции со скидками](/ru/api/liveops/promotions-discounts/update-item-promotion/). Передайте в нем параметр `"is_enabled": true`.
5. Чтобы получать информацию о ценах на товары, включая цены со скидкой, используйте клиентские методы API для получения каталога товаров из подразделов [Общие > Catalog](/ru/api/catalog/tag/common-catalog/), [Виртуальные предметы и валюта > Catalog](/ru/api/catalog/virtual-items-currency-catalog/get-virtual-items/), [Бандлы > Catalog](/ru/api/catalog/bundles-catalog/get-bundle-list/).

![Пример настройки акции](https://cdn.xsolla.net/developers/current/images/api_docs/promo-overview.svg)

Подробная информация о работе с каждым видом акций приведена в документации:
* [Скидки](https://developers.xsolla.com/ru/liveops/promotion-tools/discounts/)
* [Бонусы](https://developers.xsolla.com/ru/liveops/promotion-tools/bonuses/)
* [Купоны](https://developers.xsolla.com/ru/liveops/promotion-tools/coupons/)
* [Промокоды](https://developers.xsolla.com/ru/liveops/promotion-tools/promo-codes/)
* [Уникальное предложение каталога](https://developers.xsolla.com/ru/liveops/promotion-tools/unique-offer/)

