Boutiques Economy v2

Economy v2 est désormais en disponibilité générale. Pour obtenir de l’aide et donner votre avis, rendez-vous sur le forum PlayFab.

Les boutiques constituent un excellent moyen d’enrichir et de développer l’économie de votre jeu. Les boutiques sont un type d’article spécial qui contient une liste d’articles et de prix, et qui vous permet de remplacer les prix de base du catalogue pour ces articles. Les boutiques peuvent servir à gérer les endroits où les articles peuvent être achetés dans votre jeu, à proposer des remises et des promotions en jeu, et bien plus encore !

Création d’une boutique

Pour créer une boutique, vous devez d’abord vous assurer de disposer d’autres articles de catalogue, devises ou contenus générés par les utilisateurs (UGC) publiés que vous souhaitez rendre accessibles ou achetables dans votre jeu. Vous pouvez suivre les étapes du démarrage rapide d’Economy v2

GameManager

Accédez à Economy > Catalog (V2).
Sous l’onglet Stores, sélectionnez New Store.

Renseignez les métadonnées souhaitées. L’un des éléments clés à définir est la liste des articles que vous souhaitez rendre disponibles dans cette boutique et les prix par lesquels vous souhaitez remplacer leurs prix d’origine.

API

Vous pouvez utiliser CreateDraftItem pour créer une boutique. Exemple de requête CreateDraftItem pour créer une boutique :

{
  "Item": {
   "Type": "store",
    "Title": {
      "NEUTRAL": "My First Store",
    },
    "StartDate": "2022-09-07T00:00:00.00000000Z",
    "ItemReferences":[
      {
        "Id":"LaserSword",
        "Amount": 1,
        "PriceOptions": {
          "Prices": [{
            "Amounts": [{
              "ItemId": "Diamond",
              "Amount": 1
            }]
          }]
        }
      },
      {
      "Id":"WeaponBundle",
      "PriceOptions": {
        "Prices": [{
          "Amounts": [{
            "ItemId": "Gold",
            "Amount": 10
            },
            {
            "ItemId": "Silver",
            "Amount": 10
          }]
        }],
      },
    }]
   },
   "Publish": true
}

L’exemple ci-dessus est une boutique qui vend deux articles, LaserSword et WeaponBundle. Les deux articles sont des articles de catalogue existants dotés d’un prix de base défini dans le catalogue. Cette boutique remplace leurs prix existants et propose désormais LaserSword pour 1 Diamond et WeaponBundle pour 10 Gold et 10 Silver. Cette requête retourne une réponse indiquant que la boutique a été créée et publiée :

{
  "code": 202,
  "status": "Accepted",
  "Item": {
    "Type": "store",
    "Id": "{{StoreID}}", 
    "Title": {
      "NEUTRAL": "My First Store",
    },
    ...
}

Notez l’Id désormais associé à notre boutique publiée.

Pour simplifier le concept, les ID d’articles ont été remplacés : les GUID ont laissé place aux noms des articles afin de mieux illustrer l’utilisation des boutiques.

Utilisation d’une boutique

Les boutiques sont utilisées lorsque les joueurs appellent l’API PurchaseInventoryItems. Lorsque vous appelez PurchaseInventoryItems, l’une des propriétés facultatives est un paramètre StoreId dans lequel nous pouvons transmettre la boutique à appliquer à cette demande d’achat. Exemple de requête PurchaseInventoryItems utilisant une boutique :

{
    "Entity": {
        "Type": "title_player_account",
        "Id": "{{PlayerID}}"
    },
    "Item": {
        "Id": "LaserSword",
    },
    "Amount": 10,
    "PriceAmounts": [
        {
            "ItemId": "Diamond",
            "Amount": 1
        }
    ],
    "StoreId": "{{StoreID}}"
}

Notez le {{StoreId}} transmis dans la demande d’achat et la façon dont le PriceAmount attendu correspond désormais au coût de 1 Diamond défini dans notre boutique.

Recherche dans une boutique

Lorsque vous utilisez l’API SearchItems, l’une des propriétés que vous pouvez transmettre est le paramètre Store. Ce paramètre vous permet d’effectuer une recherche dans le contexte d’une boutique. En plus de pouvoir vérifier si un article existe dans une boutique donnée, il peut également servir à afficher les prix remplacés des articles/contenus de la boutique. Vous pouvez également utiliser l’AlternateId de la boutique pour la rechercher.

{
  "Search": "",
  "Filter": "ContentType eq 'weapons'",
  "Store": {
    "Id": "{{StoreID}}"
  },
}

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Création d’une boutique

GameManager

API

Utilisation d’une boutique

Recherche dans une boutique

​Création d’une boutique

​GameManager

​API

​Utilisation d’une boutique

​Recherche dans une boutique

Création d’une boutique

GameManager

API

Utilisation d’une boutique

Recherche dans une boutique