Suivi des prix en argent réel dans Economy v2

​

Prérequis

• Un compte de développeur PlayFab.
• Un titre créé dans Game Manager.
• Une intégration de place de marché déjà configurée (par exemple, Google, Apple ou Microsoft Store).
• Un ensemble publié avec un mappage de place de marché qui le lie à un produit de la place de marché.

​

Étape 1 : Définir des prix en argent réel sur votre ensemble

​

API

{
  "Item": {
    "Id": "{{StarterPackBundleID}}",
    "Type": "bundle",
    "Title": {
      "NEUTRAL": "Starter Pack"
    },
    "ItemReferences": [
      {
        "Id": "{{LaserSwordID}}",
        "Amount": 1
      },
      {
        "Id": "{{GoldCurrencyID}}",
        "Amount": 500
      }
    ],
    "RealMoneyPriceDetails": {
      "GooglePlayPrices": {
        "USD": 499
      },
      "AppleAppStorePrices": {
        "USD": 499
      },
      "MicrosoftStorePrices": {
        "USD": 499
      }
    },
    "AlternateIds": [
      {
        "Type": "GooglePlay",
        "Value": "com.mygame.starterpack"
      },
      {
        "Type": "AppleAppStore",
        "Value": "com.mygame.starterpack"
      },
      {
        "Type": "MicrosoftStore",
        "Value": "9NBLGGH42CFD"
      }
    ]
  },
  "Publish": true
}

​

Game Manager

1. Accédez à Economy > Catalog (V2) > Bundles.
2. Sélectionnez l’ensemble à modifier.
3. Dans la section Prices, définissez le prix en argent réel pour chaque place de marché où l’ensemble apparaît.
4. Assurez-vous que la section Marketplace Mapping contient les AlternateIds appropriés pour chaque place de marché.
5. Sélectionnez Save and publish.

​

Référence du format des prix

• AppleAppStorePrices
• GooglePlayPrices
• MicrosoftStorePrices
• NintendoEShopPrices
• PlayStationStorePrices
• SteamPrices

​

Prix différents selon la place de marché

"RealMoneyPriceDetails": {
  "GooglePlayPrices": {
    "USD": 499
  },
  "AppleAppStorePrices": {
    "USD": 529
  },
  "SteamPrices": {
    "USD": 449
  }
}

​

Étape 2 : Le joueur effectue un achat et l’échange

1. Associe le reçu de la place de marché à l’AlternateId de l’ensemble.
2. Accorde le contenu de l’ensemble à l’inventaire du joueur.
3. Émet un événement marketplace_transaction_redeemed qui inclut les RealMoneyPrices de l’ensemble correspondant.

​

Étape 3 : Consulter les revenus dans les événements

​

Consulter dans Game Manager

1. Accédez à Data > Event History (dans la section Analyze).
2. Recherchez le nom d’événement marketplace_transaction_redeemed.
3. Sélectionnez un événement pour en afficher les détails, y compris le champ RealMoneyPrices.

​

Exemple de charge utile d’événement

{
  "EventName": "marketplace_transaction_redeemed",
  "Marketplace": "GooglePlay",
  "MarketplaceTransctionId": "GPA.1234-5678-9012-34567",
  "MarketplaceAlternateId": "com.mygame.starterpack",
  "Amount": 1,
  "ItemId": "{{StarterPackBundleID}}",
  "ItemType": "bundle",
  "RealMoneyPrices": {
    "USD": 499
  }
}

{
  "RealMoneyPrices": {
    "USD": 529
  }
}

​

Interroger les données de revenus

Total revenue = Sum of (RealMoneyPrices.USD × Amount) across all events

​

Meilleures pratiques

• Définissez toujours RealMoneyPriceDetails sur les ensembles de place de marché. Sans cela, le champ RealMoneyPrices des événements d’échange est vide et vous perdez la visibilité sur vos revenus.
• Utilisez la plus petite unité monétaire. Pour l’USD, indiquez le prix en cents (par exemple, 499 pour 4,99 $).
• Remplissez uniquement les places de marché que vous utilisez. Vous n’avez pas besoin de définir des prix pour toutes les places de marché, seulement pour celles où votre titre est publié.
• Gardez vos prix synchronisés avec vos fiches de place de marché. Lorsque vous mettez à jour des prix dans une place de marché externe, mettez à jour la propriété correspondante dans RealMoneyPriceDetails pour conserver des rapports exacts.
• Définissez des prix par place de marché lorsqu’ils diffèrent. Si le prix de votre jeu varie d’un magasin à l’autre, utilisez les propriétés propres à chaque place de marché pour refléter le prix réel sur chaque plateforme.

​

Voir aussi

• Référence des prix en argent réel
• Ensembles d’Economy v2
• Démarrage rapide de la prévention de la fraude
• Intégrations de places de marché
• Événement marketplace_transaction_redeemed