> ## 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.

# Obter o valor até a data (VTD) de um jogador no Economy (Legacy)

> Recupere o gasto total de um jogador do PlayFab usando GetPlayerProfile e leia totalValueToDateInUSD e valuesToDate do PlayerProfileModel.

# Obter o valor até a data (VTD) de um jogador (Legacy Economy)

<Info>
  As APIs do Economy v1 estão em modo de manutenção e não receberão novos recursos, apenas correções de bugs. **As APIs v1 serão mantidas no futuro próximo.** Consulte a [Visão geral do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/overview) para saber mais sobre a próxima versão do PlayFab Economy!
</Info>

O PlayFab acompanha o valor total gasto por um jogador no [modelo de perfil do jogador](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile#playerprofilemodel), que é recuperado chamando a API [GetPlayerProfile](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile).

No `PlayerProfileModel`, o VTD de um jogador é acompanhado em dois campos diferentes:

1. `totalValueToDateInUSD` - A soma das compras do jogador feitas com moedas de dinheiro real, convertida para o equivalente em dólares americanos (**USD**) e representada como um número inteiro de centavos (1/100 USD).
2. `valuesToDate` - Uma matriz de objetos [ValueToDateModel](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile#valuetodatemodel) que contêm os totais de compras do jogador ao longo do tempo, somados para cada moeda de dinheiro real em que ele fez uma compra. O campo `TotalValue` em cada objeto expressa o total dessa moeda como um número inteiro de unidades de 1/100 da unidade monetária.

O JSON a seguir mostra esses dois campos com valores de exemplo.

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

## Usar o VTD para definir segmentos de jogadores

No Game Manager do PlayFab, você pode usar totalValueToDateInUSD ou valuesToDate como *predicados de segmento*, critérios que podem ser usados para definir segmentos de jogadores.

Ao criar ou editar um segmento de jogadores, os dois predicados são incluídos na lista suspensa:

1. **Total value to date in USD** - O valor `TotalValueToDateInUSD`.
2. **Value to date** - Os totais de `ValuesToDate`. Ao selecionar esse predicado, você verá campos adicionais para especificar a moeda e o valor nessa moeda.

## Exemplos de segmentos

Os exemplos a seguir mostram segmentos criados usando cada um dos totais de VTD.

1. Crie um segmento de todos os jogadores que compraram mais de **15 USD** em qualquer moeda.

   <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="Criar um segmento - Mid Rollers - Filtro 1" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/create-segment-mid-rollers-filter-1.png" />

2. Crie um segmento de todos os jogadores que gastaram mais de **15 USD** em qualquer moeda *ou* **15 yuans chineses**.

   <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="Criar um segmento - Mid Rollers - Filtro 2" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/create-segment-mid-rollers-filter-2.png" />


## Related topics

- [Catálogos (Economy Legado)](/pt-BR/services/playfab/economy-monetization/economy/items/catalogs.md)
- [Cupons e promoções no Economy (Legacy)](/pt-BR/services/playfab/economy-monetization/economy/tutorials/coupons-and-promotions.md)
- [Consumíveis temporizados no Economy (Legado)](/pt-BR/services/playfab/economy-monetization/economy/tutorials/timed-consumables.md)
- [Itens (Economy Legado)](/pt-BR/services/playfab/economy-monetization/economy/items/index.md)
- [Gerenciar moedas virtuais no Economy (Legacy)](/pt-BR/services/playfab/economy-monetization/economy/tutorials/currencies.md)