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

# Démarrage rapide d'Economy (hérité)

> Démarrage rapide de PlayFab Economy hérité (v1) couvrant la configuration initiale du catalogue, la configuration de la monnaie virtuelle et la création de base d'objets et de magasins.

# Démarrage rapide (Economy hérité)

<Info>
  Les API Economy v1 sont en mode maintenance et ne recevront aucune nouvelle fonctionnalité, seulement des correctifs de bogues. **Les API v1 seront maintenues dans un avenir prévisible.** Consultez la [vue d'ensemble d'Economy v2](/fr-CA/services/playfab/economy-monetization/economy-v2/overview) pour en savoir plus sur la prochaine version de PlayFab Economy!
</Info>

Faire fonctionner la monétisation est l'un des plus grands défis dans les jeux. PlayFab simplifie cette expérience en s'appuyant sur trois éléments fondamentaux : les monnaies, les objets et l'inventaire.

Dans ce démarrage rapide, vous allez :

1. Configurer une monnaie virtuelle.
2. Créer un objet.
3. Ajouter un objet à l'inventaire d'un joueur.
4. Découvrir les prochaines étapes pour personnaliser votre économie.

## Configuration d'une monnaie virtuelle

Les monnaies virtuelles sont le fondement des économies en jeu. Ces monnaies peuvent être accordées aux joueurs et aux personnages, qui peuvent ensuite les utiliser pour acheter ou échanger des objets.

Les objets peuvent avoir un coût en monnaie virtuelle ou en argent réel. Chaque titre peut prendre en charge plusieurs monnaies virtuelles arbitraires, ce qui donne à votre jeu la souplesse de mettre en œuvre n'importe quel moyen d'échange (par exemple, de l'or, des gemmes, des cœurs ou des crédits interstellaires).

Pour créer une monnaie virtuelle :

1. Ouvrez **Game Manager** et sélectionnez **Economy** dans la barre latérale gauche.
2. Sélectionnez l'onglet **Currency**.
3. Choisissez **New Currency** et modifiez ces champs (comme illustré ci-dessous) :
   * Réglez **Currency code (2 uppercase characters)** à **GD**.
   * Réglez **Display name** à **Gold**.
4. Sélectionnez **SAVE CURRENCY**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=fcf039d9e16ac42519f73544b6f3a8fd" alt="Créer un objet" width="1200" height="394" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png" />

Maintenant qu'une monnaie a été configurée, des prix correspondant à la monnaie virtuelle peuvent être attribués aux objets de catalogue.

## Création d'un objet

De nombreux jeux proposent aux joueurs des objets à acheter, comme un bouclier, le déverrouillage d'un niveau ou un bonus. Ces objets sont définis dans un catalogue. Avant que le joueur puisse acheter un objet dans un catalogue, vous devez créer les objets qui le composeront.

Pour créer un catalogue contenant un objet :

1. Sélectionnez **Economy** dans la barre latérale gauche, puis l'onglet **Catalogs**.

2. Choisissez le bouton **NEW CATALOG** et entrez **main** comme **Catalog version**. Un objet ayant l'ID **One** est ajouté automatiquement.

3. Sélectionnez **One** et modifiez ces champs (comme illustré ci-dessous) :

   * Réglez **Item ID** à **apple**.
   * Réglez **Display name** à **apple**.
   * Réglez **Description** à **Perfectly normal apple**.

4. La section **PRICES** se trouve au bas du formulaire.

5. Réglez le prix de la pomme en or (**GD**) à **5**.

6. Sélectionnez le bouton **SAVE ITEM**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/create-item.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=b07c6dc306edea1d41c9a4d73f5c3915" alt="Modifier ou enregistrer la monnaie" width="1280" height="1200" data-path="images/playfab/economy-monetization/economy/tutorials/create-item.png" />

## Ajout d'un objet à l'inventaire d'un joueur

Les API [Player Item Management (Server)](xref:titleid.playfabapi.com.server.playeritemmanagement) et [Player Item Management (Client)](xref:titleid.playfabapi.com.client.playeritemmanagement) de PlayFab prennent en charge de nombreuses stratégies d'achat d'objets :

* Argent réel
* Monnaie virtuelle
* Attributions d'objets déclenchées par l'achat d'un autre objet
* Coffres verrouillés (avec une clé pouvant être obtenue comme butin ou achetée) et déverrouillés
* Tables de résultats aléatoires
* Objets non achetables attribués en fonction d'événements payants ou gratuits dans un jeu
* Et d'autres scénarios, notamment avec [PlayFab CloudScript utilisant Azure Functions](/fr-CA/services/playfab/live-service-management/service-gateway/automation/cloudscript-af)

**Ajoutez un objet à l'inventaire d'un joueur en l'achetant avec de la monnaie virtuelle.**

1. Dans votre jeu, connectez-vous en tant que joueur ayant reçu de la monnaie virtuelle. (Au besoin, consultez [Donner de la monnaie virtuelle à un joueur](/fr-CA/services/playfab/economy-monetization/economy/items/quickstart#giving-virtual-currency-to-a-player) pour plus d'information.)

2. Appelez [GetCatalogItems](xref:titleid.playfabapi.com.client.title-widedatamanagement.getcatalogitems) avec le paramètre suivant dans la requête :
   * `CatalogVersion = "main"`

3. Vérifiez que le `Catalog` du résultat contient un objet **apple** au prix de **5** **GD**.

4. Appelez [PurchaseItem](xref:titleid.playfabapi.com.client.playeritemmanagement.purchaseitem) pour acheter l'objet **apple**, avec ces valeurs de paramètres dans la requête :

   * `CatalogVersion = "main"`
   * `ItemId = "apple"`
   * `VirtualCurrency  = "GD"`
   * `Price =  5`

5. Enfin, appelez [GetUserInventory](xref:titleid.playfabapi.com.client.playeritemmanagement.getuserinventory) et examinez le résultat de cette méthode. Dans le tableau des objets de l'`Inventory` du joueur, vous devriez voir une pomme!

## Prochaines étapes pour personnaliser votre économie

Une fois que vous disposez d'un catalogue contenant des objets appuyés par des monnaies virtuelles, vous pouvez enrichir votre économie avec :

* **Achats en argent réel** : Nos tutoriels [Prise en main de PlayFab, Unity IAP et Android](/fr-CA/services/playfab/economy-monetization/economy/tutorials/getting-started-with-unity-iap-android) et [Traitement des paiements sans reçu](/fr-CA/services/playfab/economy-monetization/economy/tutorials/non-receipt-payment-processing) vous aident à connecter votre économie virtuelle aux magasins existants.
* **Exploiter votre catalogue** : Pour créer des ensembles, des conteneurs et des tables de butin. Pour plus d'information, consultez notre tutoriel sur les [catalogues](/fr-CA/services/playfab/economy-monetization/economy/items/catalogs).
* **Utiliser les attributs d'objet** : Pour définir plusieurs prix et spécifier des [objets](/fr-CA/services/playfab/economy-monetization/economy/items) empilables, échangeables et en édition limitée.
* **Configurer des vendeurs uniques en jeu ou des événements de soldes** : À l'aide des [magasins et soldes](/fr-CA/services/playfab/economy-monetization/economy/tutorials/stores-and-sales).
* **Créer des segments de joueurs et utiliser des magasins** : Pour proposer différentes offres d'objets et d'ensembles à vos joueurs, peu importe où ils en sont dans le cycle de vie de votre jeu. Pour un exemple, consultez notre tutoriel [Magasins personnalisés pour des segments de joueurs](/fr-CA/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments).
* **Recueillir des données économiques** : Pour vous permettre d'améliorer et d'itérer votre jeu à l'aide des [rapports](/fr-CA/services/playfab/data-analytics/learn-data/reports/overview) PlayFab.


## Related topics

- [Démarrage rapide des objets (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Démarrage rapide des magasins (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [Démarrage rapide sur la monnaie virtuelle d'Economy v2](/fr-CA/services/playfab/economy-monetization/economy-v2/tutorials/currencies.md)
- [Démarrage rapide](/fr-CA/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Ensembles d'Economy v2](/fr-CA/services/playfab/economy-monetization/economy-v2/catalog/bundles.md)
