> 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 Ihre Programmpartizipanten zusammen mit anderen ein, um sie dazu zu motivieren, Programmziele zu erreichen, und den Wettbewerb um die Spitzenplätze zu fördern. Sie können Ihrem verifizierten Zugriffs-Widget oder Ihrer Microsite eine Rangliste hinzufügen und sie wie andere Komponenten anpassen.

Ranglisten können auf verschiedene Weise konfiguriert werden, um den Zielen Ihres Programms bestmöglich zu entsprechen. Weitere Informationen zu den verschiedenen Optionen finden Sie unter [Ranglisten erklärt](/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 für bestimmte impact.com-Editionen oder Add-ons verfügbar. [Kontaktieren Sie uns](https://app.impact.com/support/portal.ihtml?createTicket=true&) um Ihr Konto zu upgraden und Zugriff zu erhalten!
{% endhint %}

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

Bevor Sie mit der Einrichtung von Ranglisten beginnen können, wenden Sie sich an Ihren Program Strategy Manager (PSM) oder erstellen Sie ein [Support-Ticket](mailto:advocate-support@impact.com) um die Funktion „Ranglisten“ für Ihr Programm aktivieren zu lassen.
{% endstep %}

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

1. Navigieren Sie zu Ihrem Widget oder Ihrer Microsite, 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] → Inhalte → Widgets bearbeiten** oder **Inhalte 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.
   * Erfahren Sie, wie Sie [Widget-Inhalt bearbeiten](/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](/brand/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages.md).
3. Erweitern Sie im rechten Seitenleistenmenü die **Rangliste** Komponente aus.
   * Wenn Sie die *Rangliste* Komponente nicht sehen, müssen Sie zunächst ein Mint-Components-Paket installieren:
     * **Mint Components für Widget installieren**
       1. Wählen Sie im linken Seitenleistenmenü **Pakete → Paket hinzufügen**.
          1. Auf dem *Mint Components* Karte auswählen **Hinzufügen**.
          2. Sie sollten nun in der Lage sein, die **Rangliste** Komponente im rechten Seitenleistenmenü zu erweitern.
     * **Mint Components für Microsite installieren**
       1. Kehren Sie zum *Inhalt* Bildschirm zurück, indem Sie **→ \[Engage] Inhalte** in Ihrer linken Navigationsleiste oder Ihrem oberen Menü auswählen.
       2. Auf dem *Microsite* Karte auswählen **Einstellungen bearbeiten**.
       3. Scrollen Sie, bis Sie das *Pakete* Feld sehen, und wählen Sie dann **Paket hinzufügen**.
       4. Auf dem *Mint Components* Karte auswählen **Hinzufügen**.
       5. Wählen Sie **Konfiguration speichern** und kehren Sie zum Editor zurück.
4. Wählen Sie einen Typ von **Rangliste**.
   * Eine Beschreibung der einzelnen verfügbaren Ranglisten finden Sie unter [Ranglisten erklärt](/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 **Zu hinzufügen** Schaltfläche auf der Leinwand aus, auf 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 Leinwand die Ranglisten-Komponente aus, die Sie bearbeiten möchten.
2. Verwenden Sie die Optionen im **Bearbeiten** Tab des rechten Seitenleistenmenüs, 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 das HTML des Widgets oder der Microsite bearbeiten.
3. Wählen Sie **Entwurf speichern** wenn Sie fertig sind.

**Referenz zum Bearbeiten von Feldern**

| Einstellung                        | Beschreibung                                                                                                                                                                                                                                                                                        |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Text für unbekannten Benutzer      | Geben Sie den standardmäßigen Anzeigenamen für Benutzer ohne Namen ein, z. B. *Anonymer Benutzer*.                                                                                                                                                                                                  |
| Anzeigenden Benutzer ausblenden    | Aktivieren Sie diese Option, um die Zeile des betrachtenden Teilnehmers auszublenden, wenn er nicht zu den oben angezeigten Rängen gehört.                                                                                                                                                          |
| Zeitintervall der Rangliste        | Geben Sie ein Start- und Enddatum ein, für das Sie Ranglistenergebnisse anzeigen möchten, im Format `MM/TT/JJJJ`.                                                                                                                                                                                   |
| Ranglistentyp                      | Wählen Sie das Bewertungssystem aus, das Sie verwenden möchten. Weitere Informationen zu den verfügbaren Bewertungssystemen finden Sie unter [Ranglisten erklärt](/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 an Zeilen ein, die auf der Rangliste angezeigt werden sollen.                                                                                                                                                                                                         |
| Programm                           | Wählen Sie ein Programm aus, um die Ranglistenergebnisse auf Teilnehmer dieses Programms zu beschränken. Um Ergebnisse global über alle Programme hinweg anzuzeigen, wählen Sie kein Programm aus.                                                                                                  |
| Rangtyp                            | Weitere Informationen zu den verfügbaren Rangsystemen finden Sie unter [Ranglisten erklärt](/brand/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md).                                                                       |
| Spaltenüberschrift für Rang        | Geben Sie den Spaltennamen ein, der für die *Rang* Spalte.                                                                                                                                                                                                                                          |
| Rang auf 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 *Rang* Spalte.                        |
| Spaltenüberschrift für Statistiken | Geben Sie den Spaltennamen ein, der für die Spalte mit den Teilnehmerscores angezeigt werden soll.                                                                                                                                                                                                  |
| Spaltenüberschrift für Benutzer    | Geben Sie den Spaltennamen ein, der für die Spalte mit den Teilnehmernamen angezeigt werden soll.                                                                                                                                                                                                   |
| {% endtab %}                       |                                                                                                                                                                                                                                                                                                     |

{% tab title="Verschieben" %}

1. Wählen Sie auf Ihrer Leinwand die Komponente aus, die Sie verschieben möchten.
2. Wählen Sie ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9e2a26b918e7394cf67e8a26e3713e081b203ac9%2F15d049b0c04d1c54c39dbbb5a7cd2ba64d86f1f99220111674e768744ea7ceb9.svg?alt=media) **\[Verschieben]**.
   * 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) **\[Verschieben]** Option wird nur angezeigt, wenn es einen weiteren gültigen Ort auf der Leinwand gibt, an den die Komponente verschoben werden kann.
3. Wählen Sie die blaue **Verschieben nach** Schaltfläche, an die die Komponente verschoben werden soll.
4. Wählen Sie **Speichern**.
   {% endtab %}

{% tab title="Entfernen" %}

1. Wählen Sie auf Ihrer Leinwand die Komponente aus, die Sie entfernen möchten.
2. Wählen Sie ![](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) **\[Entfernen]**.
3. Wählen Sie **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.
