Pular para o conteúdo principal

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

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 para saber mais sobre a próxima versão do PlayFab Economy!
O PlayFab acompanha o valor total gasto por um jogador no modelo de perfil do jogador, que é recuperado chamando a API 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 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.

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. Criar um segmento - Mid Rollers - Filtro 1
  2. Crie um segmento de todos os jogadores que gastaram mais de 15 USD em qualquer moeda ou 15 yuans chineses. Criar um segmento - Mid Rollers - Filtro 2
Última modificação em 6 de outubro de 2026