> ## 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.
# Suivi des prix en argent réel dans Economy v2
> Définissez RealMoneyPriceDetails sur les ensembles PlayFab Economy v2 et suivez les revenus au moyen de l'événement marketplace_transaction_redeemed pour la production de rapports analytiques.
Economy v2 est maintenant en disponibilité générale. Pour obtenir du soutien et donner votre avis, rendez-vous sur le [forum PlayFab](https://community.playfab.com).
Lorsque les joueurs achètent des objets dans des places de marché externes (Apple App Store, Google Play, Steam, Microsoft Store, Nintendo eShop, PlayStation Store), la transaction implique de l'argent réel. En configurant `RealMoneyPriceDetails` sur les ensembles de votre catalogue, PlayFab enregistre le montant du revenu dans l'événement [marketplace\_transaction\_redeemed](/fr-CA/services/playfab/api-references/events/Inventory/marketplace-transaction-redeemed), ce qui vous permet de créer des analyses et des rapports sur les revenus.
Ce tutoriel vous guide dans le flux complet : définir des prix en argent réel sur un ensemble, échanger un achat et consulter les données de revenus dans les événements.
## Prérequis
* Un [compte de développeur PlayFab](https://developer.playfab.com/en-us/sign-up).
* Un titre créé dans [Game Manager](https://developer.playfab.com/).
* Une intégration de place de marché déjà configurée (par exemple, [Google](/fr-CA/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/google), [Apple](/fr-CA/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/apple) ou [Microsoft Store](/fr-CA/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/microsoft)).
* Un ensemble publié avec un [mappage de place de marché](/fr-CA/services/playfab/economy-monetization/economy-v2/catalog/bundles) qui le lie à un produit de la place de marché.
## Étape 1 : Définir des prix en argent réel sur votre ensemble
Ajoutez `RealMoneyPriceDetails` à l'ensemble lié à votre produit de place de marché. Indiquez les prix dans la **plus petite unité monétaire** (par exemple, en cents pour l'USD) pour chaque place de marché.
### API
Utilisez [UpdateDraftItem](https://learn.microsoft.com/en-us/rest/api/playfab/economy/catalog/update-draft-item) pour ajouter des prix à un ensemble existant, puis publiez-le :
```json theme={null}
{
"Item": {
"Id": "{{StarterPackBundleID}}",
"Type": "bundle",
"Title": {
"NEUTRAL": "Starter Pack"
},
"ItemReferences": [
{
"Id": "{{LaserSwordID}}",
"Amount": 1
},
{
"Id": "{{GoldCurrencyID}}",
"Amount": 500
}
],
"RealMoneyPriceDetails": {
"GooglePlayPrices": {
"USD": 499
},
"AppleAppStorePrices": {
"USD": 499
},
"MicrosoftStorePrices": {
"USD": 499
}
},
"AlternateIds": [
{
"Type": "GooglePlay",
"Value": "com.mygame.starterpack"
},
{
"Type": "AppleAppStore",
"Value": "com.mygame.starterpack"
},
{
"Type": "MicrosoftStore",
"Value": "9NBLGGH42CFD"
}
]
},
"Publish": true
}
```
### Game Manager
1. Accédez à **Economy** > **Catalog (V2)** > **Bundles**.
2. Sélectionnez l'ensemble à modifier.
3. Dans la section **Prices**, définissez le prix en argent réel pour chaque place de marché où l'ensemble apparaît.
4. Assurez-vous que la section **Marketplace Mapping** contient les AlternateIds appropriés pour chaque place de marché.
5. Sélectionnez **Save and publish**.
***
### Référence du format des prix
Les prix utilisent la plus petite unité monétaire. Seul le **USD** est actuellement pris en charge.
| Prix réel | Valeur du dictionnaire |
| - | - |
| 0,99 \$ | `{"USD": 99}` |
| 1,39 \$ | `{"USD": 139}` |
| 4,99 \$ | `{"USD": 499}` |
| 9,99 \$ | `{"USD": 999}` |
| 19,99 \$ | `{"USD": 1999}` |
Définissez des prix uniquement pour les places de marché qu'utilise votre titre. Les propriétés de place de marché prises en charge sont :
* `AppleAppStorePrices`
* `GooglePlayPrices`
* `MicrosoftStorePrices`
* `NintendoEShopPrices`
* `PlayStationStorePrices`
* `SteamPrices`
### Prix différents selon la place de marché
Si le prix de votre jeu varie d'un magasin à l'autre, définissez chaque propriété de place de marché individuellement :
```json theme={null}
"RealMoneyPriceDetails": {
"GooglePlayPrices": {
"USD": 499
},
"AppleAppStorePrices": {
"USD": 529
},
"SteamPrices": {
"USD": 449
}
}
```
## Étape 2 : Le joueur effectue un achat et l'échange
Après qu'un joueur a acheté l'objet dans la place de marché externe, votre jeu appelle l'API d'échange appropriée :
| Place de marché | API d'échange |
| - | - |
| Google Play | [RedeemGooglePlayInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-google-play-inventory-items) |
| Apple App Store | [RedeemAppleAppStoreInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-apple-app-store-inventory-items) |
| Microsoft Store | [RedeemMicrosoftStoreInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-microsoft-store-inventory-items) |
| Steam | [RedeemSteamInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-steam-inventory-items) |
| Nintendo eShop | [RedeemNintendoEShopInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-nintendo-e-shop-inventory-items) |
| PlayStation Store | [RedeemPlayStationStoreInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-play-station-store-inventory-items) |
Lorsque PlayFab traite l'échange, il :
1. Associe le reçu de la place de marché à l'`AlternateId` de l'ensemble.
2. Accorde le contenu de l'ensemble à l'inventaire du joueur.
3. Émet un événement `marketplace_transaction_redeemed` qui inclut les `RealMoneyPrices` de l'ensemble correspondant.
## Étape 3 : Consulter les revenus dans les événements
Après un échange réussi, l'événement `marketplace_transaction_redeemed` est émis et inclut les données de prix en argent réel. Vous pouvez trouver cet événement dans Game Manager ou l'interroger au moyen du pipeline de données.
### Consulter dans Game Manager
1. Accédez à **Data** > **Event History** (dans la section **Analyze**).
2. Recherchez le nom d'événement `marketplace_transaction_redeemed`.
3. Sélectionnez un événement pour en afficher les détails, y compris le champ `RealMoneyPrices`.
### Exemple de charge utile d'événement
Un échange Google Play du Starter Pack (4,99 \$ USD) produit un événement comme celui-ci :
```json theme={null}
{
"EventName": "marketplace_transaction_redeemed",
"Marketplace": "GooglePlay",
"MarketplaceTransctionId": "GPA.1234-5678-9012-34567",
"MarketplaceAlternateId": "com.mygame.starterpack",
"Amount": 1,
"ItemId": "{{StarterPackBundleID}}",
"ItemType": "bundle",
"RealMoneyPrices": {
"USD": 499
}
}
```
Le même ensemble échangé dans l'Apple App Store (au prix de 5,29 \$ USD) produit :
```json theme={null}
{
"RealMoneyPrices": {
"USD": 529
}
}
```
PlayFab utilise le prix de la place de marché précise où l'échange a eu lieu.
### Interroger les données de revenus
Vous pouvez utiliser les données d'événement pour des analyses personnalisées. Par exemple, pour calculer le revenu total sur une période, interrogez tous les événements `marketplace_transaction_redeemed` et additionnez les valeurs `RealMoneyPrices.USD` :
```text theme={null}
Total revenue = Sum of (RealMoneyPrices.USD × Amount) across all events
```
`RealMoneyPrices` reflète ce que vous avez configuré dans `RealMoneyPriceDetails`, et non le montant réellement facturé par la place de marché. Gardez vos prix synchronisés avec vos fiches de place de marché pour obtenir des rapports exacts.
## Meilleures pratiques
* **Définissez toujours `RealMoneyPriceDetails` sur les ensembles de place de marché.** Sans cela, le champ `RealMoneyPrices` des événements d'échange est vide et vous perdez la visibilité sur vos revenus.
* **Utilisez la plus petite unité monétaire.** Pour l'USD, indiquez le prix en cents (par exemple, `499` pour 4,99 \$).
* **Remplissez uniquement les places de marché que vous utilisez.** Vous n'avez pas besoin de définir des prix pour toutes les places de marché, seulement pour celles où votre titre est publié.
* **Gardez vos prix synchronisés avec vos fiches de place de marché.** Lorsque vous mettez à jour des prix dans une place de marché externe, mettez à jour la propriété correspondante dans `RealMoneyPriceDetails` pour conserver des rapports exacts.
* **Définissez des prix par place de marché lorsqu'ils diffèrent.** Si le prix de votre jeu varie d'un magasin à l'autre, utilisez les propriétés propres à chaque place de marché pour refléter le prix réel sur chaque plateforme.
## Voir aussi
* [Référence des prix en argent réel](/fr-CA/services/playfab/economy-monetization/economy-v2/catalog/real-money-prices)
* [Ensembles d'Economy v2](/fr-CA/services/playfab/economy-monetization/economy-v2/catalog/bundles)
* [Démarrage rapide de la prévention de la fraude](/fr-CA/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart)
* [Intégrations de places de marché](/fr-CA/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/overview)
* [Événement marketplace\_transaction\_redeemed](/fr-CA/services/playfab/api-references/events/Inventory/marketplace-transaction-redeemed)
## Related topics
- [Prix en argent réel dans Economy v2](/fr-CA/services/playfab/economy-monetization/economy-v2/catalog/real-money-prices.md)
- [FAQ sur Economy version 2 (V2)](/fr-CA/services/playfab/economy-monetization/economy-v2/faq.md)
- [Magasins et soldes dans Economy (Legacy)](/fr-CA/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [Prise en main d'Economy v2, d'Unity IAP et d'Android](/fr-CA/services/playfab/economy-monetization/economy-v2/tutorials/getting-started-with-unity-and-android.md)
- [Vue d'ensemble du catalogue](/fr-CA/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview.md)