> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/set-up-a-leaderboard.md).
# Configurar um ranking
Os rankings classificam os participantes do seu programa junto com outros para incentivá-los a concluir os objetivos do programa e estimular a competição pelas primeiras posições. Você pode adicionar um ranking ao seu widget de acesso verificado ou microsite e personalizá-lo como outros componentes.
Os rankings podem ser configurados de várias maneiras para melhor atender aos objetivos do seu programa. Para mais informações sobre as diferentes opções, consulte [Rankings explicados](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md).
{% hint style="warning" %}
Esse recurso está disponível apenas para edições ou complementos específicos do impact.com. [Fale conosco](https://app.impact.com/support/portal.ihtml?createTicket=true&) para atualizar sua conta e obter acesso!
{% endhint %}
{% stepper %}
{% step %}
**Etapa 1: habilite os rankings**
Antes de começar a configurar os rankings, entre em contato com o seu Gerente de Estratégia do Programa (PSM) ou crie um [chamado de suporte](mailto:advocate-support@impact.com) para habilitar o recurso de rankings para o seu programa.
{% endstep %}
{% step %}
**Etapa 2: adicione o ranking ao widget ou microsite**
1. Acesse seu widget ou microsite selecionando  **\[Engage] → Conteúdo → Editar widgets** ou **Editar conteúdo**.
* Se você ainda não configurou um widget ou microsite, será necessário fazer isso primeiro.
2. Selecione a página do widget ou do microsite que deseja editar.
* Saiba como [editar o conteúdo do widget](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-experiences/customize-program-widgets.md) ou [editar páginas do microsite](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages.md).
3. No menu da barra lateral direita, expanda o **Ranking** componente.
* Se você não vir o *Ranking* componente, primeiro você precisará instalar um pacote Mint Components:
* **Instalar Mint Components para widget**
1. No menu da barra lateral esquerda, selecione **Pacotes → Adicionar pacote**.
1. Na *Mint Components* cartão, selecione **Adicionar**.
2. Agora você já deve conseguir expandir o **Ranking** componente no menu da barra lateral direita.
* **Instalar Mint Components para microsite**
1. Volte para a *Conteúdo* tela selecionando **→ \[Engage] Conteúdo** na sua barra de navegação à esquerda ou no menu superior.
2. Na *Microsite* cartão, selecione **Editar configurações**.
3. Role até ver o *Pacotes* campo e, em seguida, selecione **Adicionar pacote**.
4. Na *Mint Components* cartão, selecione **Adicionar**.
5. Selecione **Salvar configuração** e retorne ao editor.
4. Selecione um tipo de **Ranking**.
* Para ver uma descrição de cada um dos rankings disponíveis, consulte [Rankings explicados](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md#leaderboard-types-0-0).
5. Selecione o azul **Adicionar ao** botão na tela onde você quer que o componente apareça.
{% endstep %}
{% step %}
**Etapa 3: personalize o ranking**
{% tabs %}
{% tab title="Editar" %}
1. Na sua tela, selecione o componente de ranking que deseja editar.
2. Use as opções na **Editar** aba do menu da barra lateral direita para alterar as propriedades do ranking.
* Se você quiser inserir um link em um componente de texto, pode fazê-lo selecionando  **\[Exibição de código]** e editando o HTML do widget ou do microsite.
3. Selecione **Salvar rascunho** quando terminar.
**Referência de campos de edição**
| Configuração | Descrição |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Texto de usuário desconhecido | Digite o nome de exibição padrão para usuários sem nome, por exemplo, *Usuário anônimo*. |
| Ocultar usuário visualizador | Ative para ocultar a linha do participante que está visualizando se ele não estiver entre as principais posições exibidas. |
| Intervalo de tempo do ranking | Digite uma data inicial e uma data final para as quais você deseja ver os resultados do ranking, no formato `dd/mm/aaaa`. |
| Tipo de ranking | Selecione o sistema de pontuação que deseja usar. Para mais informações sobre os sistemas de pontuação disponíveis, consulte [Rankings explicados](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md). |
| Número máximo de linhas | Digite o número máximo de linhas a serem exibidas no ranking. |
| Programa | Selecione um programa para limitar os resultados do ranking aos participantes desse programa. Para ver os resultados globalmente em todos os programas, não selecione um programa. |
| Tipo de classificação | Para mais informações sobre os tipos de sistemas de classificação disponíveis, consulte [Rankings explicados](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md). |
| Cabeçalho da coluna de classificação | Digite o nome da coluna que você deseja exibir para a *Posição* . |
| Exibir posição no ranking |  **\[Ativar]** se você quiser que o ranking exiba a *Posição* . |
| Cabeçalho da coluna de estatísticas | Digite o nome da coluna que você deseja exibir para a coluna que contém as pontuações dos participantes. |
| Cabeçalho da coluna de usuário | Digite o nome da coluna que você deseja exibir para a coluna que contém os nomes dos participantes. |
| {% endtab %} | |
{% tab title="Mover" %}
1. Na sua tela, selecione o componente que deseja mover.
2. Selecione  **\[Mover]**.
* Alguns componentes não podem ser movidos. A  **\[Mover]** opção só aparecerá se houver outro local válido na tela para o componente ser realocado.
3. Selecione o azul **Mover para** botão para onde você quer que o componente vá.
4. Selecione **Salvar**.
{% endtab %}
{% tab title="Remover" %}
1. Na sua tela, selecione o componente que deseja remover.
2. Selecione  **\[Remover]**.
3. Selecione **Salvar**.
{% endtab %}
{% endtabs %}
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/set-up-a-leaderboard.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
