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

# Tabelas de classificação com PlayStream e Telemetry

> Emita eventos de fim de versão e de classificação de entidade das tabelas de classificação do PlayFab para o PlayStream ou o Telemetry para disparar o CloudScript, o Azure Functions ou recompensar os melhores jogadores.

Com a integração das tabelas de classificação ao [PlayStream](/pt-BR/services/playfab/data-analytics/ingest-data/playstream-overview), você pode aproveitar facilmente o pipeline de ingestão e processamento de eventos em tempo real para criar experiências personalizadas para os jogadores, disparadas quando uma versão de uma tabela de classificação muda. Com as [Ações e Regras do PlayStream](/pt-BR/services/playfab/data-analytics/acting-data/action-rules-quickstart), você pode disparar [CloudScripts](/pt-BR/services/playfab/live-service-management/service-gateway/automation/cloudscript) ou [Azure Functions](/pt-BR/services/playfab/live-service-management/service-gateway/automation/cloudscript-af) personalizados para impulsionar recursos de engajamento e retenção, como [conceder recompensas](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory) aos melhores jogadores, enviar notificações personalizadas aos jogadores ou realizar a validação de pontuações para detectar trapaceiros. Os eventos do PlayStream também serão arquivados no Data Explorer para análise e armazenamento de dados.

E, se você quiser apenas a análise e o armazenamento de dados sem as ações de eventos em tempo real, as tabelas de classificação têm uma integração com os [Eventos do Telemetry](/pt-BR/services/playfab/data-analytics/ingest-data/telemetry-overview) para fornecer apenas os recursos de análise.

As tabelas de classificação fornecem dois eventos opcionais:

* [`playfab.leaderboard.leaderboard_version_ended`](/pt-BR/services/playfab/api-references/events/Leaderboards/leaderboard-version-ended)
* [`playfab.leaderboard.entity_rank_on_leaderboard_version_ended`](/pt-BR/services/playfab/api-references/events/Leaderboards/entity-rank-on-leaderboard-version-ended)

Esses dois eventos permitem saber rapidamente quando uma versão de tabela de classificação terminou e consultar os dados anteriores assim que você quiser. Com o evento de classificação de entidade no fim da versão da tabela de classificação, você pode obter a posição e a pontuação da entidade principal de uma tabela de classificação quando essa versão da tabela de classificação terminou.

## Habilitar eventos do PlayStream ou do Telemetry

Você pode habilitar eventos ao criar uma nova tabela de classificação ou ao editar uma definição de tabela de classificação existente. Localize a seção de configuração de eventos do PlayStream e do Telemetry e selecione None, PlayStream ou Telemetry.

<img src="https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/playfab/community/leaderboards/create-leaderboard-with-events.png?fit=max&auto=format&n=5IpvKlT-jmAaVkeY&q=85&s=c45d0ef67226e657e6e7c272ea3c0279" alt="Esta imagem mostra uma tela de configuração para definir parâmetros de eventos, incluindo a frequência de redefinição, os eventos da tabela de classificação e os limites de classificação de entidades." width="1157" height="830" data-path="images/playfab/community/leaderboards/create-leaderboard-with-events.png" />

> **Observação:** As tabelas de classificação preexistentes terão os eventos de fim de versão da tabela de classificação e de classificação de entidade no fim da versão da tabela de classificação desativados por padrão. Se quiser habilitar ambos ou apenas um deles, acesse a tabela de classificação que deseja modificar e habilite essa configuração.

Depois do envio, os eventos serão emitidos sempre que uma versão de tabela de classificação mudar.

## Uso dos eventos

Para saber mais sobre como aproveitar esses eventos para realizar diferentes ações, como conectar-se a uma Azure Function, confira estes recursos:

* [Usar ações do CloudScript com o PlayStream](/pt-BR/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream)
* [Início rápido: escrever um CloudScript do PlayFab usando o Azure Functions](/pt-BR/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart)
* [Início rápido do CloudScript](/pt-BR/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart)

## Restrições e observações

* O evento `playfab.leaderboard.entity_rank_on_leaderboard_version_ended` retornará apenas até as 1000 primeiras posições.

* O evento `playfab.leaderboard.entity_rank_on_leaderboard_version_ended` enviará um evento para cada entrada da tabela de classificação.

* O evento `playfab.leaderboard.entity_rank_on_leaderboard_version_ended` não funcionará com tabelas de classificação com tipo de entidade `master_player_account` ou `external`.

## Confira também

* [`playfab.leaderboard.leaderboard_version_ended`](/pt-BR/services/playfab/api-references/events/Leaderboards/leaderboard-version-ended)
* [`playfab.leaderboard.entity_rank_on_leaderboard_version_ended`](/pt-BR/services/playfab/api-references/events/Leaderboards/entity-rank-on-leaderboard-version-ended)
* [Visão geral do PlayStream](/pt-BR/services/playfab/data-analytics/ingest-data/playstream-overview)
* [Statistics com PlayStream e Telemetry](/pt-BR/services/playfab/player-progression/statistics/statistics-with-playstream-and-telemetry).
* [Visão geral do Telemetry](/pt-BR/services/playfab/data-analytics/ingest-data/telemetry-overview)
* [Medidores de preços](/pt-BR/services/playfab/pricing/meters/meters)
* [Recursos de eventos do PlayStream](/pt-BR/services/playfab/data-analytics/ingest-data/playstream-event-capabilities)
* [Usar ações do CloudScript com o PlayStream](/pt-BR/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream)
* [Início rápido: escrever um CloudScript do PlayFab usando o Azure Functions](/pt-BR/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart)
* [Início rápido do CloudScript](/pt-BR/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart)
* [Limites das tabelas de classificação](/pt-BR/services/playfab/community/leaderboards/limits-leaderboards)
* [Tabelas de classificação e CloudScript](/pt-BR/services/playfab/community/leaderboards/leaderboards-cloudscript).


## Related topics

- [Visão geral das tabelas de classificação do PlayFab](/pt-BR/services/playfab/community/leaderboards/index.md)
- [Tabelas de classificação sazonais](/pt-BR/services/playfab/community/leaderboards/seasonal-leaderboards.md)
- [Tabelas de classificação de grupos](/pt-BR/services/playfab/community/leaderboards/group-leaderboards.md)
- [Tabelas de classificação com níveis manuais](/pt-BR/services/playfab/community/leaderboards/manual-tiers.md)
- [Limites das tabelas de classificação](/pt-BR/services/playfab/community/leaderboards/limits-leaderboards.md)
