> ## 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ée)

> Démarrage rapide de PlayFab Legacy Economy (v1) couvrant la configuration initiale du catalogue, la configuration de la monnaie virtuelle et la création de base d'articles et de boutiques.

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

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

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

Dans ce démarrage rapide, vous allez :

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

## Configuration d'une monnaie virtuelle

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

Les articles 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 offre à votre jeu la flexibilité nécessaire pour 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é dans l'image ci-dessous) :
   * Définissez **Currency code (2 uppercase characters)** sur **GD**.
   * Définissez **Display name** sur **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 article" 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 articles du catalogue.

## Création d'un article

De nombreux jeux proposent au joueur des articles à acheter, comme un bouclier, le déverrouillage d'un niveau ou un bonus. Ces articles sont spécifiés dans un catalogue. Avant que le joueur puisse acheter un article dans un catalogue, vous devez créer les articles qui le composent.

Pour créer un catalogue contenant un article :

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

2. Choisissez le bouton **NEW CATALOG** et saisissez **main** comme **Catalog version**. Un article avec l'ID **One** est ajouté automatiquement.

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

   * Définissez **Item ID** sur **apple**.
   * Définissez **Display name** sur **apple**.
   * Définissez **Description** sur **Perfectly normal apple**.

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

5. Définissez le prix de la pomme en or (**GD**) sur **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 article à 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'articles :

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

**Ajoutez un article à 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. (Pour plus d'informations si nécessaire, consultez [Donner de la monnaie virtuelle à un joueur](/fr/services/playfab/economy-monetization/economy/items/quickstart#giving-virtual-currency-to-a-player).)

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 une **apple** au prix de **5** **GD**.

4. Appelez [PurchaseItem](xref:titleid.playfabapi.com.client.playeritemmanagement.purchaseitem) pour acheter l'**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 articles de l'`Inventory` du joueur, vous devriez voir une pomme !

## Étapes suivantes pour personnaliser votre économie

Une fois que vous disposez d'un catalogue contenant des articles pris en charge par des monnaies virtuelles, vous pouvez enrichir votre économie avec :

* **Les achats réels** : nos tutoriels [Prise en main de PlayFab, Unity IAP et Android](/fr/services/playfab/economy-monetization/economy/tutorials/getting-started-with-unity-iap-android) et [Traitement des paiements sans reçu](/fr/services/playfab/economy-monetization/economy/tutorials/non-receipt-payment-processing) vous aident à connecter votre économie virtuelle aux boutiques existantes.
* **L'exploitation de votre catalogue** : pour créer des bundles, des conteneurs et des tables de butin. Pour plus d'informations, consultez notre tutoriel [Catalogues](/fr/services/playfab/economy-monetization/economy/items/catalogs).
* **L'utilisation des attributs d'articles** : pour définir plusieurs prix et spécifier des [articles](/fr/services/playfab/economy-monetization/economy/items) empilables, échangeables et en édition limitée.
* **La configuration de vendeurs en jeu uniques ou d'événements de vente** : à l'aide de [Boutiques et ventes](/fr/services/playfab/economy-monetization/economy/tutorials/stores-and-sales).
* **La création de segments de joueurs et l'utilisation de boutiques** : pour proposer différentes offres d'articles et de bundles à vos joueurs, quel que soit leur stade dans le cycle de vie de votre jeu. Pour un exemple, consultez notre tutoriel [Boutiques personnalisées pour les segments de joueurs](/fr/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments).
* **La collecte de données économiques** : pour vous permettre d'améliorer et de faire évoluer votre jeu à l'aide des [rapports](/fr/services/playfab/data-analytics/learn-data/reports/overview) PlayFab.


## Related topics

- [Démarrage rapide des articles (Economy héritée)](/fr/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Démarrage rapide des boutiques (Economy héritée)](/fr/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [Démarrage rapide des monnaies virtuelles Economy v2](/fr/services/playfab/economy-monetization/economy-v2/tutorials/currencies.md)
- [Démarrage rapide](/fr/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Vue d'ensemble des paramètres d'Economy v2](/fr/services/playfab/economy-monetization/economy-v2/settings.md)
