> ## 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 dans le jeu pour des éléments cosmétiques, des bonus ou d'autres éléments à usage limité. 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 tient au fait 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 racheter 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, chaque niveau ou quantité proposée du consommable étant 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 référence (SKU) distincte sous un même productId. Pour plus d'informations sur des scénarios spécifiques et sur le choix entre ces deux types de produits, consultez [Choix du type de produit approprié](/fr/publishing/xstore-commerce/xstore-choosing-product-type).

L'utilisation la plus courante des produits consommables consiste à implémenter 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 temporaires, des éléments cosmétiques, des améliorations ou d'autres éléments 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 éléments censés suivre le [Modèle de partage de produits pour les jeux](/fr/publishing/xstore-commerce/xstore-product-sharing).


## Bonnes pratiques pour proposer une monnaie du jeu

Lorsque vous proposez un écosystème de monnaie du jeu reposant sur des produits consommables, proposez au moins 3 à 6 niveaux d'offre dont la valeur augmente. Pour une efficacité maximale, 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 définir 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) plus un pourcentage bonus qui augmente à chaque niveau.

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 accorder 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 de niveaux de consommables avec valeur de base et montants bonus pour les niveaux supérieurs :

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

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

## Soldes et promotions de monnaie consommable du jeu

Si vous prévoyez d'organiser une promotion ou des soldes portant sur votre monnaie du jeu, les méthodes suivantes ont fait leurs preuves pour susciter l'intérêt des clients, leur offrir davantage de valeur et accroître les revenus pendant la promotion.

Vous pouvez appliquer une remise en pourcentage fixe sur les prix de tous les niveaux, mais proposer votre contenu de niveau supérieur avec un pourcentage de remise plus élevé génère davantage de revenus incrémentiels sur la durée de la promotion qu'une remise fixe. Par exemple, proposer une remise de 10 % sur le niveau le plus bas, puis jusqu'à 30 % sur le niveau le plus élevé, offre une excellente valeur aux utilisateurs, qui achètent alors en plus grand nombre l'option de niveau supérieur. Les soldes favorisent également une meilleure utilisation du jeu après la promotion, car 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'application de prix réduits sur les produits consommables rend également la promotion visible depuis l'application Store et contribue à stimuler l'engagement des utilisateurs. Pour planifier une promotion et une remise sur vos produits consommables, contactez votre représentant Microsoft afin d'obtenir des informations supplémentaires.

Vous pouvez également appliquer une remise sur les éléments 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é pour attirer de nouveaux utilisateurs serait plus limitée, selon la publicité et la communication externe.

## Configuration d'un produit consommable dans Partner Center

Lorsque vous créez 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, définissez le consommable sur *Dispose de sa propre description dans le Store* dans Configuration du consommable. Sinon, les utilisateurs ne peuvent accéder au consommable qu'à partir de l'interface de votre jeu.
* Pour les consommables gérés par le Microsoft Store, définissez le champ *Quantité* dans Propriétés sur la valeur ajoutée au solde de l'utilisateur à chaque achat du produit. 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 (voir [Gestion du solde de l'utilisateur sur votre service ou sur le Microsoft Store](/fr/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 du niveau à \$4.99 dans l'exemple de la section [Bonnes pratiques pour proposer une monnaie du jeu](#best-practices-for-offering-in-game-currency).
* Indiquez la monnaie de base et la monnaie bonus du produit dans le titre du produit (exemple : 500 (+100 en bonus) pièces)
* Les images du Store doivent inclure un visuel de la monnaie qui grandit ou représente un montant plus important pour les niveaux supérieurs (exemple : une pile de pièces qui grossit à mesure que le niveau augmente, ou des coffres au trésor remplis de pièces de taille croissante). Par ailleurs (ou en complément), les images du Store peuvent inclure un texte indiquant la quantité de monnaie accordée par le produit à l'achat (exemple : « 600 pièces » ou « 500 (+100 en bonus) »)

## Gestion des consommables

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

Vous pouvez également signaler un consommable comme traité ou consommer une quantité spécifique du solde de l'utilisateur sur le client du jeu à l'aide de l'API [XStoreReportConsumableFulfillmentAsync](/fr/reference/system/xstore/xstore_members). En cas d'appel depuis le client, nous vous recommandons d'utiliser le trackingId pour vous assurer que la requête est correctement traitée par 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 de validation de la consommation](/fr/publishing/xstore-commerce/xstore-managing-consumables#use-trackingids-as-a-redundant-system-for-consume-validation).

### Gestion des retours et remboursements de consommables

Pour aider à prévenir les abus et les retours/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 rétrofacturations à partir de votre service](/fr/publishing/xstore-commerce/xstore-managing-refunds).

## Documentation de référence des API

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

## Voir aussi

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

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

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

[Référence de l'API XStore](/fr/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)
