> 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/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/set-up-a-leaderboard.md).

# Eine Rangliste einrichten

Ranglisten ordnen die Teilnehmer Ihres Programms zusammen mit anderen ein. So motivieren sie die Teilnehmer, die Programmziele zu erreichen, und fördern den Wettbewerb um die Spitzenplätze. Sie können eine Rangliste zu Ihrem Widget für verifizierten Zugriff oder Ihrer Microsite hinzufügen und wie andere Komponenten anpassen.

Ranglisten lassen sich auf vielfältige Weise konfigurieren, damit sie optimal zu den Zielen Ihres Programms passen. Weitere Informationen zu den verschiedenen Optionen finden Sie unter [Ranglisten erklärt](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md).

{% hint style="warning" %}
Diese Funktion ist nur in bestimmten impact.com-Editionen oder als Add-on verfügbar. [Kontaktieren Sie uns](https://app.impact.com/support/portal.ihtml?createTicket=true&) , um Ihr Konto upzugraden und Zugriff zu erhalten!
{% endhint %}

{% stepper %}
{% step %}
**Schritt 1: Ranglisten aktivieren lassen**

Bevor Sie Ranglisten einrichten können, wenden Sie sich an Ihren Program Strategy Manager (PSM) oder erstellen Sie ein [Support-Ticket](mailto:advocate-support@impact.com) , damit die Ranglistenfunktion für Ihr Programm aktiviert wird.
{% endstep %}

{% step %}
**Schritt 2: Rangliste zum Widget oder zur Microsite hinzufügen**

1. Rufen Sie Ihr Widget oder Ihre Microsite auf, indem Sie ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Inhalt → Widgets bearbeiten** oder **Inhalt bearbeiten**.
   * Wenn Sie noch kein Widget oder keine Microsite eingerichtet haben, müssen Sie das zuerst tun.

     <div data-with-frame="true"><figure><img src="https://1698965099-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. Wählen Sie die Widget- oder Microsite-Seite aus, die Sie bearbeiten möchten.
   * Hier erfahren Sie, wie Sie [Widget-Inhalte bearbeiten](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-experiences/customize-program-widgets.md) oder [Microsite-Seiten bearbeiten](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages.md).
3. Klappen Sie im Menü der rechten Seitenleiste die Komponente **Rangliste** auf.
   * Wenn die Komponente *Rangliste* nicht angezeigt wird, müssen Sie zunächst ein Mint-Components-Paket installieren:
     * **Mint Components für Widgets installieren**
       1. Wählen Sie im Menü der linken Seitenleiste **Pakete → Paket hinzufügen**.
          1. Wählen Sie auf der Karte *Mint Components* die Option **Hinzufügen**.
          2. Jetzt sollten Sie im Menü der rechten Seitenleiste die Komponente **Rangliste** aufklappen können.
     * **Mint Components für Microsites installieren**
       1. Kehren Sie zum Bildschirm *Inhalt* zurück, indem Sie in der linken Navigationsleiste oder im oberen Menü **→ \[Engage] Inhalt** auswählen.
       2. Wählen Sie auf der Karte *Microsite* die Option **Einstellungen bearbeiten**.
       3. Scrollen Sie nach unten, bis das Feld *Pakete* angezeigt wird, und wählen Sie dann **Paket hinzufügen**.
       4. Wählen Sie auf der Karte *Mint Components* die Option **Hinzufügen**.
       5. Auswählen **Konfiguration speichern** und zum Editor zurückkehren.
4. Wählen Sie einen Typ von **Rangliste**.
   * Eine Beschreibung der verfügbaren Ranglisten finden Sie unter [Ranglisten erklärt](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md#leaderboard-types-0-0).
5. Wählen Sie die blaue **Hinzufügen zu** Schaltfläche auf der Arbeitsfläche aus, an der die Komponente erscheinen soll.

<figure><img src="https://1698965099-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 %}
**Schritt 3: Rangliste anpassen**

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

1. Wählen Sie auf Ihrer Arbeitsfläche die Ranglistenkomponente aus, die Sie bearbeiten möchten.
2. Verwenden Sie die Optionen auf der Registerkarte **Bearbeiten** im Menü der rechten Seitenleiste, um die Eigenschaften der Rangliste zu ändern.
   * Wenn Sie einen Link in eine Textkomponente einfügen möchten, können Sie dies tun, indem Sie ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-63c2caf34c8c42984b458d40b5ac087e03360307%2Fc5fc23a16175bc8c8603fda06785d3d10c8d687bb14c7c6f1424d705c272963e.svg?alt=media) **\[Codeansicht]** auswählen und den HTML-Code des Widgets oder der Microsite bearbeiten.
3. Wählen Sie **Entwurf speichern** wenn Sie fertig sind.

**Referenz zu den bearbeitbaren Feldern**

| Einstellung                        | Beschreibung                                                                                                                                                                                                                                                                                               |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Text für unbekannte Benutzer       | Geben Sie den Standardanzeigenamen für Benutzer ohne Namen ein, z. B. *Anonymer Benutzer*.                                                                                                                                                                                                                 |
| Anzeigenden Benutzer ausblenden    | Aktivieren Sie diese Option, damit die Zeile des teilnehmenden Benutzers ausgeblendet wird, wenn dieser nicht zu den angezeigten Spitzenplätzen gehört.                                                                                                                                                    |
| Zeitraum der Rangliste             | Geben Sie ein Start- und Enddatum ein, für das Sie die Ergebnisse der Rangliste anzeigen möchten, im Format `mm/dd/yyyy`.                                                                                                                                                                                  |
| Ranglistentyp                      | Wählen Sie das gewünschte Bewertungssystem aus. Weitere Informationen zu den verfügbaren Bewertungssystemen finden Sie unter [Ranglisten erklärt](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md). |
| Maximale Anzahl an Zeilen          | Geben Sie die maximale Anzahl der Zeilen ein, die in der Rangliste angezeigt werden sollen.                                                                                                                                                                                                                |
| Programm                           | Wählen Sie ein Programm aus, um die Ergebnisse der Rangliste auf Teilnehmende dieses Programms zu beschränken. Wenn Sie die Ergebnisse programmübergreifend anzeigen möchten, wählen Sie kein Programm aus.                                                                                                |
| Ranglistentyp                      | Weitere Informationen zu den verfügbaren Ranglistensystemen finden Sie unter [Ranglisten erklärt](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md).                                                 |
| Überschrift der Rangspalte         | Geben Sie den Spaltennamen ein, der für die Spalte *Rang* angezeigt werden soll.                                                                                                                                                                                                                           |
| Rang in der Rangliste anzeigen     | ![](https://1698965099-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) **\[Aktivieren]** wenn die Rangliste die Spalte *Rang* anzeigen soll.                 |
| Spaltenüberschrift für Statistiken | Gib den Spaltennamen ein, der für die Spalte mit den Teilnehmerbewertungen angezeigt werden soll.                                                                                                                                                                                                          |
| Spaltenüberschrift für Benutzer    | Gib den Spaltennamen ein, der für die Spalte mit den Teilnehmernamen angezeigt werden soll.                                                                                                                                                                                                                |
| {% endtab %}                       |                                                                                                                                                                                                                                                                                                            |

{% tab title="Verschieben" %}

1. Wähle auf deiner Arbeitsfläche die Komponente aus, die du verschieben möchtest.
2. Wähle ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9e2a26b918e7394cf67e8a26e3713e081b203ac9%2F15d049b0c04d1c54c39dbbb5a7cd2ba64d86f1f99220111674e768744ea7ceb9.svg?alt=media) **\[Move]**.
   * Einige Komponenten können nicht verschoben werden. Die ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9e2a26b918e7394cf67e8a26e3713e081b203ac9%2F15d049b0c04d1c54c39dbbb5a7cd2ba64d86f1f99220111674e768744ea7ceb9.svg?alt=media) **\[Move]** Option wird nur angezeigt, wenn es auf der Arbeitsfläche einen anderen gültigen Ort gibt, an den die Komponente verschoben werden kann.
3. Wähle die blaue **Verschieben nach** -Schaltfläche an dem Ort aus, an den die Komponente verschoben werden soll.
4. Wähle **Speichern**.
   {% endtab %}

{% tab title="Entfernen" %}

1. Wähle auf deiner Arbeitsfläche die Komponente aus, die du entfernen möchtest.
2. Wähle ![](https://1698965099-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) **\[Remove]**.
3. Wähle **Speichern**.
   {% 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/de/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.
