# Ranking

> O placar de pontos da conta: quem mais pontuou no período, participantes, total e média, o filtro por produto e quanto tempo os pontos levam para aparecer.

O Ranking é o placar da conta: os alunos com mais pontos num período. É o mesmo ranking que o aluno vê na área dele, com filtros para o administrador. Use para ver quem se destaca ou para escolher os vencedores de um desafio.

## Como funciona

O aluno ganha pontos quando faz algo que a conta pontua. Por exemplo: concluir uma aula, passar numa prova, comentar. O ranking soma os pontos do período e ordena os alunos. Se dois alunos empatam, vence a ordem alfabética do nome.

O relatório fica em **Relatórios > Ranking**, no grupo **Engajamento**.

## O que a tela mostra

- **Os números do período.** **Participantes** (quantos alunos pontuaram), **Total de pontos** e **Média por aluno**.
- **O pódio.** Os três primeiros, com foto, nome e pontos.
- **Demais posições**, do quarto lugar em diante: **Posição**, **Aluno** (nome e e-mail), **Pontos no período** e **Último acesso em**.

Clique numa linha para abrir o perfil do aluno (**Ver aluno**). Isso pede a permissão de ver alunos. Sem ela, a linha não abre.

O ranking vai até a 100ª posição. A lista carrega em blocos de 12 com **Carregar mais resultados**.

Se ninguém pontuou no filtro escolhido, a tela mostra **Ranking vazio**.

## Os filtros

- **Período**: **Este mês** (o padrão), **Mês passado**, **Todos** ou **Personalizado**. O chip **Período** abre **De** e **Até** para escolher um intervalo. Mês quer dizer o mês inteiro do calendário.
- **Produto**: um ou mais produtos. Com o chip, só contam os pontos ganhos nesses produtos. Sem o chip, é o placar geral da conta.

O ranking de um produto também fica dentro do produto. Em **Conteúdo > Produtos**, abra o produto. No cabeçalho, o grupo **Relatórios** tem a aba **Ranking**. É esta mesma tela, já filtrada pelo produto.

## Quando os pontos aparecem

**Atenção: o ranking não é instantâneo.**

- **No relatório do painel**, os pontos automáticos (aulas, provas, comentários) entram em cerca de 15 minutos. Os ajustes manuais entram na hora.
- **Na área do aluno**, o ranking atualiza uma vez por dia e mostra os 20 primeiros. Por isso, "meus pontos subiram, mas a posição não mudou" no mesmo dia é esperado.

## Bom saber

- **Ajuste manual sem produto.** Ele conta no placar geral, mas não no ranking de um produto. Para premiar o desempenho num curso, ligue o ajuste ao curso.
- **Aluno na lixeira.** Ele sai do ranking. Se for restaurado, volta com os mesmos pontos.
- **Mudar a pontuação não recalcula o passado.** Quem concluiu uma aula quando ela valia 10 pontos continua com 10.

## Perguntas frequentes

**Posso ver de onde vieram os pontos de um aluno?** Sim. Abra o perfil dele pelo ranking. A aba de pontuações lista cada lançamento com o motivo (veja [Perfil do aluno](https://help.cademi.cloud/pt/alunos/perfil-do-aluno.md)).

**O aluno aparece no ranking da conta, mas não no do produto. Por quê?** Os pontos dele vieram de outro produto ou de um ajuste manual sem produto. O ranking de um produto só soma o que foi ganho nele.

**Meus pontos subiram e a posição não mudou.** Na área do aluno, o ranking atualiza uma vez por dia. A posição muda no dia seguinte.