> 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/advocate-rewards/set-up-a-fuel-tank-reward.md).

# Eine Fuel-Tank-Belohnung einrichten

Die Fuel-Tank-Funktion vereinfacht die Vergabe von Prämien mithilfe einzigartiger Gutscheincodes. Teilnehmer Ihres Programms können diese Codes gegen Rabatte, Guthaben und andere Prämienarten einlösen. Weitere Informationen finden Sie unter [Fuel-Tank-Prämien erklärt](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/fuel-tank-rewards-explained.md).

#### Fuel-Tank-Prämie erstellen

Fuel-Tank-Prämien können als programmspezifische Prämien oder als Prämien eingerichtet werden, die in mehreren Programmen wiederverwendet werden können. Wir empfehlen, eine wiederverwendbare Prämie im Prämienkatalog einzurichten.

1. Wählen Sie im linken Navigationsmenü ![](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] → Rewards →** **Katalog**.
2. Wählen Sie **Prämie erstellen**.
3. Geben Sie der Prämie einen Namen.
4. Wählen Sie den **Fuel Tank** Prämientyp aus.
5. Verwenden Sie die Dropdown-Liste **Fuel Tank Type** , um eine Rabatt- oder Guthabenprämie auszuwählen.
6. ![](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 Sie]** die Option **Ausstehende Prämienzeit** , wenn Sie einen zeitlichen Puffer für mögliche Rücknahmen festlegen möchten.
   * Sie möchten beispielsweise einen Zeitraum für Rückgaben festlegen, damit die Prämien erst nach Ablauf dieses Zeitraums vergeben werden.
7. Aktivieren Sie **Mit Shopify verknüpfen** , um Codes in Shopify zu synchronisieren, wenn Sie Codes zu impact.com hochladen.
   * Weitere Informationen zum Einrichten und Verwalten der Codes finden Sie im Abschnitt [Mit Shopify synchronisierte Codes](#synced-codes-for-shopify) .
8. ![](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 Sie]** die Option **Ablaufdatum der Prämie** , wenn die Prämie nur für einen bestimmten Zeitraum gültig sein soll. Nach Ablauf dieses Zeitraums verfällt die Prämie und ist nicht mehr gültig.
9. Legen Sie einen Rabattprozentsatz oder einen Guthabenbetrag und eine Prämiensaldowährung fest.
10. Wählen Sie aus, ob für die Fuel-Tank-Prämie **Verifizierter Zugriff** oder **Sofortiger Zugriff**.

    <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%2Fgit-blob-85446df8f41a7f78bd5183faed6e4ef5afe02ab5%2F82b48c8d0771a2f0faa025ef67a468e9293da17d377e8f02ef512d46317c7bae.jpg?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
11. gelten soll. **Prämie erstellen**.

#### Gutscheincodes hinzufügen

{% hint style="success" %}
**Hinweis:** Eine Beispieldatei im .CSV-Format für Fuel-Tank-Prämien-Gutscheincodes können Sie [hier herunterladen](https://assets.contentful.com/s68ib1kj8k5n/4JaVWQPdI48Ey600sGOQUQ/a8cb4afbaddfc4bb0f7e7827bbe26889/example_fueltank_import.csv).
{% endhint %}

Damit Fuel-Tank-Prämien funktionieren, müssen Sie einzigartige Gutscheincodes bereitstellen. Wenn Sie Ihre Codes mit Ihrem Shopify-Konto synchronisieren, erhalten Sie einen Hinweis, dass der Code zu Shopify hinzugefügt wird.

1. Wählen Sie im linken Navigationsmenü ![](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] → Rewards →** **Code-Manager**.
2. Bewegen Sie auf der Seite *Code-Manager* den Mauszeiger über die Fuel-Tank-Prämie, für die Sie Gutscheincodes hochladen möchten, und wählen Sie **Codes hochladen**.
3. Auswählen **Datei auswählen** und eine Datei von deinem Gerät hochladen, die deine individuellen Gutscheincodes enthält.
   * impact.com empfiehlt, eine Kopie dieser [herunterladbaren .CSV-Beispieldatei](https://assets.contentful.com/s68ib1kj8k5n/4JaVWQPdI48Ey600sGOQUQ/a8cb4afbaddfc4bb0f7e7827bbe26889/example_fueltank_import.csv) als Ausgangspunkt zu verwenden. Du kannst aber auch deine eigene Datei hochladen: `.xlsx`, `.ods`, `.tsv`, oder `.txt` Datei (nur durch Zeilenumbrüche getrennt).
4. Deine Datei sollte folgende Anforderungen erfüllen:
   * Alle Codes, die du importieren möchtest, müssen sich in derselben Spalte befinden und den einzigen Inhalt dieser Spalte bilden.
   * Jeder Code darf bis zu 64 Zeichen enthalten. Jede Kombination der folgenden Zeichen ist zulässig:
     * Groß- und Kleinbuchstaben von A bis Z
     * Ziffern von 0 bis 9
     * Bindestrich ( - )
     * Unterstrich ( \_ )

       <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%2Fgit-blob-ea3a0fafbf37d947e1011d69340dcacc76c95e9f%2F763daeafd0065f6d4645ad50bb6fafccca698b07cab2925f5c422752804718cc.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
5. Wenn deine Datei mehrere Spalten enthält, kannst du **eine Datenspalte auswählen** im rechten Bereich, um anzugeben, welche Spalte deine Gutscheincodes enthält.
   * Sieh dir die Vorschau an, um zu sehen, welche Gutscheincodes das System gegebenenfalls als ungültig einstuft.
6. Wähle im linken Bereich aus, ob die Gutscheincodes in deiner Datei **vorhandene Codes ersetzen** oder ob du sie zu vorhandenen Codes **hinzufügen** möchtest.
7. Auswählen **Hochladen**.
   * Optional kannst du **Codes anzeigen** auswählen, um Gutscheincodes zu verwalten.

#### Hochgeladene Gutscheincodes verwalten

1. Nachdem du deine Gutscheincodes hochgeladen hast, wähle im Pop-up-Fenster **Codes anzeigen** aus.
   * Du gelangst dadurch zum Bildschirm [*Codes anzeigen*](https://app.impact.com/secure/advertiser/engage/advocate/p/651d9f42ffdad26e631d75c1/t/live/fueltank/manage/r%2FCoupon-20) .
2. Unter dem Seitentitel kannst du nach einem bestimmten Gutscheincode suchen: **Suchen** Suche nach dem Namen des Codes oder filtere mithilfe der Dropdown-Menüs nach Programm oder Status (d. h. danach, ob die Codes bereits verwendet wurden).
3. Um unerwünschte Codes zu löschen, aktiviere in den entsprechenden Zeilen das ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Nicht markiertes Kästchen]** und wähle dann **Löschen**.

   <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%2FYmqcBKMJqxeNUMtufOhl%2FScreenshot%202026-05-25%20at%2018.45.20.png?alt=media&amp;token=c0fda7ef-fab2-403b-86fe-6450bbe14d65" alt="" width="563"><figcaption></figcaption></figure></div>

#### Mit Shopify synchronisierte Codes

Wenn deine Codes mit Shopify synchronisiert sind, können geworbene Kundinnen und Kunden ihre Prämien ohne Verzögerung einlösen. Das schafft Vertrauen und sorgt für ein reibungsloses Empfehlungserlebnis. Mit der Shopify-Integration von Advocate kannst du die Erstellung und Synchronisierung von Rabattcodes automatisieren – das spart Zeit und verringert das Fehlerrisiko.

**Shopify-Code-Synchronisierung einrichten**

1. Wählen Sie im linken Navigationsmenü ![](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] → Prämien** → **Katalog** → **Prämie erstellen**.
2. Wählen Sie **Code-Pool** als Prämientyp aus.
3. Wählen Sie im Abschnitt *Mit Shopify verknüpfen* die Option ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media\&token=a046e9f0-63aa-46f6-8a35-f73973fd326c) **\[Kontrollkästchen]** **Rabattcodes mit Shopify synchronisieren, wenn Prämien vergeben werden**.
   * Wenn der obige Bildschirm nicht angezeigt wird, verweist der Tooltip auf unsere Dokumentation zur [Shopify-Integration](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-plugin-integration/integrate-with-shopify-for-advocate) , um die Synchronisierung Ihrer Codes mit Shopify einzurichten.
4. Wählen Sie im Abschnitt *Rabattcodes automatisch erstellen* die Option ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media\&token=a046e9f0-63aa-46f6-8a35-f73973fd326c) **\[Kontrollkästchen]** **Codes mit einem Präfix generieren** , wenn Sie die Codes automatisch generieren und personalisieren möchten.

   * Geben Sie das Präfix, das Sie den automatisch generierten Codes hinzufügen möchten, in das vorgesehene Eingabefeld ein. Dieses Präfix ist für alle Ihre Codes gleich, z. B. `CODE0835A`, `CODE04359B`.

   <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%2FdrSJd4RilqVCsRCt6YKK%2FScreenshot%202026-05-25%20at%2018.46.59.png?alt=media&amp;token=20897baa-0919-4d3c-b18a-8ac416a780e3" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
**Hinweis:** Wenn eine Prämie vergeben wird, wird in Advocate automatisch ein eindeutiger Code generiert und anschließend mit Shopify synchronisiert. Wir empfehlen Ihnen, regelmäßig nach möglichen Fehlern zu suchen.
{% endhint %}

Wenn Sie lieber eigene Codes verwenden möchten, können Sie diese [über den Code-Manager hochladen](#manage-uploaded-coupon-codes) und nachverfolgen, welche Codes an wen ausgegeben wurden und ob sie erfolgreich synchronisiert wurden. Dies sorgt für einen reibungslosen Ablauf für Ihr Team und Ihre Kunden.

**Shopify-Codes verwalten**

Der  *Code-Manager*  – einschließlich des darin enthaltenen Bildschirms  *Codes anzeigen*  – und der  *Prämien-Feed*  helfen Ihnen, die Rabattcodes zu verwalten und zu überwachen, die in Ihrem Advocate-Programm als Prämien verwendet werden. Wenn Sie Shopify nutzen, können Sie mit diesen Tools Codes automatisch synchronisieren, sodass manuelle Uploads entfallen.

{% tabs %}
{% tab title="Code-Manager" %}
Auf diesem Bildschirm finden Sie eine Liste der Gutscheincodes und Informationen dazu.

1. Wählen Sie im linken Navigationsmenü ![](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] → Rewards →** **Code-Manager**.
2. Suchen Sie den betreffenden Code und prüfen Sie die Daten in der ganz linken Spalte *Verfügbare Codes* , um zu sehen, ob er mit Ihrem Shopify-Shop synchronisiert ist. Wenn der Code mit Shopify synchronisiert ist, wird ein entsprechender Hinweis angezeigt.
   * Weitere Informationen finden Sie in der folgenden *Referenztabelle zum Code-Manager* .

<details>

<summary>Code-Manager-Referenz</summary>

| Spalte           | Beschreibung                                                                                                      |
| ---------------- | ----------------------------------------------------------------------------------------------------------------- |
| Name             | Hier wird der Name des Prämiencodes angezeigt. Dies ist der Name, den Sie beim Erstellen des Codes gewählt haben. |
| Typ              | Hier wird der Typ des angebotenen Prämiencodes angezeigt, z. B. `PCT_DISCOUNT` (prozentualer Rabattcode).         |
| Wert             | In diesem Feld wird der Gesamtwert des Codes angezeigt – entweder als prozentualer Rabatt oder als Geldbetrag.    |
| Verfügbare Codes | In diesem Feld wird die Anzahl der hochgeladenen Codes angezeigt.                                                 |

</details>
{% endtab %}

{% tab title="Bildschirm „Codes anzeigen“" %}
Auf diesem Bildschirm können Sie Ihre verfügbaren Empfehlungsgutscheincodes anzeigen, sie nach dem zugehörigen Programm sortieren und danach filtern, ob sie bereits verwendet wurden. Außerdem können Sie nach bestimmten Codes anhand ihres Namens suchen.

1. Wählen Sie im linken Navigationsmenü ![](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] → Rewards →** **Code-Manager**.
2. Bewegen Sie den Mauszeiger über den Prämiencode, den Sie anzeigen möchten, und wählen Sie **Verwalten**.
3. Sie gelangen zum Bildschirm [*Codes anzeigen*](https://app.impact.com/secure/advertiser/engage/advocate/p/651d9f42ffdad26e631d75c1/t/live/fueltank/manage/r%2FCoupon-20) , auf dem alle Gutscheincodes aufgeführt sind, die unter diesem Prämiencodenamen erstellt wurden.
   * Weitere Informationen finden Sie in der *Referenztabelle „Codes anzeigen“* .

<details>

<summary>Referenztabelle „Codes anzeigen“</summary>

| Spalte                  | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Code                    | In diesem Feld wird der verwendete Gutscheincode angezeigt, z. B. `DISCOUNT123`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Prämienausgabedatum     | Dies ist das Datum, an dem der Code an den Benutzer bzw. Kunden ausgegeben wurde.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Upload-Datum            | Dies ist das Datum, an dem der Code erstellt und in das System hochgeladen wurde.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Ausgegeben an           | In diesem Feld wird angegeben, wer den Code erhalten hat und an welche E-Mail-Adresse er gesendet wurde.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Wert                    | In diesem Feld wird der Wert des Codes als prozentualer Rabatt oder Geldbetrag angegeben.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Synchronisierungsstatus | <p>In diesem Feld wird angegeben, ob der Code mit Shopify synchronisiert wurde. Es informiert darüber, ob die Synchronisierung mit Shopify <em>Erfolgreich synchronisiert</em>, <em>Fehlgeschlagen</em>oder <em>Ausstehend</em>.</p><p>• Um <strong>Mit Shopify verknüpfen</strong>zu aktivieren, siehe <em>Schritt 8</em> im obigen Abschnitt <a href="#section-idm4614345065470433852294536291">Eine Fuel-Tank-Prämie erstellen</a> .</p><div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>Hinweis</strong>: Die Spalte <em>Synchronisierungsstatus</em> wird nicht angezeigt, wenn die Synchronisierung noch nie aktiviert wurde. Sie wird angezeigt, wenn die Synchronisierung aktiviert ist oder aktiviert und später wieder deaktiviert wurde.</p></div> |

</details>
{% endtab %}

{% tab title="Prämien-Feed" %}
Der Prämien-Feed zeigt den Status Ihrer synchronisierten Codes an und kann Ihnen helfen, Fehler bei der Synchronisierung zu erkennen. Für die Codesynchronisierung gibt es drei relevante Status:

* **Ausstehend:** Während unser System einen automatischen Wiederholungsversuch durchführt, lautet der Status „Ausstehend“.
* **Shopify-Synchronisierungsfehler:** Wenn der Wiederholungsversuch aufgrund eines Integrations- oder Konfigurationsfehlers fehlschlägt.
* **Verfügbar:** Wenn die Codes mit Shopify synchronisiert wurden.

Lesen Sie den [Erklärung zum Reward-Feed](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/reward-feed-explained.md) -Artikel, um mehr zu erfahren.
{% endtab %}
{% endtabs %}

**Reward-Codes löschen**

Sie können generierte Reward-Codes löschen, einschließlich der mit Shopify synchronisierten Codes.

{% hint style="success" %}
**Hinweis**: Um mit Shopify synchronisierte Codes zu löschen, müssen Sie die Codes sowohl über Ihr impact.com-Advocate-Konto [als auch in Ihrem Shopify-Konto löschen.](https://help.shopify.com/en/manual/discounts/managing-discount-codes#delete-discounts).
{% endhint %}

1. Wählen Sie im linken Navigationsmenü ![](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] → Rewards → Code Manager**.
2. Wählen Sie oben rechts **Codes anzeigen**.
3. Bewegen Sie den Mauszeiger über den Prämiencode, den Sie anzeigen möchten, und wählen Sie **Verwalten**.
4. Wählen Sie das ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media\&token=a046e9f0-63aa-46f6-8a35-f73973fd326c) **\[Aktiviertes Kontrollkästchen]** neben den Codes aus, die Sie löschen möchten.
5. Wenn Sie alle Codes ausgewählt haben, die Sie löschen möchten, wählen Sie die Schaltfläche **Löschen** aus.

   <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%2FpCxueTpMDFNxVnX4XmAr%2FScreenshot%202026-05-25%20at%2018.45.20.png?alt=media&amp;token=5655425b-bcc0-4fea-a876-cfb189df1289" alt="" width="563"><figcaption></figcaption></figure></div>


---

# 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/advocate-rewards/set-up-a-fuel-tank-reward.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.
