Passer au contenu principal

Obtenir la valeur à ce jour (VTD) d’un joueur (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!
PlayFab suit le montant total dépensé par un joueur dans le modèle de profil de joueur, qui est récupéré en appelant l’API GetPlayerProfile. Dans le PlayerProfileModel, la VTD d’un joueur est suivie dans deux champs différents :
  1. totalValueToDateInUSD - La somme des achats du joueur effectués avec des devises en argent réel, convertie en équivalent en dollars américains (USD) et représentée sous forme de nombre entier de cents (1/100 USD).
  2. valuesToDate - Un tableau d’objets ValueToDateModel qui contiennent les totaux d’achats cumulatifs du joueur, additionnés pour chaque devise en argent réel dans laquelle il a effectué un achat. Le champ TotalValue de chaque objet exprime le total pour cette devise sous forme de nombre entier de 1/100 d’unité monétaire.
Le JSON suivant montre ces deux champs avec des exemples de valeurs.

Utiliser la VTD pour définir des segments de joueurs

Dans PlayFab Game Manager, vous pouvez utiliser totalValueToDateInUSD ou valuesToDate comme prédicats de segment, c’est-à-dire des critères qui peuvent servir à définir des segments de joueurs. Lorsque vous créez ou modifiez un segment de joueurs, les deux prédicats figurent dans la liste déroulante :
  1. Total value to date in USD - La valeur TotalValueToDateInUSD.
  2. Value to date - Les totaux ValuesToDate. Lorsque vous sélectionnez ce prédicat, des champs supplémentaires s’affichent pour préciser la devise et le montant pour cette devise.

Exemples de segments

Les exemples suivants montrent des segments créés à l’aide de chacun des totaux de VTD.
  1. Créez un segment de tous les joueurs qui ont effectué des achats de plus de 15 USD dans n’importe quelle devise. Créer un segment - Dépensiers moyens - Filtre 1
  2. Créez un segment de tous les joueurs qui ont dépensé plus de 15 USD dans n’importe quelle devise ou 15 yuans chinois. Créer un segment - Dépensiers moyens - Filtre 2
Dernière modification le 6 octobre 2026