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 bundle publié avec un mappage de place de marché le reliant à un produit de la place de marché.

​

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

​

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 le bundle à modifier.
3. Dans la section Prices, définissez le prix en argent réel pour chaque place de marché où le bundle apparaît.
4. Assurez-vous que la section Marketplace Mapping contient les AlternateIds corrects pour chaque place de marché.
5. Sélectionnez Save and publish.

​

Référence du format de 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. Fait correspondre le reçu de la place de marché à l’AlternateId du bundle.
2. Accorde le contenu du bundle à l’inventaire du joueur.
3. Émet un événement marketplace_transaction_redeemed qui inclut les RealMoneyPrices du bundle correspondant.

​

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

​

Consulter dans Game Manager

1. Accédez à Data > Event History (sous la section Analyze).
2. Recherchez le nom d’événement marketplace_transaction_redeemed.
3. Sélectionnez un événement pour afficher ses 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

​

Bonnes pratiques

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

​

Voir aussi

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