# Gamificação

> Pontos e ranking na área do aluno: que ações dão pontos e quanto valem, como o ranking aparece, o que tira pontos e como ajustar à mão.

A gamificação dá pontos ao aluno quando ele estuda e participa, e mostra um ranking na área do aluno. Por exemplo: concluir uma aula vale 10 pontos. Você configura tudo em **Configurações > Gamificação**.

## A ideia em um minuto

- Uma **ação** é algo que o aluno faz e que dá pontos: concluir uma aula, ser aprovado numa prova, comentar.
- Cada vez que o aluno faz uma ação ligada, a Cademí registra um **lançamento** no extrato de pontos dele, com o motivo.
- O **ranking** soma os lançamentos de um período e ordena os alunos.

Os pontos servem só para ordenar. Não há níveis, medalhas nem prêmios. Se você quer premiar os primeiros, entregue o prêmio fora da plataforma.

**A regra mais importante:** uma mudança na pontuação vale só para o que acontece depois. Ela nunca recalcula os pontos que os alunos já ganharam.

A tela tem duas abas, **Ranking** e **Pontuação**. As duas fazem parte do mesmo formulário. Mude o que quiser e clique em **Salvar agora** uma vez.

## O que o aluno vê no ranking

O painel **Exibição do ranking** fica na aba **Ranking**:

- **Exibir ranking** mostra o ranking de pontos na área do aluno. Desligado, os alunos continuam ganhando pontos, mas não veem o placar.
- **Exibir total de participantes** acrescenta "entre N alunos" à linha com a posição do aluno. O número é o total de alunos da conta, não só os que já pontuaram.
- **Exibir nome completo** mostra o nome inteiro de cada aluno. Desligado, mostra o primeiro nome e a inicial do sobrenome, como "Ana S.".

As duas últimas opções só aparecem com **Exibir ranking** ligado.

O ranking da área do aluno tem três períodos:

- **Semana** e **Mês** contam só os pontos ganhos naquele período do calendário. Eles recomeçam quando o período vira. Assim, um aluno novo tem chance contra os veteranos.
- **Geral** conta todos os pontos.

A área do aluno mostra os 20 primeiros. A sua equipe vê até 100 posições, com filtros, em [Relatórios > Ranking](https://help.cademi.cloud/pt/relatorios/ranking.md). Num empate, a ordem é alfabética, pelo nome. Alunos excluídos não aparecem.

## Que ações dão pontos

Na aba **Pontuação** há dois painéis:

- **Ações que pontuam**: o **Perfil de pontuação** preenche a tabela inteira com uma estratégia pronta.
- **Pontuação por ação**: você ajusta cada ação.

### Os perfis de pontuação

| Perfil | Estratégia | Use quando |
|---|---|---|
| **Equilibrado** | Recompensa um pouco de tudo, mas pesa mais as conquistas (prova, conclusão, certificado) | Você está começando ou ainda não conhece o hábito da turma |
| **Incentivar interação** | Comentários e dúvidas valem mais que aulas. Todo comentário pontua. Marcos e certificado ficam desligados | As aulas não recebem comentários e a comunidade está parada |
| **Incentivar conclusão** | Recompensas crescentes ao longo do conteúdo. Concluir vale muito. Dúvidas não pontuam | Muitos começam e poucos terminam |

Escolher um perfil substitui os valores da tabela. Nada é gravado antes de você salvar. Depois, você pode ajustar os valores. Se um valor sai do perfil, a tela mostra **Personalizado**. **Personalizado** não é um perfil: é só o aviso de que a tabela não segue nenhum deles.

Os valores de cada perfil:

| Ação | Equilibrado | Incentivar interação | Incentivar conclusão |
|---|---|---|---|
| **Comentário enviado** | 5 (só o primeiro de cada aula) | 20 (todos os comentários) | 5 (só o primeiro de cada aula) |
| **Dúvida enviada** | 5 | 15 | desligada |
| **Conteúdo iniciado** | desligada | desligada | 5 |
| **Aula concluída** | 10 | 5 | 10 |
| **50% do conteúdo concluído** | 25 | desligada | 30 |
| **75% do conteúdo concluído** | 25 | desligada | 50 |
| **90% do conteúdo concluído** | 25 | desligada | 75 |
| **Prova aprovada** | 50 | 20 | 50 |
| **Conteúdo concluído** | 100 | 50 | 200 |
| **Certificado emitido** | 50 | desligada | 100 |

### A pontuação de cada ação

A tabela **Pontuação por ação** lista as dez ações em três grupos: **Interação**, **Progresso** e **Conquista**. As colunas são **Ação**, **Status**, **Pontos** e **Regra**. Cada ação tem um interruptor e um valor de pelo menos 1 ponto. Valor zero não existe: para uma ação parar de pontuar, desligue a ação.

| Ação | Quando pontua | Quantas vezes |
|---|---|---|
| **Comentário enviado** | O aluno envia um comentário ou uma resposta, antes de qualquer moderação | Depende da **Regra**: **Apenas o primeiro de cada aula** ou **Todos os comentários** |
| **Dúvida enviada** | O aluno envia uma dúvida numa aula, antes de ela ser respondida | Uma vez por aula |
| **Conteúdo iniciado** | O aluno conclui a primeira aula de um produto (não quando recebe o acesso) | Uma vez por produto |
| **Aula concluída** | A aula passa de não concluída para concluída | Uma vez por aula |
| **50%, 75% e 90% do conteúdo concluído** | O progresso no produto passa o marco | Uma vez por marco, por produto |
| **Prova aprovada** | Uma tentativa terminada é aprovada | Uma vez por prova |
| **Conteúdo concluído** | O progresso no produto chega a 100% | Uma vez por produto |
| **Certificado emitido** | Um certificado é emitido, inclusive por um administrador | Uma vez por produto, mesmo se for emitido de novo |

Os limites de "uma vez" impedem que alguém acumule pontos repetindo a mesma coisa. Não dão pontos novos:

- desmarcar e marcar a aula de novo;
- zerar o progresso e passar os marcos outra vez;
- refazer uma prova já aprovada;
- emitir de novo um certificado.

Um salto de progresso que passa vários marcos de uma vez dá todos os marcos passados. Por exemplo: de 40% para 80%, o aluno ganha o de 50% e o de 75%.

**Atenção:** a regra **Todos os comentários** tira a última proteção contra spam. Cada comentário e cada resposta passam a pontuar. Use essa regra com as regras de comentário da conta ([Comentários](https://help.cademi.cloud/pt/atendimento/comentarios.md)) e com moderação, se a comunidade for grande.

## Passo a passo

1. Abra **Configurações > Gamificação > Ranking**.
2. Ligue **Exibir ranking**.
3. Escolha se mostra o **total de participantes** e o **nome completo**.
4. Abra a aba **Pontuação**.
5. Clique num **Perfil de pontuação** para preencher a tabela.
6. Se quiser, ajuste cada ação em **Pontuação por ação**: ligue a ação e defina os **Pontos**.
7. Em **Comentário enviado**, escolha a **Regra**.
8. Clique em **Salvar agora**.

## O que tira pontos

Só uma correção de prova tira pontos sozinha. Se você reabre uma tentativa ou remove um resultado, o aluno perde todos os pontos que aquela prova deu. Ele pode ganhá-los de novo se for aprovado outra vez, pelo valor que vale nesse momento. A aula da prova volta a não concluída, mas os pontos da conclusão da aula ficam.

Estas ações **não** tiram pontos:

- desmarcar uma aula ou zerar o progresso;
- revogar um certificado;
- excluir, ocultar ou recusar um comentário ou uma dúvida;
- revogar uma matrícula.

Um aluno excluído sai do ranking. Se ele for restaurado, volta com o mesmo total.

## Ajustes manuais

Um administrador pode somar ou tirar pontos no perfil do aluno, em **Adicionar Pontos** ([Perfil do aluno](https://help.cademi.cloud/pt/alunos/perfil-do-aluno.md)). Use para:

- corrigir um erro;
- compensar alunos depois de uma mudança de configuração;
- premiar algo que a plataforma não acompanha, como um evento ao vivo ou um concurso.

Regras do ajuste:

- O valor pode ser positivo ou negativo, nunca zero.
- O motivo é obrigatório.
- O ajuste aparece no ranking na hora.
- Só lançamentos feitos à mão podem ser excluídos. Pontos de aulas, provas e certificados não.
- Um ajuste sem produto conta no ranking geral, mas não no ranking de um produto. Para premiar o desempenho num curso, ligue o ajuste a esse curso.

## Bom saber

- **Mudanças não são retroativas.** Mudar um valor, ou ligar e desligar uma ação, vale só para o que acontece depois. Se a aula passa de 10 para 20 pontos, as conclusões antigas ficam em 10. Se uma ação estava desligada quando o aluno a fez, nada é dado pelo passado. Não existe "recalcular todos". Para compensar alunos, use um ajuste manual.
- **Conta que nunca salvou a pontuação.** Enquanto a tabela nunca foi salva, toda ação vale 1 ponto, mesmo que a tela mostre as ações desligadas. Depois do primeiro **Salvar agora**, só as ações ligadas pontuam.
- **O ranking não é ao vivo.** Na área do aluno, os pontos automáticos entram no ranking até o dia seguinte. A página diz **Atualizado a cada 24 horas**. Ajustes manuais entram na hora. O total e o extrato do próprio aluno mudam logo depois de cada ação. Por isso, "meus pontos subiram, mas minha posição não mudou" no mesmo dia é normal.
- **Testar sem dar pontos.** Se você vê a área como aluno de teste (a prévia), nada pontua. Se você entra como um aluno real, concluir aulas e passar em provas dá pontos de verdade a esse aluno.
- **Privacidade.** Numa conta com cuidados de privacidade (treinamento corporativo, menores de idade), desligue o nome completo ou não exiba o ranking.

## Perguntas frequentes

**Aumentei o valor da aula e os alunos antigos continuaram com menos pontos.** É assim mesmo: a mudança vale para as conclusões seguintes. Se a justiça entre turmas importa, compense os alunos antigos com um ajuste manual.

**Apaguei um comentário ofensivo e os pontos dele ficaram.** Excluir, ocultar ou recusar um comentário não tira pontos. Para parar o spam por pontos, use **Apenas o primeiro de cada aula** e as regras de comentário da conta. Para tirar os pontos de um aluno, faça um ajuste negativo no perfil dele.

**O aluno reclamou que a posição dele não mudou.** O ranking da área do aluno é atualizado a cada 24 horas. O extrato e o total dele já mostram os pontos novos. A posição muda no dia seguinte.

**Desliguei o ranking. Os alunos perdem os pontos?** Não. Com **Exibir ranking** desligado, os alunos continuam ganhando pontos. Eles só não veem o placar.