Prix en argent réel

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 prix en argent réel vous permettent d’associer des valeurs en devises réelles aux articles du catalogue, place de marché par place de marché. La propriété RealMoneyPriceDetails d’un article de catalogue contient des dictionnaires de prix distincts pour chaque place de marché prise en charge. Ces données sont utilisées par PlayFab pour suivre les revenus issus des transactions sur les places de marché.

Vue d’ensemble

Lorsque les joueurs achètent des articles via des places de marché externes (Apple App Store, Google Play, Steam, Microsoft Store, Nintendo eShop, PlayStation Store), la transaction implique de l’argent réel. En définissant RealMoneyPriceDetails sur vos articles de catalogue, PlayFab peut :

Suivre les revenus issus des échanges sur les places de marché dans l’événement marketplace_transaction_redeemed.

Format

RealMoneyPriceDetails est un objet contenant un dictionnaire de prix distinct pour chaque place de marché prise en charge :

Propriété	Type	Description
`AppleAppStorePrices`	`Dictionary<string, int>`	Le montant du prix sur l’Apple App Store par code de devise.
`GooglePlayPrices`	`Dictionary<string, int>`	Le montant du prix sur Google Play par code de devise.
`MicrosoftStorePrices`	`Dictionary<string, int>`	Le montant du prix sur le Microsoft Store par code de devise.
`NintendoEShopPrices`	`Dictionary<string, int>`	Le montant du prix sur le Nintendo eShop par code de devise.
`PlayStationStorePrices`	`Dictionary<string, int>`	Le montant du prix sur le PlayStation Store par code de devise.
`SteamPrices`	`Dictionary<string, int>`	Le montant du prix sur Steam par code de devise.

Chaque dictionnaire associe un code de devise ISO 4217 à trois lettres à un prix exprimé dans la plus petite unité monétaire (par exemple, les cents pour l’USD).

Seul le dollar américain (USD) est actuellement pris en charge comme code de devise.

Vous n’avez besoin de renseigner que les propriétés des places de marché pertinentes pour votre titre. Par exemple, si votre jeu est disponible uniquement sur Google Play et l’Apple App Store, il vous suffit de définir GooglePlayPrices et AppleAppStorePrices.

Exemples de prix

Prix réel	Valeur du dictionnaire
$0.99 USD	`{"USD": 99}`
$1.39 USD	`{"USD": 139}`
$4.99 USD	`{"USD": 499}`
$9.99 USD	`{"USD": 999}`

Définition des prix en argent réel sur un article de catalogue

Les prix en argent réel sont généralement définis sur des lots liés à des produits de places de marché externes via AlternateIds. Lorsqu’un joueur échange un achat effectué sur une place de marché, PlayFab utilise la valeur RealMoneyPriceDetails du lot de catalogue correspondant pour enregistrer le revenu.

API

Vous pouvez définir RealMoneyPriceDetails lors de la création ou de la mise à jour d’un article de catalogue à l’aide de CreateDraftItem ou UpdateDraftItem :

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

Vous pouvez également définir des prix différents par place de marché si vos tarifs varient d’une boutique à l’autre :

"RealMoneyPriceDetails": {
  "GooglePlayPrices": {
    "USD": 499
  },
  "AppleAppStorePrices": {
    "USD": 529
  },
  "MicrosoftStorePrices": {
    "USD": 499
  }
}

Game Manager

Accédez à Economy > Catalog (V2).
Sous l’onglet Bundles, sélectionnez le lot à modifier ou créez-en un nouveau.
Dans la section Prices, configurez le prix en argent réel pour chaque place de marché.
Dans la section Marketplace Mapping, liez le lot à vos produits de places de marché externes.

Affichage des prix en argent réel dans les événements

Lorsqu’une transaction sur une place de marché est échangée, le prix correspondant à cette place de marché est inclus dans l’événement marketplace_transaction_redeemed sous la forme RealMoneyPrices. Par exemple, pour un échange Google Play :

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

Ces données d’événement peuvent ensuite être utilisées pour :

Des requêtes d’analyse personnalisées via l’Explorateur Insights

Bonnes pratiques

Définissez toujours RealMoneyPriceDetails sur les lots des places de marché. Cela garantit un suivi des revenus et des analyses précis.
Utilisez la plus petite unité monétaire. Pour l’USD, indiquez le prix en cents (par exemple, 499 pour $4.99).
Ne renseignez que les places de marché que vous utilisez. Vous n’avez pas besoin de définir des prix pour chaque place de marché, seulement pour celles sur lesquelles votre titre est publié.
Maintenez vos prix synchronisés avec vos fiches sur les places de marché. Lorsque vous mettez à jour 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 votre jeu a des prix différents selon les boutiques, utilisez les propriétés par place de marché pour refléter le prix réel sur chaque plateforme.

XBOX Services

PlayFab

Prix en argent réel dans Economy v2

Prix en argent réel

Vue d’ensemble

Format

Exemples de prix

Définition des prix en argent réel sur un article de catalogue

API

Game Manager

Affichage des prix en argent réel dans les événements

Bonnes pratiques

Voir aussi

​Prix en argent réel

​Vue d’ensemble

​Format

​Exemples de prix

​Définition des prix en argent réel sur un article de catalogue

​API

​Game Manager

​Affichage des prix en argent réel dans les événements

​Bonnes pratiques

​Voir aussi

Prix en argent réel

Vue d’ensemble

Format

Exemples de prix

Définition des prix en argent réel sur un article de catalogue

API

Game Manager

Affichage des prix en argent réel dans les événements

Bonnes pratiques

Voir aussi