> ## 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 Economy (hérité) depuis Game Manager, et associez-les à des lots 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 plus de nouvelles fonctionnalités, uniquement des correctifs de bogues. **Les API v1 seront maintenues dans un avenir prévisible.** Consultez la [vue d'ensemble d'Economy v2](/fr/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 que vos clients les utilisent afin d'obtenir des objets d'inventaire dans leur jeu. Combinés à des lots ou à CloudScript, ces coupons peuvent servir à déclencher pratiquement n'importe quelle fonctionnalité de votre jeu.

## Configuration requise

* Connaître les [catalogues](/fr/services/playfab/economy-monetization/economy/items/catalogs), les lots et les conteneurs.
* Connaître [Game Manager](/fr/services/playfab/live-service-management/gamemanager).
* Connaître l'[inventaire du joueur](/fr/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 **titre**.
* Sélectionnez **Economy** dans le menu de gauche.
* Accédez à 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 - Objets 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 objet de la section. Si vous souhaitez créer des coupons pour un objet spécifique :

* Sélectionnez **Coupons** dans l'onglet **Items**.
* **Coupons** de lot sous **Bundles**, et **Coupons** de conteneur sous **Containers**.

La fenêtre contextuelle est similaire à celle présentée ci-dessous. (Votre liste d'objets doit correspondre à votre titre. Les objets affichés sont décrits dans notre tutoriel [Tables de butin](/fr/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 alors ê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 fournissez une interface graphique qui lui permet de saisir 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'objet d'inventaire

La façon la plus simple d'utiliser des coupons consiste à offrir un objet d'inventaire. Une fois votre catalogue créé, vous pouvez générer des coupons pour des objets standard 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 de plusieurs objets

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

Cependant, les lots peuvent servir à convertir de manière transparente des objets d'inventaire en groupes d'objets ou en monnaie virtuelle. Dans l'exemple de la monnaie virtuelle, vous devez créer un nouvel objet de type lot dont le contenu est de la monnaie virtuelle.

Configurez le lot pour qu'il expire au bout de **15 secondes**. Ainsi, le joueur verra immédiatement la monnaie virtuelle dès qu'il ouvrira le lot, sans voir l'objet 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 lot de catalogue" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-edit-catalog-bundle.png" />

Le principe est le même pour plusieurs objets :

* Créez un lot contenant plusieurs objets, voire des [tables de butin](/fr/services/playfab/economy-monetization/economy/tutorials/drop-tables).
* Configurez-le pour qu'il expire au bout de **15 secondes**.
* Le coupon peut générer le lot.
* Le lot est ensuite converti en plusieurs objets.
* L'objet de lot intermédiaire disparaît.

## Scénarios d'utilisation

* Récompenses physiques lors de conventions :
  * Vous pouvez imprimer votre liste de codes de coupon et les distribuer comme goodies lors de conventions.
* Communication en dehors du jeu, comme les forums, les [notifications Push](/fr/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/quickstart) et l'e-mail.
  * Envoyez des codes de coupon *directement* à vos joueurs, dans le cadre de campagnes de réacquisition ou d'autres actions auprès de la communauté.
* Tournois :
  * Envoyez des coupons aux joueurs les mieux classés lorsque vous utilisez des [classements réinitialisables](/fr/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards).

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

## Meilleures pratiques

Avec l'inventaire PlayFab, vous devez conserver des tailles d'inventaire relativement petites, *moins de 100 objets au total* par joueur. Un lot accordant *trop d'objets* peut être limité ou soumis à une limitation de débit.


## Related topics

- [Magasins et soldes dans Economy (hérité)](/fr/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [Tables de butin dans Economy (hérité)](/fr/services/playfab/economy-monetization/economy/tutorials/drop-tables.md)
- [Consommables temporisés dans Economy (hérité)](/fr/services/playfab/economy-monetization/economy/tutorials/timed-consumables.md)
- [Gérer les monnaies virtuelles dans Economy (hérité)](/fr/services/playfab/economy-monetization/economy/tutorials/currencies.md)
- [FAQ d'Economy version 2 (V2)](/fr/services/playfab/economy-monetization/economy-v2/faq.md)