> ## 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 dos leaderboards baseados em eventos
> Como os leaderboards baseados em eventos do XBOX Live comparam jogadores por meio de classificações globais em toda a população do XBOX ou classificações sociais entre os amigos de um jogador.
Este tópico descreve como os leaderboards comparam os jogadores mostrando estatísticas selecionadas de um jogo.
Os leaderboards são uma forma divertida de engajar os jogadores e estimular a competição entre eles. Os serviços XBOX oferecem funcionalidades adequadas para seus jogadores hardcore (classificação *global* em relação a toda a população do XBOX) e para seus jogadores casuais (classificação *social* em relação aos amigos de um jogador).
Dois tipos de leaderboards estão disponíveis: global e social.
Eles têm conceitos muito semelhantes, mas diferenças fundamentais em termos de configuração e finalidade.
## Leaderboards globais vs. sociais
### Leaderboards globais
* Um leaderboard global classifica toda a base de usuários do XBOX e deve ser configurado.
* Um leaderboard global é uma exibição predefinida que você configura no serviço no momento da ingestão (antes ou a qualquer momento depois do lançamento do título).
### Leaderboards sociais
* Um leaderboard social é gerado dinamicamente e classifica os amigos do jogador.
* Um leaderboard social inclui somente jogadores que estão no grafo social do jogador.
* Um leaderboard social não precisa ser predefinido no momento da ingestão, porque o serviço gera o leaderboard dinamicamente em tempo de execução, com base nas estatísticas de usuário existentes.
## Entendendo os leaderboards
Os leaderboards têm dois componentes principais.
* Um valor pelo qual classificar (nos serviços XBOX, é sempre uma [instância de estatística](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview#defining-stat-instances) do jogador).
* Ordem de classificação (valores maiores ou menores são melhores).
### Estatísticas como valores de classificação
Os leaderboards são derivados de estatísticas de jogador. É fundamental ter as regras de estatística certas definidas para o que você precisa. Ao projetar seu jogo, tenha em mente em quais leaderboards você gostaria que seus jogadores fossem classificados.
## Leaderboards globais
Os leaderboards globais acompanham as melhores pontuações registradas pelos jogadores em toda a comunidade XBOX. A principal diferença dos leaderboards globais é que eles são predefinidos no momento da ingestão, especificando um nome de identificação do leaderboard, a estatística classificada e a ordem de classificação (crescente ou decrescente).
Os títulos podem definir um número ilimitado de leaderboards globais e adicionar mais leaderboards a qualquer momento por meio da configuração de serviço. O número máximo de registros por leaderboard global está atualmente limitado a 10.000 entradas. Isso significa que, para jogadores cuja "melhor" pontuação não esteja entre as 10.000 primeiras, a pontuação não aparece no leaderboard.
É possível ler uma "página" de até 100 entradas de leaderboard (XUID do jogador, gamertag, posição global e pontuação) por vez e especificar a posição inicial da página, ou recuperar entradas de leaderboard centralizadas em torno de uma gamertag especificada. Os resultados sempre abrangem todo o período; exibições por dia, semana e mês ainda não têm suporte.
Os leaderboards globais podem ser acessados por meio da XBOX Services API (XSAPI) ou da nossa API REST usando `GET (/scids/{scid}/leaderboards/{leaderboardname})`.
Veja uma captura de tela de como um leaderboard de exemplo poderia ser configurado para um jogo de corrida.
## Leaderboards sociais
Os leaderboards sociais são ótimos incentivos para que os jogadores casuais se comparem e se classifiquem em relação aos amigos. Mesmo que não estejam nas posições mais altas da comunidade, eles ainda podem se sentir motivados a vencer jogadores que conhecem. Os leaderboards sociais são criados dinamicamente com base em qualquer estatística de usuário existente. Por isso, eles não precisam ser predefinidos no momento da ingestão e contêm somente os jogadores do grafo social de um jogador específico.
A principal vantagem dos leaderboards sociais é que eles não são predefinidos. Você pode criar um leaderboard social para qualquer estatística do seu jogo. O chamador pode especificar duas coisas ao solicitar um leaderboard social: a instância de estatística e a ordem de classificação (o padrão é decrescente por classificação). Os resultados sempre abrangem todo o período; exibições por dia, semana e mês não têm suporte.
Assim como nos leaderboards globais, um chamador pode ler uma "página" de até 100 entradas de leaderboard (XUID do jogador, gamertag, posição global e pontuação) por vez e especificar a posição inicial da página.
Os leaderboards sociais são acessados por meio da XSAPI ou da nossa API REST usando `GET (/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite})`.
## Leaderboards globais com exibição social
Como os leaderboards sociais são criados dinamicamente, recuperar um leaderboard social leva mais tempo do que recuperar um leaderboard global. Para cenários em que seu título recupera com frequência um leaderboard social com base em um conjunto comum de critérios, você pode criar um leaderboard global e recuperar somente as entradas do leaderboard que pertencem ao grafo social do jogador.
Isso resulta em um tempo de recuperação mais rápido do que o dos leaderboards sociais, porque o leaderboard já existe nos servidores dos serviços XBOX. Também resulta em um payload menor, porque os resultados se limitam ao grafo social do usuário. Esse tipo de leaderboard é um leaderboard global. Portanto, ele deve ser definido na configuração de serviço do título.
Os leaderboards globais com exibição social são acessados usando a solicitação normal de leaderboard global, `GET (/scids/{scid}/leaderboards/{leaderboardname})`, e acrescentando a seguinte consulta à URL: `&viewTarget=people&view=people`.
Para dar suporte a exibições de leaderboard com várias colunas, é possível usar metadados de estatísticas. Um título pode definir campos de metadados para uma estatística de leaderboard, que podem ser retornados ao consultar as posições do leaderboard. Um título não deve usar o URI de estatísticas de usuário em lote para obter o mesmo comportamento, porque as configurações de privacidade podem impedir o acesso às estatísticas.
## Leaderboards com várias colunas
Haverá casos em que você precisará de mais colunas em um leaderboard para dar mais informações à estatística. Por exemplo, em um leaderboard de mais inimigos derrotados, talvez você queira adicionar a arma que o jogador usou, o mapa onde aconteceu, o tipo de inimigo mais derrotado e a proporção de abates/mortes.
Os leaderboards do XBOX têm suporte interno a várias colunas. Você pode obter facilmente esses tipos de classificação. O único pré-requisito é que a estatística usada para o leaderboard tenha um contexto de estatística definido. É ele que será usado como metadados adicionais. Por exemplo, para uma estatística FastestLap, talvez você queira configurar estas propriedades adicionais como contexto de estatística. Veja uma captura de tela de como elas poderiam ficar.
Agora que a estatística será mantida com contexto, se você recuperar o leaderboard com várias colunas, ele terá uma aparência semelhante à da tabela a seguir.
| Operador | Valor (FastestLap) | CarModel | WeatherCondition | TrackId |
| - | - | - | - | - |
| SUM | Constante ou campo | Model A | Rainy | 9 |
| MIN | Campo | Model A | Sunny | 9 |
| MAX | Campo | Model B | Sunny | 2 |
| REPLACE | Constante ou campo | Model C | Cloudy | 1 |
Atualmente, os leaderboards com várias colunas têm suporte em leaderboards globais e em leaderboards globais com exibição social. No entanto, se você quiser criar um leaderboard *social* com várias colunas, pode usar a chamada de estatísticas de usuário em lote para obter todas as estatísticas com seu contexto e, em seguida, criar o leaderboard manualmente.
Os leaderboards com várias colunas só são acessados por meio da nossa API REST usando a solicitação normal de leaderboard global, `GET (/scids/{scid}/leaderboards/{leaderboardname})`, e acrescentando a seguinte consulta à URL: `&include=valuemetadata`.
## Onde aparecem os leaderboards com estatísticas em destaque
Os leaderboards comparam os jogadores mostrando estatísticas selecionadas de um jogo.
Os leaderboards são uma ótima forma de incentivar a competição entre seus jogadores. Eles mantêm os jogadores engajados em tentar superar sua melhor pontuação anterior e as pontuações dos amigos.
* Os leaderboards de estatísticas em destaque são sempre exibidos no clube oficial de um título.
* Os leaderboards de estatísticas em destaque às vezes são exibidos em outras experiências XBOX, como a exibição de conquistas de um jogador no perfil dele.
* Você também pode usar as estatísticas em destaque configuradas para criar leaderboards dentro do seu título.
## Escolhendo bons leaderboards
Um leaderboard corresponde a uma estatística que você definiu.
Você deve escolher leaderboards que correspondam a uma realização que o jogador possa se esforçar para melhorar.
Por exemplo, Best Lap Time em um jogo de corrida é um bom leaderboard, porque os jogadores querem se esforçar para melhorar seu melhor tempo de volta.
Outros exemplos são a proporção de abates/mortes em jogos de tiro ou Max Combo Size em um jogo de luta.
## Quando exibir leaderboards
Você pode exibir leaderboards a qualquer momento no seu título.
Você deve escolher um momento em que o leaderboard não interfira na jogabilidade nem no fluxo do seu título.
Por exemplo, entre rodadas e após partidas são bons momentos para exibir leaderboards.
## Guia de programação
Há várias APIs de leaderboard que você pode usar para obter o estado atual de um leaderboard.
Todas as APIs são assíncronas e não bloqueiam.
Faça uma solicitação para obter os dados do leaderboard e continue o processamento normal do jogo.
Quando os resultados do leaderboard forem retornados pelo serviço, você poderá exibi-los no momento apropriado.
Solicite os dados do leaderboard ao serviço um pouco antes do momento em que deseja exibi-los. Isso evita que os jogadores fiquem bloqueados enquanto aguardam a exibição do leaderboard.
## Veja também
[Estatísticas baseadas em eventos vs. gerenciadas pelo título](/pt-BR/services/xbox-services/player-data/stats-leaderboards/live-stats-eb-vs-tm#update-frequency).
## Related topics
- [Estatísticas e leaderboards baseados em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/live-statslb-eb-nav.md)
- [Visão geral dos eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/events/live-game-events.md)
- [Visão geral dos Dados do jogador baseados em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/live-how-data-platform-works.md)
- [Configuração no portal de estatísticas e leaderboards baseados em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-statslb-eb-config-nav.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)