> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtenir la valeur cumulée (VTD) d'un joueur dans Economy (hérité)

> Récupérez les dépenses totales d'un joueur PlayFab à l'aide de GetPlayerProfile et lisez totalValueToDateInUSD et valuesToDate à partir du PlayerProfileModel.

# Obtenir la valeur cumulée (VTD) d'un joueur (Economy hérité)

<Info>
  Les API Economy v1 sont en mode maintenance et ne recevront plus de nouvelles fonctionnalités, uniquement des correctifs de bogues. **Les API v1 seront maintenues dans un avenir prévisible.** Consultez la [vue d'ensemble d'Economy v2](/fr/services/playfab/economy-monetization/economy-v2/overview) pour en savoir plus sur la prochaine version de PlayFab Economy !
</Info>

PlayFab suit le montant total dépensé par un joueur dans le [modèle de profil de joueur](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile#playerprofilemodel), qui est récupéré en appelant l'API [GetPlayerProfile](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile).

Dans le `PlayerProfileModel`, la VTD d'un joueur est suivie dans deux champs différents :

1. `totalValueToDateInUSD` : somme des achats du joueur effectués avec des devises réelles, convertie en équivalent dollars américains (**USD**) et représentée sous forme de nombre entier de cents (1/100 USD).
2. `valuesToDate` : tableau d'objets [ValueToDateModel](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile#valuetodatemodel) qui contiennent le total des achats du joueur depuis la création de son compte, additionné pour chaque devise réelle 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 centièmes d'unité monétaire.

Le JSON suivant présente ces deux champs avec des exemples de valeurs.

```json theme={null}
{
    …
    totalValueToDateInUSD: 1700
    valuesToDate: [{ "USD", 1200 }, { "EUR", 320 }]
    …
}
```

## Utilisation de 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 permettant de définir des segments de joueurs.

Lors de la création ou de la modification d'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 spécifier la devise et le montant pour cette devise.

## Exemples de segments

Les exemples suivants présentent des segments créés à l'aide de chacun des totaux VTD.

1. Créez un segment de tous les joueurs ayant effectué des achats de plus de **15 USD** dans n'importe quelle devise.

   <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/create-segment-mid-rollers-filter-1.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=fa15a6d1b2d3ffbd840f6bb1af492501" alt="Créer un segment - Mid Rollers - Filtre 1" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/create-segment-mid-rollers-filter-1.png" />

2. Créez un segment de tous les joueurs ayant dépensé plus de **15 USD** dans n'importe quelle devise *ou* **15 yuans chinois**.

   <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/create-segment-mid-rollers-filter-2.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=2369e1383568c3fe81d6f8def958289e" alt="Créer un segment - Mid Rollers - Filtre 2" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/create-segment-mid-rollers-filter-2.png" />


## Related topics

- [Boutiques personnalisées pour les segments de joueurs dans Economy (hérité)](/fr/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)
- [Meilleures pratiques pour la segmentation des boutiques dans Economy (hérité)](/fr/services/playfab/economy-monetization/economy/tutorials/best-practices-for-store-segmentation.md)
- [Démarrage rapide d'Economy (héritée)](/fr/services/playfab/economy-monetization/economy/quickstart.md)
- [Démarrage rapide des articles (Economy héritée)](/fr/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Tables de butin dans Economy (hérité)](/fr/services/playfab/economy-monetization/economy/tutorials/drop-tables.md)