Catalogues (Economy hérité)

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) et Player Item Management (Client) 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.

​

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

​

Champs de New Catalog

Lorsque vous sélectionnez NEW CATALOG dans l’onglet principal Catalogs, la page suivante s’affiche : 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 : 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, 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, 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 : 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 : 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.

​

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