> 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 das Ausgeben von Belohnungen mithilfe eindeutiger Gutscheincodes. Ihre Programmbeteiligten können diese Codes gegen Rabatte, Guthaben und andere Belohnungsarten einlösen. Weitere Informationen finden Sie unter [Fuel-Tank-Belohnungen erklärt](/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/fuel-tank-rewards-explained.md).

#### Eine Fuel-Tank-Belohnung erstellen

Fuel-Tank-Belohnungen können als programmspezifische Belohnungen oder als Belohnungen eingerichtet werden, die in mehreren Programmen wiederverwendet werden können. Wir empfehlen, eine wiederverwendbare Belohnung im Belohnungskatalog 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 **Belohnung erstellen**.
3. Benennen Sie die Belohnung.
4. Wählen Sie das **Fuel Tank** Belohnungstyp.
5. Verwenden Sie die **Fuel-Tank-Typ** Dropdown-Liste, um eine Rabatt- oder Guthaben-Belohnung 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) **\[Einschalten]** die **Wartezeit für Belohnung** Option, wenn Sie einen Zeitpuffer für mögliche Rücknahmen festlegen möchten.
   * Sie möchten zum Beispiel ein Datum für eine Rückgabeperiode festlegen, um sicherzustellen, dass die Belohnungen erst ausgegeben werden, wenn die Rückgabeperiode endet.
7. aktivieren **Mit Shopify verknüpfen** um Codes in Shopify zu synchronisieren, wenn Sie Codes zu impact.com hochladen.
   * Siehe die [Mit Shopify synchronisierte Codes](#synced-codes-for-shopify) Bereich zum Einrichten und Verwalten der Codes.
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) **\[Einschalten]** die **Ablauf der Belohnung** Option, wenn Sie die Belohnung für einen bestimmten Zeitraum festlegen möchten. Sobald die Zeit abgelaufen ist, verfällt die Belohnung und ist nicht mehr gültig.
9. Legen Sie einen Rabattprozentsatz oder einen Guthabenbetrag und eine Belohnungseinheit fest.
10. Wählen Sie aus, ob die Fuel-Tank-Belohnung **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. Wählen Sie **Belohnung erstellen**.

#### Gutscheincodes hinzufügen

{% hint style="success" %}
**Hinweis:** Eine Beispiel-CSV-Importdatei für Fuel-Tank-Belohnungsgutscheincodes ist [hier zum Download verfügbar](https://assets.contentful.com/s68ib1kj8k5n/4JaVWQPdI48Ey600sGOQUQ/a8cb4afbaddfc4bb0f7e7827bbe26889/example_fueltank_import.csv).
{% endhint %}

Damit Fuel-Tank-Belohnungen funktionieren, müssen Sie eindeutige Gutscheincodes bereitstellen. Wenn Sie Ihre Codes mit Ihrem Shopify-Konto synchronisieren, werden Sie darauf hingewiesen, 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. Auf der *Code-Manager* Bildschirm, fahren Sie mit der Maus über die Fuel-Tank-Belohnung, für die Sie Gutscheincodes hochladen möchten, und wählen Sie **Codes hochladen**.
3. Wählen Sie **Datei auswählen** und laden Sie eine Datei von Ihrem Gerät hoch, die Ihre eindeutigen 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 bearbeiten, obwohl Sie auch Ihre eigene `.xlsx`, `.ods`, `.tsv`, oder `.txt` Datei hochladen können (nur zeilengetrennt).
4. Ihre Datei sollte die folgenden Richtlinien erfüllen:
   * Alle Codes, die Sie importieren möchten, sollten sich in derselben Spalte befinden und den einzigen Inhalt dieser Spalte bilden.
   * Jeder Code darf bis zu 64 Zeichen enthalten. Jede Kombination dieser Zeichen ist erlaubt:
     * Groß- und Kleinbuchstaben A-Z
     * Zahlen 0-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 Ihre Datei mehrere Spalten hat, können Sie **Eine Datenspalte auswählen** im rechten Bereich angeben, welche Spalte Ihre Gutscheincodes enthält.
   * Sehen Sie sich die Vorschau an, um zu prüfen, welche Gutscheincodes das System gegebenenfalls als ungültig einstuft.
6. Wählen Sie im linken Bereich aus, ob die Gutscheincodes in Ihrer Datei **Ersetzen** sollen oder ob Sie sie **Hinzufügen** an bereits vorhandene Codes anhängen möchten.
7. Wählen Sie **Hochladen**.
   * Optional wählen Sie **Codes anzeigen** um Gutscheincodes zu verwalten.

#### Hochgeladene Gutscheincodes verwalten

1. Nachdem Sie Ihre Gutscheincodes hochgeladen haben, wählen Sie **Codes anzeigen** im Popup-Dialog aus.
   * Dadurch gelangen Sie zum [*Codes anzeigen*](https://app.impact.com/secure/advertiser/engage/advocate/p/651d9f42ffdad26e631d75c1/t/live/fueltank/manage/r%2FCoupon-20) Bildschirm.
2. Unter dem Seitentitel können Sie **Suche** nach einem bestimmten Gutscheincode anhand des Namens suchen oder die Dropdown-Menüs verwenden, um Codes nach Programm oder Status zu filtern (d. h. ob die Codes bereits verwendet wurden oder nicht).
3. Um unerwünschte Codes zu löschen, wählen Sie die ![](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 angekreuztes Kontrollkästchen]** in den entsprechenden Zeilen und 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 Sie Ihre Codes mit Shopify synchron halten, können empfohlene Kundinnen und Kunden ihre Belohnungen ohne Verzögerung einlösen, was Vertrauen und eine reibungslose Empfehlungs-Erfahrung fördert. Mit der Shopify-Integration von Advocate können Sie die Erstellung und Synchronisierung von Rabattcodes automatisieren – das spart Zeit und reduziert das Risiko von Fehlern.

**Ihre 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] → Rewards** → **Katalog** → **Belohnung erstellen**.
2. Wählen Sie **Fuel Tank** als Belohnungstyp.
3. Im *Mit Shopify verknüpfen* Abschnitt, wählen Sie ![](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 bei der Belohnungsausgabe mit Shopify synchronisieren**.
   * Wenn Sie den obigen Bildschirm nicht sehen, werden Sie im Tooltip aufgefordert, unsere Dokumentation zu unserer [Shopify-Integration](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-plugin-integration/integrate-with-shopify-for-advocate) zu konsultieren, um Ihre Shopify-Code-Synchronisierung einzurichten.
4. Im *Rabattcodes automatisch erstellen* Abschnitt, wählen Sie ![](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 generieren, die mit einem Präfix beginnen** wenn Sie die Codes automatisch generieren und personalisieren möchten.

   * Geben Sie das Präfix, das Sie zu den automatisch generierten Codes hinzufügen möchten, in das vorgesehene Eingabefeld ein. Dieses Präfix ist bei allen Ihren Codes standardmäßig enthalten, 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 Belohnung ausgegeben wird, wird in Advocate automatisch ein eindeutiger Code generiert und anschließend mit Shopify synchronisiert. Wir empfehlen, regelmäßig nach möglichen Fehlern zu sehen, die auftreten können.
{% endhint %}

Wenn Sie lieber Ihre eigenen Codes verwenden möchten, können Sie dies tun, indem Sie [sie über den Code-Manager hochladen](#manage-uploaded-coupon-codes)—und verfolgen, welche Codes ausgegeben wurden, an wen und ob sie erfolgreich synchronisiert wurden. So wird sowohl für Ihr Team als auch für Ihre Kundinnen und Kunden ein reibungsloses Erlebnis sichergestellt.

**Shopify-Codes verwalten**

Die *Code-Manager* Bildschirm – zusammen mit dem darunter verschachtelten *Codes anzeigen* Bildschirm – und dem *Belohnungs-Feed* helfen Ihnen dabei, die Rabattcodes zu verwalten und zu überwachen, die in Ihrem Advocate-Programm als Belohnungen verwendet werden. Wenn Sie Shopify verwenden, können Sie mit diesen Tools Codes automatisch synchronisieren – dadurch entfällt der manuelle Upload.

{% 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 relevanten Code und sehen Sie sich die Daten ganz links an *Verfügbare Codes* Spalte, um zu sehen, ob er mit Ihrem Shopify-Store synchronisiert ist. Sie sehen einen Hinweis, wenn der Code mit Shopify synchronisiert ist.
   * Siehe den *Code-Manager-Referenz* Tabelle unten für weitere Informationen.

<details>

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

| Spalte         | Beschreibung                                                                                                               |
| -------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Name           | Hier wird der Name des Belohnungscodes angezeigt. Das ist der Name, den Sie bei der Erstellung des Codes ausgewählt haben. |
| Typ            | Hier wird der Typ des angebotenen Belohnungscodes angezeigt, z. B. `PCT_DISCOUNT` (Prozent-Rabattcode).                    |
| Wert           | Dieses Feld zeigt den Gesamtwert des Codes entweder als prozentualen Rabatt oder als Geldbetrag an.                        |
| Code verfügbar | Dieses Feld gibt die Anzahl der hochgeladenen Codes an.                                                                    |

</details>
{% endtab %}

{% tab title="Bildschirm „Codes anzeigen“" %}
Auf diesem Bildschirm können Sie Ihre verfügbaren, weitergeleiteten Gutscheincodes anzeigen, nach dem Programm sortieren, dem der Code zugeordnet ist, sehen, ob die Codes verwendet wurden, oder gezielt nach Codes anhand des 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 Belohnungscode, den Sie anzeigen möchten, und wählen Sie **Verwalten**.
3. Sie gelangen zum [*Codes anzeigen*](https://app.impact.com/secure/advertiser/engage/advocate/p/651d9f42ffdad26e631d75c1/t/live/fueltank/manage/r%2FCoupon-20) Bildschirm, der alle verschiedenen Gutscheincodes auflistet, die unter diesem Belohnungscodenamen generiert wurden.
   * Siehe den *Referenz zum Bildschirm „Codes anzeigen“* Tabelle für weitere Informationen.

<details>

<summary>Referenz zum Bildschirm „Codes anzeigen“</summary>

| Spalte                  | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Code                    | Dieses Feld zeigt den verwendeten Gutscheincode an, z. B. `DISCOUNT123`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Belohnungsdatum         | Dies ist das Datum, an dem der Code dem Benutzer/Kunden belohnt wurde.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Hochladedatum           | Dies ist das Datum, an dem der Code generiert und in das System hochgeladen wurde.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Belohnt an              | Dieses Feld gibt an, wer der Empfänger des Codes war und an welche E-Mail-Adresse er gesendet wurde.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Wert                    | Dieses Feld gibt den Wert des Codes als prozentualen Rabatt oder Geldbetrag an.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Synchronisierungsstatus | <p>Dieses Feld gibt an, ob der Code mit Shopify synchronisiert wurde. Es liefert Informationen dazu, ob die Synchronisierung mit Shopify <em>Synchronisiert</em>, <em>Nicht bestanden</em>, oder <em>Ausstehend</em>.</p><p>• Um <strong>Mit Shopify verknüpfen</strong>einzuschalten, siehe <em>Schritt 8</em> des <a href="#section-idm4614345065470433852294536291">Eine Fuel-Tank-Belohnung erstellen</a> oben genannten Abschnitts.</p><div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>Hinweis</strong>: Die <em>Synchronisierungsstatus</em> Spalte wird nicht angezeigt, wenn die Synchronisierung nie aktiviert wurde. Sie erscheint, wenn die Synchronisierung aktiviert wurde oder aktiviert war, später aber wieder deaktiviert wurde.</p></div> |

</details>
{% endtab %}

{% tab title="Belohnungs-Feed" %}
Der Belohnungs-Feed zeigt den Status Ihrer synchronisierten Codes an und kann hilfreich sein, um zu erkennen, ob bei Ihrer Synchronisierung Fehler aufgetreten sind. Es gibt 3 verschiedene Status, die für Ihre Codesynchronisierung relevant sind:

* **Ausstehend:** Während unser System mit einem automatischen Wiederholungsversuch beschäftigt ist, wird der Status als ausstehend angezeigt.
* **Fehler bei der Shopify-Code-Synchronisierung:** Wenn der Wiederholungsversuch aufgrund eines Integrations- oder Konfigurationsfehlers fehlschlägt.
* **Verfügbar:** Wenn Codes mit Shopify synchronisiert sind.

Sehen Sie sich die [Belohnungs-Feed erklärt](/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/reward-feed-explained.md) Artikel, um mehr zu erfahren.
{% endtab %}
{% endtabs %}

**Belohnungscodes löschen**

Sie können von Ihnen generierte Belohnungscodes löschen, einschließlich Codes, die mit Shopify synchronisiert sind.

{% hint style="success" %}
**Hinweis**: Um mit Shopify synchronisierte Codes zu löschen, müssen Sie die Codes über Ihr impact.com-Advocate-Konto löschen [sowie in Ihrem Shopify-Konto](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ähle oben rechts **Codes anzeigen**.
3. Bewegen Sie den Mauszeiger über den Belohnungscode, 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) **\[Kontrollkästchen]** neben den Codes, die Sie löschen möchten.
5. Nachdem Sie alle Codes ausgewählt haben, die Sie löschen möchten, wählen Sie die **Löschen** Schaltfläche auswählen.

   <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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
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=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
