# Aperçu

Les promotions sont des outils marketing conçus pour attirer de nouveaux utilisateurs et augmenter les ventes. Avec l'API Xsolla, vous pouvez configurer les promotions suivantes :

* Réductions — prix réduits sur des objets sélectionnés.
* Bonus — objets accordés aux utilisateurs lors d'un achat.
* Coupons — codes permettant aux utilisateurs d'obtenir un ou plusieurs objets bonus lors de leur utilisation.
* Codes promo — codes permettant aux utilisateurs d'obtenir des objets bonus, une remise sur un objet spécifique ou une remise sur l'ensemble du panier. Contrairement aux coupons, qui sont utilisés après avoir été saisis par l'utilisateur, les codes promo s'appliquent lors de l'achat, au moment du paiement.
* Offres uniques — objets cachés affichés dans le catalogue uniquement aux utilisateurs ayant saisi un code d'offre unique. Sans ce code, les objets ne sont pas affichés.

Exemple de flux de configuration d'une promotion par réduction :
1. Créez des objets en utilisant les appels de la sous-section **Administrateur** des groupes [Objets et devises virtuels](/fr/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/), [Lots](/fr/api/catalog/bundles-admin/admin-create-bundle), ou [Clés de jeu](/fr/api/catalog/game-keys-admin).
2. Créez une promotion en utilisant l'appel [Créer une promotion par réduction pour un objet](/fr/api/liveops/promotions-discounts/create-item-promotion/). Dans le tableau `items`, passez les UGS des objets nécessaires.
3. Configurez les périodes de validité de la promotion. Pour ce faire, appelez les méthodes [Créer une promotion par réduction pour un objet](/fr/api/liveops/promotions-discounts/create-item-promotion/) ou [Mettre à jour la promotion pour un objet](/fr/api/liveops/promotions-discounts/update-item-promotion/), et passez le champ `promotion_periods` comme un tableau d'objets où `date_from` définit la date de début et `date_until` définit la date de fin de la période de validité.
4. Activez la promotion en utilisant l'appel [Mettre à jour la promotion sur les objets](/fr/api/liveops/promotions-discounts/update-item-promotion/). Passez le paramètre `"is_enabled": true`.
5. Pour obtenir des informations sur les prix des objets, y compris les prix réduits, appelez les méthodes API client de récupération du catalogue des objets à partir des sous-sections [Common > Catalog](/fr/api/catalog/tag/common-catalog/), [Virtual Items and Currency > Catalog](/fr/api/catalog/virtual-items-currency-catalog/get-virtual-items/), et [Bundles > Catalog](/fr/api/catalog/bundles-catalog/get-bundle-list/).

![Exemple de configuration de promotion](https://cdn.xsolla.net/developers/current/images/api_docs/promo-overview.svg)

Consultez notre documentation pour obtenir des informations détaillées sur la configuration des promotions :
* [Réductions](https://developers.xsolla.com/fr/liveops/promotion-tools/discounts/)
* [Bonus](https://developers.xsolla.com/fr/liveops/promotion-tools/bonuses/)
* [Coupons](https://developers.xsolla.com/fr/liveops/promotion-tools/coupons/)
* [Codes promo](https://developers.xsolla.com/fr/liveops/promotion-tools/promo-codes/)
* [Offres de catalogue uniques](https://developers.xsolla.com/fr/liveops/promotion-tools/unique-offer/)