> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Coupons et promotions dans Economy (hérité)

> Générez et utilisez des coupons PlayFab Legacy Economy à partir de Game Manager, et associez-les à des ensembles ou à CloudScript pour alimenter des promotions dans le jeu.

# Coupons et promotions (Economy hérité)

<Info>
  Les API Economy v1 sont en mode maintenance et ne recevront aucune nouvelle fonctionnalité, seulement des correctifs de bogues. **Les API v1 seront maintenues dans un avenir prévisible.** Consultez la [vue d'ensemble d'Economy v2](/fr-CA/services/playfab/economy-monetization/economy-v2/overview) pour en savoir plus sur la prochaine version de PlayFab Economy!
</Info>

Les coupons sont des jetons de type chaîne que vous pouvez générer pour permettre à vos clients d'obtenir des articles d'inventaire dans leur jeu. Combinés à des ensembles ou à CloudScript, ces coupons peuvent servir à déclencher pratiquement n'importe quelle fonctionnalité de votre jeu.

## Exigences

* Connaissance des [catalogues](/fr-CA/services/playfab/economy-monetization/economy/items/catalogs), des ensembles et des conteneurs.
* Connaissance de [Game Manager](/fr-CA/services/playfab/live-service-management/gamemanager).
* Connaissance de l'[inventaire des joueurs](/fr-CA/services/playfab/player-progression/player-data/player-inventory).

## Instructions pour générer et utiliser des coupons

Tous les exemples qui suivent partagent la même première étape de base : la génération d'un coupon. Celle-ci s'effectue dans Game Manager.

Dans **Game Manager** :

* Accédez à votre **Title**.
* Sélectionnez **Economy** dans le menu de gauche.
* Allez à l'onglet **Catalogs**.

Dans chacune des trois sections d'onglet, **Items**, **Bundles** et **Containers**, se trouve un lien **Coupons**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-catalog-items-coupon-button.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=01c2a878fe4e703656b294f53ee70c21" alt="Game Manager - Economy - Articles de catalogue - Bouton Coupons" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-catalog-items-coupon-button.png" />

Ce lien ouvre une fenêtre qui vous permet de générer des coupons pour n'importe quel article de la section. Si vous souhaitez créer des coupons pour un article précis :

* Sélectionnez **Coupons** dans l'onglet **Items**.
* Les **Coupons** d'ensembles se trouvent sous **Bundles**, et les **Coupons** de conteneurs, sous **Containers**.

La fenêtre contextuelle ressemble à celle présentée ci-dessous. (Votre liste d'articles devrait correspondre à votre titre. Les articles affichés sont décrits dans notre tutoriel sur les [tables de butin](/fr-CA/services/playfab/economy-monetization/economy/tutorials/drop-tables).)

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-generate-coupons.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=ca852ef6cb03a6bc62d187fa93dca085" alt="Game Manager - Générer des coupons" width="1053" height="733" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-generate-coupons.png" />

Pour terminer la génération des coupons :

* Sélectionnez le nombre de **Coupons** à générer.

* Sélectionnez ensuite l'**Item** que les **Coupons** doivent générer.

* Le fichier texte **CSV** contenant la liste des **Coupons** peut ensuite être téléchargé.

La sélection de l'un des liens de l'exemple génère les dix **Coupons** suivants, séparés par des virgules.

```xml theme={null}
65g-d4q5-zph,ahs-aofk-5ip,rqp-pk6c-yuu,58d-64h9-a6q,zxk-jtmi-5a1,oeu-6e4z-365,mfy-euhb-qj3,ru9-r1ux-wzy,shj-54cm-5oh,719-7hxc-pzz
```

Enfin, le client peut utiliser un coupon si vous lui fournissez une interface graphique qui lui permet d'entrer le code, laquelle appelle ensuite [RedeemCoupon](xref:titleid.playfabapi.com.client.playeritemmanagement.redeemcoupon).

```csharp theme={null}
// Unity/C#
void UseCoupon(string couponCode)
{
    var primaryCatalogName = "TestCatalog-001"; // In your game, this should just be a constant matching your primary catalog
    var request = new RedeemCouponRequest
    {
        CatalogVersion = primaryCatalogName,
        CouponCode = couponCode // This comes from player input, in this case, one of the coupon codes generated above
    };
    PlayFabClientAPI.RedeemCoupon(request, LogSuccess, LogFailure);
}
```

### Exemple : coupon d'article d'inventaire

La façon la plus simple d'utiliser les coupons consiste à offrir un article d'inventaire. Une fois votre catalogue créé, vous pouvez générer des coupons pour des articles ordinaires en suivant les instructions précédentes. Aucune autre étape particulière n'est nécessaire dans ce cas.

### Exemple : coupon de monnaie virtuelle *ou* coupon d'articles multiples

Les coupons ne peuvent pas accorder directement de la [monnaie virtuelle](/fr-CA/services/playfab/economy-monetization/economy/tutorials/currencies), et ils ne peuvent accorder qu'un seul article.

Toutefois, les ensembles peuvent servir à convertir de façon transparente des articles d'inventaire en groupes d'articles ou en monnaie virtuelle. Dans l'exemple de la monnaie virtuelle (MV), vous devez créer un nouvel article de type ensemble dont le contenu est de la MV.

Configurez l'ensemble pour qu'il expire dans **15 secondes**. Ainsi, le joueur verra immédiatement la MV dès qu'il ouvrira l'ensemble, et il ne verra pas l'article intermédiaire.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-edit-catalog-bundle.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=1811ef16679c9be97687ef51cc436fc0" alt="Game Manager - Economy - Modifier un ensemble de catalogue" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-edit-catalog-bundle.png" />

Les articles multiples fonctionnent de la même façon :

* Créez un ensemble contenant plusieurs articles, ou même des [tables de butin](/fr-CA/services/playfab/economy-monetization/economy/tutorials/drop-tables).
* Configurez-le pour qu'il expire dans **15 secondes**.
* Le coupon peut générer l'ensemble.
* L'ensemble est ensuite converti en plusieurs articles.
* L'article d'ensemble intermédiaire disparaît.

## Scénarios d'utilisation

* Récompenses physiques lors de congrès :
  * Vous pouvez imprimer votre liste de codes de coupon et les distribuer comme articles promotionnels lors de congrès.
* Communications hors jeu, comme les forums, les [notifications Push](/fr-CA/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/quickstart) et les courriels.
  * Envoyez des codes de coupon *directement* à vos joueurs, dans le cadre de campagnes de reconquête ou d'autres initiatives communautaires.
* Tournois :
  * Envoyez des coupons aux joueurs les mieux classés lorsque vous utilisez des [classements réinitialisables](/fr-CA/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards).

<Note>
  Dans ce cas, vous pouvez également distribuer directement des articles d'inventaire; choisissez l'option la plus pertinente pour votre jeu.
</Note>

## Meilleures pratiques

Lorsque vous utilisez l'inventaire PlayFab, vous devriez garder la taille des inventaires relativement petite, soit *moins de 100 articles au total* par joueur. Un ensemble qui accorde *trop d'articles* pourrait être limité ou soumis à une limite de débit.


## Related topics

- [Catalogues (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/items/catalogs.md)
- [Objets (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/items/index.md)
- [Magasins (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/stores/index.md)
- [Tables de butin dans Economy (hérité)](/fr-CA/services/playfab/economy-monetization/economy/tutorials/drop-tables.md)
- [FAQ sur Economy version 2 (V2)](/fr-CA/services/playfab/economy-monetization/economy-v2/faq.md)