> ## 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.

# Écosystèmes basés sur les consommables

> Configurez et implémentez des produits consommables dans le Microsoft Store : écosystèmes de consommables durables, flux d'achat et de traitement, et suivi de l'inventaire.

Les produits consommables sont utiles pour implémenter une économie de jeu pour des articles cosmétiques, des bonus de puissance ou d'autres articles à usage limité dans un jeu. Le Microsoft Store prend en charge deux types de produits consommables :

* Consommables gérés par le Microsoft Store
* Consommables gérés par le développeur

La principale différence entre ces types de consommables est que les consommables gérés par le développeur doivent être signalés comme traités au Microsoft Store avant que l'utilisateur puisse acheter de nouveau ce consommable. Les consommables gérés par le Store peuvent être achetés et échangés autant de fois que l'utilisateur le souhaite sans que le consommable soit signalé comme traité. Le type recommandé et le plus couramment utilisé pour les produits de jeu est le consommable géré par le Store, où chaque niveau ou offre de quantité du consommable est configuré comme un produit distinct dans le Store. Cette configuration rend les produits consommables plus flexibles et plus faciles à gérer que si chaque niveau ou quantité était une SKU distincte sous un seul productId. Pour plus d'informations sur des scénarios précis et sur le choix entre ces deux types de produits, consultez [Choix du type de produit approprié](/fr-CA/publishing/xstore-commerce/xstore-choosing-product-type).

L'utilisation la plus courante des produits consommables est l'implémentation d'une monnaie premium dans le jeu. L'utilisateur achète ces produits avec de l'argent réel en échange d'une allocation de monnaie du jeu. Cette monnaie est ensuite échangée dans le jeu contre des bonus de puissance temporaires, des articles cosmétiques, des améliorations ou d'autres articles liés au compte d'un seul utilisateur. Les consommables ne conviennent pas pour donner accès à des extensions, à des packs de cartes ou à d'autres articles censés suivre le [Modèle de partage de produits pour les jeux](/fr-CA/publishing/xstore-commerce/xstore-product-sharing).


## Meilleures pratiques pour offrir une monnaie de jeu

Lorsque vous offrez un écosystème de monnaie de jeu reposant sur des produits consommables, proposez de 3 à 6 niveaux d'offre ou plus dont la valeur augmente. Pour être le plus efficace possible, la valeur de chaque niveau, et en particulier la valeur ajoutée des niveaux supérieurs, doit être claire et compréhensible pour l'utilisateur final. Le niveau de base doit être peu coûteux et établir la valeur de base de la monnaie réelle par rapport à la monnaie du jeu. Vos niveaux de produits supérieurs doivent offrir la valeur de base de la monnaie du jeu (par rapport à leur prix) ainsi qu'un pourcentage de boni qui augmente à chaque niveau suivant.

Chaque niveau doit être configuré comme un produit consommable distinct dans Partner Center afin que les différents niveaux puissent être accordés au moyen de jetons d'échange 5x5, de prix promotionnels et de soldes. Cette configuration facilite également la gestion et le suivi des achats remboursés à l'aide du [service Clawback](#managing-returns-and-refunds-of-consumables)). Chaque produit consommable doit ajouter une quantité de `1` au solde de l'utilisateur; puis, lors de la consommation, votre service convertit cette quantité en montant équivalent de monnaie du jeu pour le productId.

Exemple de configuration des niveaux de consommables pour la valeur de base et les montants de boni des niveaux supérieurs :

| Prix | Monnaie de base | % de boni | Monnaie de boni | Nom du produit indiquant la valeur | ProductId |
| - | - | - | - | - | - |
| \$0.99 | 100 | | 0 | 100 pièces | 9NKR4W7BX2LP |
| \$4.99 | 500 | 10% | 50 | 500 (+50 en boni) pièces | 9NAF83QHT6MJ |
| \$9.99 | 1000 | 20% | 200 | 1000 (+200 en boni) pièces | 9N2VD5YRC8G1 |
| \$19.99 | 2000 | 30% | 600 | 2000 (+600 en boni) pièces | 9NHX7L4EWK9Q |
| \$39.99 | 4000 | 40% | 1600 | 4000 (+1600 en boni) pièces | 9NB3TM6FJ8ZA |
| \$79.99 | 8000 | 50% | 4000 | 8000 (+4000 en boni) pièces | 9NRW52CYP4DH |

Il est également recommandé d'inclure une petite allocation de votre monnaie de jeu pour les propriétaires de la passe de saison, les ensembles de jeux d'édition Deluxe et les abonnements mensuels, si votre titre les prend en charge. Si vous participez à Game Pass, votre titre peut offrir une allocation mensuelle de monnaie consommable aux abonnés actifs à titre d'avantage. Ces recommandations aident les utilisateurs à se familiariser avec la valeur et les avantages de votre économie de consommables.

## Soldes et promotions de la monnaie de jeu consommable

Si vous prévoyez d'organiser une promotion ou une solde portant sur votre monnaie de jeu, les méthodes suivantes ont fait leurs preuves pour mobiliser les clients, leur offrir une valeur accrue et augmenter les revenus pendant la promotion.

Vous pouvez offrir un pourcentage de rabais fixe sur le prix de tous les niveaux, mais offrir un pourcentage de rabais plus élevé sur vos niveaux supérieurs génère des revenus supplémentaires plus importants pendant la période promotionnelle qu'un rabais fixe. Par exemple, offrir un rabais de 10 % sur le niveau le plus bas, mais un rabais pouvant atteindre 30 % sur le niveau le plus élevé, procure une excellente valeur aux utilisateurs, qui achètent alors l'option de niveau supérieur en plus grand nombre. Les soldes favorisent également une meilleure utilisation du jeu après la solde, puisque les utilisateurs ont un intérêt direct dans le jeu en utilisant la monnaie consommable qu'ils ont achetée en grande quantité.

L'utilisation de prix réduits sur les produits consommables permet également de rendre la promotion visible dans l'application Store et contribue à stimuler l'engagement des utilisateurs. Pour planifier une promotion et un rabais sur vos produits consommables, communiquez avec votre représentant Microsoft pour obtenir de plus amples renseignements.

Vous pouvez aussi appliquer un rabais sur les articles du jeu que l'utilisateur achète avec votre monnaie consommable. L'avantage est de pouvoir configurer la promotion au moyen de vos propres services, sans coordination ni planification avec le Store ou les représentants Microsoft. Toutefois, la visibilité permettant d'attirer de nouveaux utilisateurs serait plus limitée et dépendrait de la publicité et des communications externes.

## Configuration d'un produit consommable dans Partner Center

Lors de la création d'un nouveau consommable pour votre titre dans Partner Center :

* Pour permettre aux utilisateurs de voir le produit et d'y accéder dans l'application Store et sur Xbox.com, configurez le consommable sur *Possède sa propre fiche dans le Store* sous Configuration du consommable. Sinon, les utilisateurs ne peuvent accéder au consommable qu'à partir de l'interface utilisateur de votre jeu.
* Pour les consommables gérés par le Microsoft Store, définissez le champ *Quantité* dans Propriétés à la valeur ajoutée au solde de l'utilisateur chaque fois que le produit est acheté. Si vous implémentez votre propre service pour suivre et gérer les consommables, nous recommandons une quantité par défaut de `1`, puis de convertir le montant équivalent de monnaie du jeu pour le produit multiplié par la quantité consommée. Pour plus d'informations, consultez [Gestion du solde de l'utilisateur sur votre service ou dans le Microsoft Store](/fr-CA/publishing/xstore-commerce/xstore-managing-consumables#managing-the-user-balance-on-your-service-vs-the-microsoft-store). Sinon, vous devez définir le montant total de monnaie du jeu que l'utilisateur obtient, par exemple « 600 » pour le produit de niveau \$4.99 dans l'exemple de la section [Meilleures pratiques pour offrir une monnaie de jeu](#best-practices-for-offering-in-game-currency).
* Indiquez la monnaie de base et la monnaie de boni du produit dans le titre du produit (p. ex., 500 (+100 en boni) pièces)
* Les images du Store doivent inclure une illustration de la monnaie qui grossit ou représente un montant plus élevé pour les niveaux supérieurs (par exemple, une pile de pièces qui grossit à chaque niveau ou des coffres au trésor remplis de pièces de taille croissante). Les images du Store peuvent aussi (ou en plus) inclure du texte indiquant la quantité de monnaie accordée par le produit à l'achat (par exemple, « 600 pièces » ou « 500 (+100 en boni) »)

## Gestion des consommables

La façon recommandée de gérer les consommables consiste à utiliser votre propre service de jeu personnalisé ou un fournisseur d'intergiciel qui prend en charge les API de service du Microsoft Store. Cette méthode offre une implémentation plus sécuritaire et plus flexible de votre économie de consommables. Pour plus d'informations, consultez [Gestion des produits consommables à partir de votre service](/fr-CA/publishing/xstore-commerce/xstore-managing-consumables).

Vous pouvez également signaler un consommable comme traité ou consommer une quantité précise du solde de l'utilisateur sur le client de jeu à l'aide de l'API [XStoreReportConsumableFulfillmentAsync](/fr-CA/reference/system/xstore/xstore_members). Si vous effectuez l'appel à partir du client, nous recommandons d'utiliser le trackingId pour vous assurer que la requête est correctement traitée dans les services du Microsoft Store avant d'accorder des avantages dans le jeu. Le fonctionnement des TrackingIds est décrit dans [Utiliser les TrackingIds comme système redondant pour la validation de la consommation](/fr-CA/publishing/xstore-commerce/xstore-managing-consumables#use-trackingids-as-a-redundant-system-for-consume-validation).

### Gestion des retours et des remboursements de consommables

Pour aider à prévenir les abus et les retours ou remboursements frauduleux de produits consommables, nous recommandons que votre service s'intègre au service d'événements Clawback. Votre service peut ainsi recevoir des événements lorsqu'un produit consommable est retourné ou remboursé à l'utilisateur, et il doit alors retirer de son côté la valeur ajoutée par le consommable.

Pour plus d'informations, consultez [Gestion des remboursements et des rétrofacturations à partir de votre service](/fr-CA/publishing/xstore-commerce/xstore-managing-refunds).

## Documentation de référence de l'API

* [XStore (contenu de l'API)](/fr-CA/reference/system/xstore/xstore_members)
  * Fonctions
    * [XStoreReportConsumableFulfillmentAsync](/fr-CA/reference/system/xstore/xstore_members)

## Voir aussi

[Vue d'ensemble du commerce](/fr-CA/publishing/xstore-commerce/xstore-commerce-overview)

[Gestion des produits consommables à partir de votre service](/fr-CA/publishing/xstore-commerce/xstore-managing-consumables)

[Gestion des remboursements et des rétrofacturations à partir de votre service](/fr-CA/publishing/xstore-commerce/xstore-managing-refunds)

[Référence de l'API XStore](/fr-CA/reference/system/xstore/xstore_members)


## Related topics

- [Exigences XBOX testées lors de la certification pour les jeux sur console XBOX](/fr-CA/publishing/certification/console-cert-tested-requirements.md)
- [XR-037 Dépendances envers les paquets de contenu](/fr-CA/publishing/certification/xr/xr-037.md)
- [Exigences XBOX pour les jeux XBOX](/fr-CA/publishing/certification/xbox-requirements.md)
- [XBOX Requirements pour les jeux XBOX](/fr/publishing/certification/xbox-requirements.md)
- [XR-037 Dépendances vis-à-vis des packages de contenu](/fr/publishing/certification/xr/xr-037.md)
