> ## 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 bundles PlayFab Economy v2 et suivez les revenus via l'événement marketplace_transaction_redeemed pour les rapports analytiques.
Economy v2 est désormais en disponibilité générale. Pour obtenir de l'aide et donner votre avis, rendez-vous sur le [forum PlayFab](https://community.playfab.com).
Lorsque les joueurs achètent des articles sur 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 bundles de votre catalogue, PlayFab enregistre le montant du revenu dans l'événement [marketplace\_transaction\_redeemed](/fr/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 tout au long du flux de bout en bout : définir des prix en argent réel sur un bundle, é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/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/google), [Apple](/fr/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/apple) ou [Microsoft Store](/fr/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/microsoft)).
* Un bundle publié avec un [mappage de place de marché](/fr/services/playfab/economy-monetization/economy-v2/catalog/bundles) le reliant à un produit de la place de marché.
## Étape 1 : Définir des prix en argent réel sur votre bundle
Ajoutez `RealMoneyPriceDetails` au bundle lié à votre produit de place de marché. Spécifiez les prix dans la **plus petite unité monétaire** (par exemple, les 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 bundle 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 le bundle à modifier.
3. Dans la section **Prices**, définissez le prix en argent réel pour chaque place de marché où le bundle apparaît.
4. Assurez-vous que la section **Marketplace Mapping** contient les AlternateIds corrects pour chaque place de marché.
5. Sélectionnez **Save and publish**.
***
### Référence du format de prix
Les prix utilisent la plus petite unité monétaire. Seul l'**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é utilisées par 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 diffère d'une boutique à 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
Une fois que le joueur a acheté l'article sur 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. Fait correspondre le reçu de la place de marché à l'`AlternateId` du bundle.
2. Accorde le contenu du bundle à l'inventaire du joueur.
3. Émet un événement `marketplace_transaction_redeemed` qui inclut les `RealMoneyPrices` du bundle 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 via le pipeline de données.
### Consulter dans Game Manager
1. Accédez à **Data** > **Event History** (sous la section **Analyze**).
2. Recherchez le nom d'événement `marketplace_transaction_redeemed`.
3. Sélectionnez un événement pour afficher ses 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 bundle échangé depuis 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é spécifique sur laquelle 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é. Maintenez vos prix synchronisés avec vos fiches sur les places de marché pour des rapports précis.
## Bonnes pratiques
* **Définissez toujours `RealMoneyPriceDetails` sur les bundles de place de marché.** Sans cela, le champ `RealMoneyPrices` des événements d'échange est vide et vous perdez la visibilité sur les revenus.
* **Utilisez la plus petite unité monétaire.** Pour l'USD, indiquez le prix en cents (par exemple, `499` pour 4,99 \$).
* **Renseignez uniquement les places de marché que vous utilisez.** Il n'est pas nécessaire de définir des prix pour toutes les places de marché, seulement pour celles sur lesquelles votre titre est publié.
* **Maintenez les prix synchronisés avec vos fiches sur les places de marché.** Lorsque vous modifiez des prix sur une place de marché externe, mettez à jour la propriété correspondante dans `RealMoneyPriceDetails` pour conserver des rapports précis.
* **Définissez des prix par place de marché lorsqu'ils diffèrent.** Si le prix de votre jeu diffère d'une boutique à l'autre, utilisez les propriétés par 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/services/playfab/economy-monetization/economy-v2/catalog/real-money-prices)
* [Bundles Economy v2](/fr/services/playfab/economy-monetization/economy-v2/catalog/bundles)
* [Démarrage rapide de la prévention de la fraude](/fr/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart)
* [Intégrations de places de marché](/fr/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/overview)
* [Événement marketplace\_transaction\_redeemed](/fr/services/playfab/api-references/events/Inventory/marketplace-transaction-redeemed)
## Related topics
- [Prix en argent réel dans Economy v2](/fr/services/playfab/economy-monetization/economy-v2/catalog/real-money-prices.md)
- [Magasins et soldes dans Economy (hérité)](/fr/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [Vue d'ensemble du catalogue](/fr/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview.md)
- [Conteneurs à contenu fixe dans Economy v2](/fr/services/playfab/economy-monetization/economy-v2/tutorials/containers-with-fixed-contents.md)
- [Bundles Economy v2](/fr/services/playfab/economy-monetization/economy-v2/catalog/bundles.md)