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

# Catalogues (Economy hérité)

> Créez et gérez des objets dans l'onglet Catalogs de PlayFab Economy hérité dans Game Manager, y compris les prix en monnaie virtuelle, les attributions et l'achat d'objets.

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

Ce tutoriel décrit l'onglet **Catalogs** de la section **Economy** dans **Game Manager**. Les catalogues servent à définir les objets que le joueur peut acheter ou que vous pouvez attribuer à un joueur.

## Qu'est-ce qu'un catalogue?

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 en unités de monnaie virtuelle ou d'argent réel. Les catalogues offrent un moyen simple de gérer les objets virtuels de votre jeu et peuvent contenir tous les objets offerts dans votre jeu.

Avant qu'un joueur puisse acheter un objet dans un catalogue, vous devez d'abord créer les objets.

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, notamment :

* Des achats simples d'objets en argent réel ou en monnaie virtuelle.
* Des attributions d'objets déclenchées par l'achat d'un autre objet.
* Des coffres verrouillés (avec une clé potentiellement achetable) et déverrouillés.
* Des tables de résultats aléatoires.
* Des objets non achetables attribués en fonction d'événements dans un jeu.

<Note>
  Dans les catalogues, le type de monnaie **RM** est réservé à l'**argent réel**, exprimé en cents USD. 1,99 \$ est représenté par **RM 199**.
</Note>

## Référence des champs

Cette section décrit chaque champ de la section **Catalogs** de la zone **Economy** dans **Game Manager**.

Lorsque vous créez un titre, vous n'avez aucun catalogue. Aucun champ n'apparaît dans la section **Catalogs** tant que vous n'avez pas créé un catalogue en sélectionnant le bouton **NEW CATALOG**.

Une fois un catalogue créé, les onglets suivants apparaissent dans la section **Catalogs** :

* **Items** - Éléments ayant une valeur en monnaie virtuelle ou en argent réel qui peuvent être achetés ou attribués. Pour plus d'information, consultez [Objets PlayFab](/fr-CA/services/playfab/economy-monetization/economy/items).
* **Bundles** - Collections d'objets et de monnaie virtuelle qui se décompressent dans l'inventaire du joueur lorsqu'elles sont attribuées.
* **Containers** - Collections d'objets et de monnaie virtuelle qui restent sous forme d'objet dans l'inventaire du joueur jusqu'à leur ouverture.
* **Drop Tables** - Collections d'objets et de monnaie virtuelle que vous pouvez utiliser pour récompenser les joueurs.
* **Stores** - Les magasins proposent un sous-ensemble d'objets du catalogue. Ces objets peuvent être offerts à des prix différents de ceux définis dans le catalogue. Pour plus d'information, consultez [Magasins PlayFab](/fr-CA/services/playfab/economy-monetization/economy/stores).

### Champs de New Catalog

Lorsque vous sélectionnez **NEW CATALOG** dans l'onglet principal **Catalogs**, la page suivante s'affiche :

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-new-catalog.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=61488a94ab1ec95a6311f29961ce7da4" alt="Game Manager - Economy - Catalogs - New Catalog" width="1280" height="2000" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-new-catalog.png" />

La page **New Catalog** (illustrée ci-dessus) contient les champs suivants :

* **Catalog version**
  Un champ *obligatoire*. Le nom de votre catalogue qui s'affiche dans l'onglet **Catalogs**.
* **Make primary catalog**
  Indique si le catalogue est le catalogue principal de votre jeu.

### Champs de New Catalog Item

Lorsque vous sélectionnez un **Catalog** et choisissez **NEW ITEM**, la page suivante s'affiche :

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-add-item.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=974c10b2f774db3364e1e8c17690dbc1" alt="Game Manager - Economy - Catalogs - New Catalog Item" width="1280" height="900" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-add-item.png" />

La page **New Catalog Item** (illustrée ci-dessus) contient les champs suivants :

* **PROPERTIES**
  * **Item ID** :
    Ce champ *obligatoire* est l'identificateur unique de l'objet dans le catalogue. L'ID d'objet doit être unique dans le catalogue, mais vous pouvez avoir plusieurs versions de catalogue contenant des objets ayant le même ID d'objet.
  * **Item Class** :
    Ce champ *facultatif* est un identificateur que vous pouvez utiliser pour faciliter la gestion des objets de votre catalogue.
  * **Tags** :
    Ce champ *facultatif* contient des étiquettes que vous pouvez utiliser pour organiser les objets de votre catalogue. Comme le nom du champ l'indique, les étiquettes sont des chaînes de texte séparées par des virgules.
  * **Item image URI** :
    Ce champ *facultatif* vous permet de fournir l'URI d'une image de l'objet.

* **OPTIONS**
  * **Is stackable** :
    Marquer un objet comme **Stackable** n'autorise qu'un seul objet de ce type dans l'inventaire et incrémente la quantité de l'objet.
  * **Is tradable** :
    Indique si l'objet peut être échangé au moyen des appels de l'API d'échange.
  * **Is a token for character creation** :
    Indique si l'objet intervient dans la création de personnages.

* **PRICES**
  * **Currency** :
    Indique la monnaie utilisée pour le coût de l'objet. L'argent réel (RM) est toujours disponible, car il est intégré à PlayFab.

  * **Amount** :
    Ce champ est *obligatoire* lorsqu'une monnaie est sélectionnée. Il indique le nombre d'unités de monnaie correspondant au coût de l'objet.

* **DISPLAYED TO PLAYERS**
  * **Display Name** :
    Ce champ *facultatif* est le nom affiché pour l'objet de catalogue. On l'utilise couramment lorsque vous souhaitez proposer l'objet dans votre magasin en jeu. Les noms d'affichage n'ont pas besoin d'être uniques.

  * **Description** :
    Ce champ *facultatif* est la description de l'objet de catalogue. On l'utilise couramment lorsque vous souhaitez proposer l'objet dans votre magasin en jeu.

* **LIMITED EDITION**
  * **Is limited edition** :
    Indique si la quantité disponible de cet objet est limitée.

* **CONSUMABLE**
  Indique si l'objet est **Durable** (durable) ou **Consumable** (consommable).

* **CONVERT TO** :
  Vous permet de convertir l'objet en ensemble ou en conteneur lors de son enregistrement.

* **CUSTOM DATA**
  Ce champ *facultatif* vous permet d'entrer des attributs pour l'objet sous forme de paires clé-valeur (KVP). Seule la clé est obligatoire pour chaque attribut. Les KVP peuvent être entrées sous forme de chaîne dans la zone de texte ou, si **EDIT AS KEY/VALUE PAIRS** est sélectionné, dans les champs suivants :
  * **Key** :
    Un champ *obligatoire*. L'index de la **valeur d'attribut**.
  * **Value** :
    Ce champ *facultatif* est la valeur de l'attribut. S'il n'est pas défini, la valeur est *null*.

### Champs de New Catalog Bundle

Lorsque vous sélectionnez un **Catalog**, ouvrez l'onglet **Bundles** et choisissez **NEW BUNDLE**, la page **New Catalog Bundle** s'ouvre.

Cette page contient tous les champs de la page [New Catalog Item](#new-catalog-item-fields), *plus* ce champ :

* **BUNDLE CONTENTS** :
  * **ADD TO BUNDLE**
    Affiche la liste de tous les objets, monnaies et tables de butin du catalogue et vous permet de sélectionner ceux à ajouter à l'ensemble.

### Champs de New Catalog Container

Lorsque vous sélectionnez un **Catalog**, ouvrez l'onglet **Containers** et choisissez **NEW CONTAINER**, la page **New Catalog Container** s'ouvre.

Cette page contient tous les champs de la page [New Catalog Item](#new-catalog-item-fields), *plus* ce champ :

* **CONTAINER CONTENTS** :
  * **ADD TO CONTAINER**
    Affiche la liste de tous les objets, monnaies et tables de butin du catalogue et vous permet de sélectionner ceux à ajouter au conteneur.

### Champs de New Drop Table

Lorsque vous sélectionnez un **Catalog**, ouvrez l'onglet **Drop tables** et choisissez **NEW DROP TABLE**, la page suivante s'affiche :

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-new-drop-table.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=d9b7c026706ecea615c8f205a0588f06" alt="Game Manager - Economy - Catalogs - New Drop Table" width="805" height="568" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-new-drop-table.png" />

La page **New Catalog Drop Table** contient les champs suivants :

* **DROP TABLE ID** :
  * **Table Id** :
    Ce champ *obligatoire* est l'identificateur unique de la table de butin dans le catalogue. La valeur de **Table Id** doit être unique dans le catalogue, mais vous pouvez avoir plusieurs versions de catalogue contenant des tables de butin ayant le même **Table Id**.

* **TABLE CONTENTS** :
  * **ADD TO DROP TABLE**
    Affiche la liste de tous les objets et tables de butin du catalogue et vous permet de sélectionner ceux à ajouter à la table de butin.

### Champs de New Store

Lorsque vous sélectionnez un **Catalog**, ouvrez l'onglet **Stores** et choisissez **NEW STORE**, la page suivante s'affiche :

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-new-store.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=d60f86f16949856f2144ed60a4a1953d" alt="Game Manager - Economy - Catalogs - New Store" width="1200" height="651" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-new-store.png" />

La page **New Store** contient les champs suivants :

* **STORE NAME** :
  * **Store Id** :
    Ce champ *obligatoire* est l'identificateur unique du magasin dans le catalogue. La valeur de **Store Id** doit être unique dans le catalogue, mais vous pouvez avoir plusieurs versions de catalogue contenant des magasins ayant le même **Store Id**.
  * **Store name**
    Ce champ *facultatif* est le nom affiché pour le magasin. Les noms d'affichage n'ont pas besoin d'être uniques.
  * **Description** :
    Ce champ *facultatif* est la description du magasin.
  * **Custom data**
    Ce champ *facultatif* vous permet d'entrer des attributs pour le magasin sous forme de paires clé-valeur (KVP). Seule la clé est obligatoire pour chaque attribut. Les KVP sont entrées en JSON dans la zone de texte. Sélectionner l'étiquette **JSON** au-dessus de la zone fournit un format de saisie.
* **STORE CONTENTS** :
  * **ADD TO STORE**
    Affiche la liste de tous les objets du catalogue et vous permet de sélectionner ceux à ajouter au magasin.
* **SEGMENT OVERRIDES** :
  Ces champs *facultatifs* vous permettent de définir quels segments de joueurs pourront utiliser votre magasin.

<Note>
  Pour obtenir des renseignements détaillés sur la création et l'utilisation de magasins dans votre jeu, consultez notre [démarrage rapide des magasins](/fr-CA/services/playfab/economy-monetization/economy/stores/quickstart).
</Note>

## Exemple de création d'un catalogue

Pour créer un **Catalog** :

1. Ouvrez **Game Manager** et sélectionnez **Economy** dans la barre latérale gauche.
2. Sélectionnez l'onglet **Catalogs**.
3. Sélectionnez le bouton **NEW CATALOG**.
4. Entrez une **Catalog version** (par exemple, *My Catalog*).
   * Un objet ayant l'ID **One** est ajouté automatiquement.
5. Sélectionnez **One**. (La page **Edit Catalog Item** comporte les mêmes champs que la page [**New Catalog Item**](#new-catalog-item-fields) décrite ci-dessus.)
   1. Modifiez ou ajoutez certaines propriétés, par exemple :
      * **Item ID** (ex. **shield\_level\_5**).
      * **Display name** (ex. **Level 5 Shield**).
      * **Description** (ex. **Strong defense against projectile attacks**).
6. Définissez un prix en sélectionnant une monnaie et un montant, par exemple :
   1. Réglez **Currency** à **Gold** (pour plus d'information, consultez [Monnaies](/fr-CA/services/playfab/economy-monetization/economy/tutorials/currencies)).
   2. Réglez **Amount** à **250**.
7. Sélectionnez **SAVE ITEM**.
8. Vous revenez à la page **Items** de votre catalogue. Pour ajouter d'autres objets, sélectionnez **NEW ITEM** et répétez les étapes 5 à 7.

## Téléversement d'un catalogue

Pour téléverser un fichier JSON afin de créer un catalogue dans Game Manager, procédez comme suit :

1. Sélectionnez votre **Game** dans **Game Manager**.
2. Sélectionnez **Economy**.
3. Sélectionnez **Catalogs**.
4. Sélectionnez **UPLOAD JSON**.
5. Sélectionnez votre fichier JSON et choisissez **UPLOAD FILE**.

<Note>
  Vous pouvez également enregistrer ou téléverser des catalogues sous forme de fichiers JSON à l'aide des API Admin [GetCatalogItems](xref:titleid.playfabapi.com.admin.title-widedatamanagement.getcatalogitems) et [SetCatalogItems](xref:titleid.playfabapi.com.admin.title-widedatamanagement.setcatalogitems).
</Note>


## Related topics

- [Magasins (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/stores/index.md)
- [Objets (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/items/index.md)
- [Démarrage rapide des magasins (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [Démarrage rapide d'Economy (hérité)](/fr-CA/services/playfab/economy-monetization/economy/quickstart.md)
- [Démarrage rapide des objets (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/items/quickstart.md)