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

# Obtenir la valeur à ce jour (VTD) d'un joueur dans Economy (hérité)

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

> [!NOTE]
>
> 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](https://docs.xbox.com/fr-CA/services/playfab/economy-monetization/economy-v2/overview.md) 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](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` - 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](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile#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.

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

## 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](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)

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](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)


## Related topics

- [Catalogues (Economy hérité)](https://docs.xbox.com/fr-CA/services/playfab/economy-monetization/economy/items/catalogs.md)
- [Gérer les monnaies virtuelles dans Economy (hérité)](https://docs.xbox.com/fr-CA/services/playfab/economy-monetization/economy/tutorials/currencies.md)
- [Démarrage rapide d'Economy (hérité)](https://docs.xbox.com/fr-CA/services/playfab/economy-monetization/economy/quickstart.md)
- [Démarrage rapide des objets (Economy hérité)](https://docs.xbox.com/fr-CA/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Objets (Economy hérité)](https://docs.xbox.com/fr-CA/services/playfab/economy-monetization/economy/items/index.md)