> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.drimify.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Classificação de Jogadores

|| **A funcionalidade de tabela de classificação é uma extensão adicional.**

Permite que os participantes vejam onde se posicionam em relação a outros utilizadores:

* Durante a experiência do jogo, se a tabela de classificação for exibida através do link de partilha ou código de integração separado
* No final da experiência, se a tabela de classificação estiver ativada, estará disponível através de um botão no ecrã final

# Configurar a Tabela de Classificação

Pode configurar a tabela de classificação na etapa de **criação das definições**. Pode gerir diferentes elementos da tabela:

* **Exibição do participante:** a forma como o nome do jogador é mostrado na tabela: nome completo, nome abreviado, identificador único, nome de utilizador, anónimo, formato personalizado ou com base num ficheiro que forneça em formato JSON

* **Número máximo de entradas:** quantas entradas e linhas na tabela serão exibidas no ranking, entre 5 e 100.

* **Agregação de pontuação:** se um participante jogar várias vezes, pode escolher o método de agregação de pontuação: baseado no identificador único, endereço de e-mail, nome de utilizador, ou número de telefone (ou não agregar as pontuações)

###### Período da Classificação

A definição **Período de Tabela de Classificação** permite definir o tempo pelo qual as pontuações e resultados dos jogadores são exibidos. Ao selecionar um período específico, pode destacar o desempenho com base em períodos diários, semanais, mensais ou totalmente personalizados.

###### Opções disponíveis:

* **Todo o Tempo** – Mostra todos os resultados desde que a tabela de classificação foi ativada pela primeira vez.
* **Dia Atual** – Mostra apenas as pontuações de hoje.
* **Dia Anterior** – Mostra as pontuações de ontem.
* **Semana Atual** – Exibe resultados da semana de calendário em curso.
* **Semana Anterior** – Exibe resultados da última semana de calendário.
* **Mês Atual** – Exibe resultados do mês de calendário em curso.
* **Mês Anterior** – Exibe resultados do último mês de calendário.
* **Trimestre Atual** – Exibe resultados do trimestre de calendário em curso.
* **Trimestre Anterior** – Exibe resultados do último trimestre de calendário.
* **Ano Atual** – Exibe resultados do ano em curso.
* **Ano Anterior** – Exibe resultados do último ano.
* **Datas Personalizadas** – Permite selecionar manualmente uma data de início e fim para definir o período da classificação.
* **Período Relativo** – Permite definir um período móvel (por exemplo, os últimos 7 dias, últimos 30 dias, etc.), independentemente de datas de calendário fixas.

# Filtrar a Tabela de Classificação por Data (Parâmetros de Consulta de String)

É possível exibir a tabela de classificação para um intervalo de datas específico, adicionando parâmetros de consulta de string ao URL do seu jogo.
## Parâmetros Disponíveis

Pode utilizar os seguintes parâmetros:
* `leaderboardStart`
* `leaderboardEnd`

Estes permitem-lhe definir uma data de início e fim personalizada para os resultados exibidos na tabela de classificação.

## Exemplo

```
https://yourgameurl.com?leaderboardStart=2024-01-01&leaderboardEnd=2024-01-31
```

Neste exemplo, a tabela de classificação apenas exibirá resultados entre **1 de janeiro de 2024** e **31 de janeiro de 2024**.

## Notas Importantes

* As datas devem ser formatadas da seguinte forma: `AAAA-MM-DD`
* Ambos os parâmetros podem ser usados em conjunto para definir um período específico
* Se nenhum parâmetro for fornecido, a configuração padrão da tabela de classificação será aplicada
* Esses parâmetros devem ser adicionados ao final do URL do seu jogo

Várias opções adicionais de exibição:

* tempo de exibição
* O número de entradas
* não exibir o botão do placar no ecrã final
* Um botão abaixo da tabela de classificação para retornar ao início da aplicação
* A tabela de classificação também pode ter a sua própria data de desativação, que será diferente da aplicação.### Em que consiste?

No topo da tabela está o número de participantes (se aplicável), seguido pela tabela de classificação visível para os participantes. A ordem das colunas é:

* A posição do participante no ranking
* O seu nome de usuário (anônimo, nome completo, nome abreviado, identificador único, etc.)
* A sua pontuação
* Tempo (se ativado)

|| Note que, em caso de empate em pontuação, o tempo levado é o critério de desempate mais comum.

### Como é que a tabela de classificação se apresenta?

Veja [um exemplo de uma tabela de classificação em produção](https://apps.drimify.com/3gpfk4kA/?l=1).

![Exemplo de uma tabela de classificação](https://storage.crisp.chat/users/helpdesk/website/b5930908db9b0800/screenshot-77_92skub.png)

# Com que frequência é atualizada a tabela de classificação?

A tabela de classificação é atualizada automaticamente e em tempo real após cada nova entrada.

# Onde posso encontrar o link para compartilhar a tabela de classificação e o código de integração?

Um **URL** único para a tabela de classificação está disponível na etapa de **publicação** do seu jogo ou módulo interativo e pode ser encontrado na secção de **link direto**.

Pode incorporar a tabela de classificação numa página específica do seu site ou distribuí-la através de um botão numa newsletter. Também pode apresentar a tabela de classificação num ecrã separado para acompanhar as pontuações em tempo real.

O código para incorporar a tabela de classificação está disponível logo abaixo, também na etapa de **publicação**, na secção de **código de incorporação HTML iframe**.

![URL e código de incorporação para a tabela de classificação](https://storage.crisp.chat/users/helpdesk/website/b5930908db9b0800/screenshot-78_1lyy6sc.png)