Passer au contenu principal

​
Démarrage rapide des magasins (Economy hérité)

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 pour en savoir plus sur la prochaine version de PlayFab Economy!
Les magasins sont le meilleur moyen de permettre aux joueurs d’acheter des objets dans votre jeu. Comme le montre le démarrage rapide des objets, PlayFab prend en charge l’achat d’objets directement dans un catalogue, mais ce n’est pas ainsi que la plupart des jeux structurent leurs achats. Que vous créiez un jeu incrémental, un RPG, un FPS ou un jeu de course sans fin, vous avez probablement des vendeurs dans votre jeu. Des endroits où les joueurs peuvent acheter des armes, des armures ou des chaussures de course. Notre solution pour les vendeurs et les boutiques en jeu est celle des magasins, un sous-ensemble de votre catalogue dont vous pouvez remplacer les prix. Dans ce démarrage rapide des magasins, vous allez :
  • Ajouter des objets à un catalogue avec des prix réguliers.
  • Créer un magasin contenant les mêmes objets à prix réduits.
  • Utiliser les API PlayFab pour acheter un objet du magasin.
  • Utiliser l’information de Game Manager pour confirmer que l’objet a été acheté au prix réduit du magasin.

​
Ajout d’objets à un catalogue

Commençons par ajouter quelques objets à vendre dans votre catalogue :
  1. Ouvrez Game Manager et sélectionnez Economy dans la barre latérale gauche.
  2. Sélectionnez l’onglet Catalogs, puis ouvrez votre catalogue main.
  3. Sélectionnez New Item à quelques reprises pour créer des objets :
    • apricot au prix de 4 GD.
    • pear au prix de 3 GD.
    • grape sans prix en GD (ne sélectionnez aucun prix).
Vous n’avez pas à attribuer un prix en monnaie virtuelle aux objets d’un catalogue pour qu’ils apparaissent dans un magasin.
Dans l’exemple suivant, un objet appelé apricot est ajouté au catalogue main au prix de 4 GD. Economy - Catalogs - Add Item

​
Création d’un magasin

Vous devriez maintenant avoir quelques objets avec des prix dans votre catalogue. Créons un magasin pour les vendre à un joueur.
  1. Ouvrez votre catalogue main et sélectionnez Stores.
  2. Sélectionnez New store.
  3. Réglez Store Id et Store name à fruits (comme dans l’exemple suivant). Economy - Catalogs - Stores - New Store
  4. Sélectionnez ADD TO STORE.
    • Une fenêtre contextuelle, comme celle illustrée ci-dessous, affiche tous les objets, ensembles et conteneurs du catalogue actuel.
  5. Ajoutez quelques objets à votre magasin en sélectionnant le bouton Add à côté de l’objet. Economy - Catalogs - Stores - Add To Store

​
Définition du prix en magasin d’un objet

Vos objets devraient maintenant figurer dans STORE CONTENTS, mais ils ne sont pas valides tant qu’ils n’ont pas au moins un prix. Le petit nombre statique (par exemple, < 4) à côté de la zone de texte du prix correspond au prix d’origine du catalogue. Vous n’avez à entrer un prix que dans une seule zone de chaque ligne, mais vous pouvez entrer autant de prix que vous le souhaitez.
  • Si vous n’entrez aucun prix pour un objet, celui-ci sera retiré du magasin.
  • Si un objet du magasin n’a pas de prix dans une monnaie, il ne peut pas être acheté avec cette monnaie.
  • Les prix en magasin peuvent être plus élevés que les prix du catalogue, et zéro est un prix valide pour un objet.
Vous pouvez glisser-déposer les lignes du contenu du magasin pour réorganiser l’ordre des objets.
  1. Ajoutez des prix en GD à vos objets, mais inférieurs aux prix du catalogue :
    • Apricot : 3.
    • Pear : 2.
    • Grape : 1.
  2. Sélectionnez SAVE STORE lorsque vous avez terminé.
Dans l’exemple suivant, un objet appelé apricot dont le prix au catalogue est de 4 GD reçoit un prix en magasin de 3 GD. Créer un magasin

​
Achat d’un objet dans le magasin

Maintenant que vous avez un magasin, utilisons les API PlayFab pour acheter un objet du magasin dans votre jeu.
  1. Obtenez votre magasin en appelant GetStoreItems avec ces paramètres dans la requête :
    • CatalogVersion = "main"
    • StoreId = "fruits"
  2. Le champ Store de GetStoreItemsResult devrait contenir la liste des objets de votre magasin et leurs prix.
  3. Appelez PurchaseItem avec, dans la requête, des valeurs qui précisent la monnaie et le prix en magasin de l’objet que vous souhaitez acheter.
    • CatalogVersion = "main"
    • StoreId = "fruits"
    • ItemId = "pear"
    • VirtualCurrency = "GD"
    • Price = 2
Si vous ne précisez pas le StoreId lors de l’appel à PurchaseItem, l’achat est tenté au prix du catalogue.

​
Confirmation du prix d’achat

Ouvrez Game Manager et confirmez que l’achat a été effectué au prix en magasin de deux GD.
  1. Sélectionnez Players dans la barre latérale gauche pour ouvrir l’onglet Players.
  2. Sélectionnez l’ID du joueur qui a acheté l’objet.
  3. Vérifiez l’information suivante pour le joueur :
    • Ouvrez l’onglet Inventory. L’inventaire devrait maintenant contenir un objet pear.
    • Ouvrez l’onglet Virtual Currency. Vérifiez la valeur Amount de la monnaie virtuelle pour confirmer que le joueur n’a dépensé que 2 GD.
    • Ouvrez l’onglet PlayStream. Vous verrez des événements illustrant le flux d’achat à partir du magasin. Ces événements comprennent un événement Player virtual currency item purchased et un événement Player virtual currency balance changed indiquant que le solde de monnaie virtuelle a changé de deux GD.
Vous pouvez utiliser Game Manager pour modifier l’ordre des objets de votre magasin et ajuster les prix en tout temps.

​
Étapes suivantes

Maintenant que vous savez comment créer et utiliser des magasins dans votre jeu, vous êtes prêt à explorer des utilisations plus avancées des magasins. Par exemple, en utilisant des segments avec des magasins, vous pouvez offrir des prix spéciaux à certains joueurs sans toucher au code de votre jeu.
Dernière modification le 6 octobre 2026