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

# Visão geral das estatísticas em destaque

> Como as estatísticas em destaque do XBOX Live (anteriormente Hero Stats) permitem que os editores exibam o progresso mais relevante de um jogador no shell, nos GameHubs e no aplicativo XBOX.

As estatísticas em destaque (anteriormente conhecidas como Hero Stats) são métricas definidas pelo editor que destacam o progresso mais relevante de um usuário.

Um usuário pode comparar o próprio progresso com o de outros jogadores comparando suas estatísticas em destaque. Isso ajuda a aumentar o investimento do usuário na experiência de jogo.

As estatísticas em destaque personalizadas permitem que os editores exibam rapidamente conteúdo dinâmico de um título, mesmo quando ele não está em execução. O conteúdo é mostrado de forma consistente em todos os serviços XBOX, incluindo o console XBOX, as telas complementares do SmartGlass e outras experiências da plataforma.

As estatísticas em destaque trazem benefícios, incluindo:

* Oferecer aos usuários uma experiência consistente e acessível para acompanhar a própria atividade e progresso em um jogo ou aplicativo e compará-los com os amigos.
* Oferecer aos editores uma oportunidade de mostrar aspectos atraentes e envolventes de seu título para trazer os usuários de volta ao jogo ou aplicativo.
* Evoluir a experiência do perfil de jogador no shell, para que a plataforma possa acompanhar, celebrar e recompensar tudo o que cada usuário faz em todas as experiências de entretenimento dos serviços XBOX.

<Info>Cada título pode selecionar até vinte de suas estatísticas de usuário mais representativas para serem exibidas como estatísticas em destaque. Todas as estatísticas em destaque devem ser marcadas como Open Access para que outros títulos possam lê-las.</Info>

### Cenários de exemplo

* Exibir estatísticas em destaque no contexto de uma cena de "Game Details" para fornecer aos jogadores visualizações de progresso em tempo real.
* Comparar estatísticas em destaque de um ou vários títulos entre o jogador e os amigos com quem ele interage com frequência.
* Calcular agregações de estatísticas em destaque relevantes entre amigos ou em toda a base de usuários dos serviços XBOX.
* Ver rapidamente as estatísticas em destaque ao consultar o perfil de qualquer usuário no contexto de um título, como o aplicativo Party em jogos multijogador.
* As estatísticas em destaque são "detectáveis" por qualquer aplicativo. Isso significa que aplicativos de terceiros podem criar experiências personalizadas, como suplementos, sites, aplicativos ou kits de ferramentas, usando as informações fornecidas pelas estatísticas em destaque.

### Fundamentos

Pense nas estatísticas em destaque como uma oportunidade para cada título dos serviços XBOX exibir com destaque dados interessantes sobre a atividade do usuário diretamente na UX do sistema.
Os títulos que implementam estatísticas em destaque podem designar até 20 estatísticas de usuário principais como estatísticas em destaque. Escolha algumas das estatísticas mais atraentes que o título já produz para incentivar os usuários a voltar a jogar e dar a eles um motivo para iniciar seu título novamente.

**Figura 1.  Exemplo de estatísticas em destaque exibidas.**

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/featured_stats_screenshot.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=71e532dad0243f969066854ca89c3beb" alt="Estatísticas em destaque" width="811" height="408" data-path="images/gdk/services/featured_stats_screenshot.png" />

#### Configuração

Ao configurar a lista de estatísticas em destaque, especifique os detalhes de cada uma destas propriedades:

| Detalhe | Descrição |
| :- | :- |
| Nome da instância de estatística | Uma instância de estatística de usuário específica definida pelo título. |
| Nome de exibição | O nome amigável que será usado como rótulo na UX. Essa string deve ser localizada por meio da configuração de serviço. |
| Ordinal | A posição de prioridade em relação às outras estatísticas em destaque desta lista, para que a UX da plataforma possa exibi-las adequadamente se o espaço for limitado. |
| Ordem de classificação | Esta propriedade especifica se um valor maior ou menor é "melhor" ao comparar a estatística entre usuários (um contra um ou no contexto de leaderboards sociais). |

Opcionalmente, você pode configurar como as estatísticas em destaque são exibidas definindo estas propriedades de exibição:

| Detalhe | Descrição |
| :- | :- |
| Formato de exibição | Forneça dicas de formatação para que os clientes exibam estatísticas em destaque numéricas (tipo de dados INT ou DOUBLE) em um formato amigável. Você pode especificar um destes formatos de exibição para cada estatística em destaque: Integer, Decimal, Percentage, Short Timespan ou Long Timespan. |
| Unidade de exibição | Se o formato de exibição for um intervalo de tempo, você poderá especificar a unidade de tempo acompanhada por uma estatística. Você pode definir as unidades de exibição como milissegundos, segundos, minutos, horas ou dias. |
| Semântica de exibição | Esta propriedade ajuda clientes que não são jogos (incluindo o shell, o SmartGlass e aplicativos complementares) a determinar que tipo de agregações e cálculos devem ser aplicados ao valor de uma estatística em destaque. Você pode definir a semântica de exibição de cada estatística em destaque como Cumulative, Tier ou Best. |

<Info>Nem todas as estatísticas de usuário podem aproveitar essas propriedades de exibição opcionais.</Info>

### Práticas recomendadas

Você pode aproveitar ao máximo o espaço de tela privilegiado reservado pela plataforma para as estatísticas em destaque. Considere as observações a seguir para ajudar a determinar quais estatísticas em destaque configurar:

* Seja estratégico sobre qual estatística em destaque é marcada com o ordinal "1". Algumas experiências da plataforma, como a página de detalhes de jogos da Microsoft Store, exibem somente a estatística em destaque de maior prioridade na forma de um leaderboard social que inclui os amigos do usuário e suas pontuações e classificações relativas.

* Selecione métricas com maior probabilidade de fazer o usuário iniciar seu título. Exemplos incluem a classificação do jogador, o saldo de moeda do jogo, o nome do próximo objetivo ou marco da campanha e pontuações numéricas cumulativas ou XP.

* Escolha métricas que destaquem aspectos sociais ou interativos do jogo, como estatísticas específicas do modo multijogador, compartilhamento ou avaliação de conteúdo gerado pelo usuário ou outras atividades cooperativas ou competitivas.

* Selecione estatísticas que definam a jogabilidade do seu título e sirvam como ponto de partida para conversas na sua comunidade de usuários. Por exemplo, número de galinhas chutadas, número de colecionáveis encontrados, nível ou XP do usuário, personagem ou arma preferidos.

* O valor da estatística não é localizado automaticamente para outros idiomas nem mapeado para um conjunto de rótulos.

* Observe que o valor de uma estatística em destaque pode ser qualquer tipo de dados integer, float ou string válido. Se você precisar de um formato específico para estatísticas baseadas em eventos, configure o cliente para definir e registrar eventos que incluam o valor real da estatística em um campo e a string formatada equivalente em outro campo do evento. Use o campo de evento de string como UPDATE.


## Related topics

- [Estatísticas em destaque](/pt-BR/services/xbox-services/player-data/stats-leaderboards/featured-stats/live-featured-stats-nav.md)
- [Placares de líderes](/pt-BR/build/steam-porting-guide/features/steam-leaderboards.md)
- [Visão geral das estatísticas gerenciadas pelo título](/pt-BR/services/xbox-services/player-data/stats-leaderboards/title-managed/live-stats-tm-overview.md)
- [Visão geral das estatísticas baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview.md)
- [Visão geral das regras de estatística baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules.md)
