> 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 placares classificam os participantes do seu programa em relação aos demais, incentivando-os a concluir os objetivos do programa e estimulando a competição pelas primeiras posições. Você pode adicionar um placar ao seu widget de acesso verificado ou microsite e personalizá-lo como os outros componentes.

Os placares podem ser configurados de várias maneiras para atender melhor aos objetivos do seu programa. Para saber mais sobre as diferentes opções, consulte [Entenda os placares](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md).

{% hint style="warning" %}
Este recurso está disponível apenas em algumas edições ou por meio de complementos do impact.com. [Entre em contato conosco](https://app.impact.com/support/portal.ihtml?createTicket=true&) para fazer upgrade da sua conta e ter acesso!
{% endhint %}

{% stepper %}
{% step %}
**Etapa 1: Ative os placares**

Antes de começar a configurar os placares, entre em contato com seu gerente de estratégia do programa (PSM) ou crie um [chamado de suporte](mailto:advocate-support@impact.com) para ativar o recurso Placares no seu programa.
{% endstep %}

{% step %}
**Etapa 2: Adicione um placar ao widget ou microsite**

1. Acesse seu widget ou microsite selecionando ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Conteúdo → Editar widgets** ou **Editar conteúdo**.
   * Se você ainda não configurou um widget ou microsite, precisará fazer isso primeiro.

     <div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FvbZxfC4IoKEUzksFMMpP%2FScreenshot%202026-05-19%20at%2009.40.45.png?alt=media&amp;token=a9d78fa1-417e-4f8e-b517-5eeb441cd41c" alt=""><figcaption></figcaption></figure></div>
2. Selecione a página do widget ou microsite que deseja editar.
   * Saiba como [editar o conteúdo do widget](https://help.impact.com/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](https://help.impact.com/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 componente **Placar** .
   * Se você não encontrar o componente *Placar* será necessário instalar primeiro um pacote do Mint Components:
     * **Instalar o Mint Components para widget**
       1. No menu da barra lateral esquerda, selecione **Packages → Add package**.
          1. No cartão *Mint Components* , selecione **Adicionar**.
          2. Agora você poderá expandir o componente **Placar** no menu da barra lateral direita.
     * **Instalar o Mint Components para microsite**
       1. Volte à tela *Conteúdo* selecionando **→ \[Engage] Conteúdo** na barra de navegação à esquerda ou no menu superior.
       2. No cartão *Microsite* , selecione **Editar configurações**.
       3. Role a página até encontrar o campo *Pacotes* e selecione **Adicionar pacote**.
       4. No cartão *Mint Components* , selecione **Adicionar**.
       5. Selecionar **Salvar configuração** e voltar ao editor.
4. Selecione um tipo de **Classificação**.
   * Para ver uma descrição de cada classificação disponível, consulte [Entenda as classificações](https://help.impact.com/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 botão azul **Adicionar a** na tela onde você quer que o componente apareça.

<figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FaXBEZtX1RjI2nfInBYFp%2FScreenshot%202026-05-19%20at%2009.44.33.png?alt=media&amp;token=4c43c5dd-8f20-4221-9971-1199cb9e2129" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Etapa 3: personalizar a classificação**

{% tabs %}
{% tab title="Editar" %}

1. Na tela, selecione o componente de classificação que você quer editar.
2. Use as opções na guia **Editar** do menu da barra lateral direita para alterar as propriedades da classificação.
   * Se quiser inserir um link em um componente de texto, você pode fazer isso selecionando ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-63c2caf34c8c42984b458d40b5ac087e03360307%2Fc5fc23a16175bc8c8603fda06785d3d10c8d687bb14c7c6f1424d705c272963e.svg?alt=media) **\[Visualização de código]** e editando o HTML do widget ou microsite.
3. Selecione **Salvar rascunho** quando terminar.

**Referência dos campos de edição**

| Configuração                          | Descrição                                                                                                                                                                                                                                                                                                         |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Texto para usuário desconhecido       | Insira o nome de exibição padrão para usuários sem nome, por exemplo, *Usuário anônimo*.                                                                                                                                                                                                                          |
| Ocultar usuário que está visualizando | Ative para ocultar a linha do participante que está visualizando, caso ele não esteja entre as primeiras posições exibidas.                                                                                                                                                                                       |
| Intervalo de tempo da classificação   | Insira uma data de início e uma data de término para o período cujos resultados da classificação você quer ver, no formato `mm/dd/yyyy`.                                                                                                                                                                          |
| Tipo de classificação                 | Selecione o sistema de pontuação que você quer usar. Para saber mais sobre os sistemas de pontuação disponíveis, consulte [Entenda as classificações](https://help.impact.com/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               | Insira o número máximo de linhas a serem exibidas na classificação.                                                                                                                                                                                                                                               |
| Programa                              | Selecione um programa para limitar os resultados da classificação aos participantes desse programa. Para ver os resultados de todos os programas, não selecione nenhum programa.                                                                                                                                  |
| Tipo de classificação                 | Para saber mais sobre os tipos de sistemas de classificação disponíveis, consulte [Entenda as classificações](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md).                                         |
| Título da coluna de posição           | Insira o nome que você quer exibir para a coluna *Posição* .                                                                                                                                                                                                                                                      |
| Mostrar posição na classificação      | ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Ative]** se quiser que a classificação exiba a coluna *Posição* .                         |
| Título da coluna de estatísticas      | Digite o nome que deseja exibir na coluna com as pontuações dos participantes.                                                                                                                                                                                                                                    |
| Título da coluna de usuários          | Digite o nome que deseja exibir na coluna com os nomes dos participantes.                                                                                                                                                                                                                                         |
| {% endtab %}                          |                                                                                                                                                                                                                                                                                                                   |

{% tab title="Mover" %}

1. Na tela de edição, selecione o componente que deseja mover.
2. Selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9e2a26b918e7394cf67e8a26e3713e081b203ac9%2F15d049b0c04d1c54c39dbbb5a7cd2ba64d86f1f99220111674e768744ea7ceb9.svg?alt=media) **\[Mover]**.
   * Não é possível mover alguns componentes. A opção ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9e2a26b918e7394cf67e8a26e3713e081b203ac9%2F15d049b0c04d1c54c39dbbb5a7cd2ba64d86f1f99220111674e768744ea7ceb9.svg?alt=media) **\[Mover]** só será exibida se houver outro local válido na tela de edição para onde o componente possa ser movido.
3. Selecione o botão azul **Mover para** para onde deseja mover o componente.
4. Selecione **Salvar**.
   {% endtab %}

{% tab title="Remover" %}

1. Na tela de edição, selecione o componente que deseja remover.
2. Selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fe3GCJYT1vVzaTSMmeCgp%2Ftrash-alt-solid.svg?alt=media\&token=b5b84aa2-055e-49a1-910c-4b9a88bc2c9d) **\[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=<question>&goal=<user_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.
