> 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-reporting-and-analytics/advocate-program-reports-explained.md).

# Advocate-Programmberichte erklärt

<a href="https://pxa.impact.com/student/activity/1687872?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">Nehmen Sie am PXA-Kurs teil</a>

Advocate bietet verschiedene herunterladbare Berichte für Ihre Programm- und Teilnehmerdaten an. Alle Berichte verfügen über Filteroptionen, damit Sie die heruntergeladenen Daten besser kontrollieren können. Jeder Bericht kann als .CSV- oder Excel-Datei heruntergeladen werden.

In diesem Artikel werden die verschiedenen Berichte und die jeweils enthaltenen Datentypen erläutert. Siehe [Einen Advocate-Programmbericht ausführen](/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report.md) für Anweisungen zum Erstellen eines Berichts.

#### Benutzerdetailbericht

Die *Benutzerdetails* Der Bericht enthält detaillierte Informationen zu jedem Teilnehmer in all Ihren Programmen. Exportieren Sie eine Liste aller Teilnehmer, um Ihre Daten mit den Advocate-Freigabelinks und Empfehlungscodes aktuell zu halten.

<details>

<summary>Berichtsdetails</summary>

Standardmäßig enthält der Bericht Teilnehmerinformationen wie:

* Name
* Benutzer- und Konto-ID
* E-Mail-Adresse
* Benutzerdefinierte Felder
* Segmente
* Empfehlungsinformationen (falls zutreffend)

Beim Erstellen des Berichts können Sie optional Folgendes einschließen:

* **Benutzerstatistiken**, einschließlich Analyseinformationen zum Teilnehmer wie Traffic, Umsatz und mehr.
* **Empfehlungs-Freigabelinks und -Codes**, falls zutreffend. Diese Informationen können als Teil der Aktualisierung von Kontaktdatensätzen in Ihrem CMS oder E-Mail-System hilfreich sein, um die Advocate-Freigabelinks und -Codes jedes Teilnehmers aufzunehmen.

Eine vollständige Liste der Felder finden Sie beim [Herunterladen unserer Beispiel-CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7Am85AH6wmNdArmjRNW3vr/95f52c5d79311509d795a0be4c94166f/User_Details_Report_Sample.csv) ![](/files/dd207a11d348872e1e27a6b04cce9bdb367c6a60) Benutzerdetailbericht.

**Spaltenreferenz des Berichts**

| Spalte                                              | Beschreibung                                                                                                                                                                                                      |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Benutzerinformationen**                           |                                                                                                                                                                                                                   |
| ID                                                  | Die eindeutige Kennung für den Teilnehmer innerhalb des Advocate-Systems.                                                                                                                                         |
| Konto-ID                                            | Die eindeutige Kennung für das Konto des Teilnehmers (falls zutreffend, programübergreifend verwendet).                                                                                                           |
| E-Mail                                              | Die E-Mail-Adresse des Teilnehmers.                                                                                                                                                                               |
| Vorname                                             | Der Vorname des Teilnehmers.                                                                                                                                                                                      |
| Nachname                                            | Der Nachname des Teilnehmers.                                                                                                                                                                                     |
| E-Mail-Hash                                         | Eine gehashte (verschlüsselte) Version der E-Mail-Adresse des Teilnehmers, nützlich für den datenschutzkonformen Abgleich mit anderen Systemen.                                                                   |
| **Empfehlungs- und Freigabeinformationen**          |                                                                                                                                                                                                                   |
| Empfehlungscode                                     | Der eindeutige Code, der dem Teilnehmer zugeordnet ist und zur Nachverfolgung der von ihm erzeugten Empfehlungen verwendet wird.                                                                                  |
| Teilen-Link                                         | Der eindeutige Empfehlungslink, der dem Teilnehmer zugeordnet ist.                                                                                                                                                |
| Facebook-Freigabelink                               | Ein vorab generierter Link zum Teilen der Empfehlung auf Facebook.                                                                                                                                                |
| Twitter-Freigabelink                                | Ein vorab generierter Link zum Teilen der Empfehlung auf Twitter.                                                                                                                                                 |
| E-Mail-Freigabelink                                 | Ein vorab generierter Link zum Teilen der Empfehlung per E-Mail.                                                                                                                                                  |
| LinkedIn-Freigabelink                               | Ein vorab generierter Link zum Teilen der Empfehlung auf LinkedIn.                                                                                                                                                |
| Bereinigter Freigabelink                            | Eine Version des Empfehlungslinks ohne Tracking-Parameter; neutraler für bestimmte Plattformen oder Anwendungsfälle.                                                                                              |
| **Geolokalisierung und Gebietsschema**              |                                                                                                                                                                                                                   |
| Erste gesehene IP                                   | Die IP-Adresse, von der der Teilnehmer erstmals erfasst wurde.                                                                                                                                                    |
| Zuletzt gesehene IP                                 | Die zuletzt für diesen Teilnehmer erfasste IP-Adresse.                                                                                                                                                            |
| Gebietsschema                                       | Die bevorzugte Sprache und die regionalen Einstellungen des Teilnehmers (z. B. en-US).                                                                                                                            |
| Ländercode                                          | Das Land des Teilnehmers basierend auf Gebietsschema oder IP-Adresse (z. B. ZA, US).                                                                                                                              |
| **Zeitstempel**                                     |                                                                                                                                                                                                                   |
| Erstellungsdatum                                    | Das Datum und die Uhrzeit, zu der das Teilnehmerkonto in Advocate erstellt wurde.                                                                                                                                 |
| Datum der Übermittlung des US-Steuerformulars       | (Falls zutreffend) Das Datum, an dem ein US-Steuerformular zur Einhaltung von Vorschriften oder zur Belohnungsverarbeitung eingereicht wurde.                                                                     |
| **Benutzerstatistiken (falls im Export enthalten)** |                                                                                                                                                                                                                   |
| stats.date Modified                                 | Das letzte Datum, an dem die Statistiken des Teilnehmers aktualisiert wurden.                                                                                                                                     |
| stats.traffic                                       | Gesamtzahl der Besuche, die durch die Empfehlungsaktivität des Teilnehmers erzeugt wurden.                                                                                                                        |
| stats.referrals                                     | Gesamtzahl der vom Teilnehmer erfolgreich vorgenommenen Empfehlungen.                                                                                                                                             |
| stats.conversions                                   | Gesamtzahl der Conversions (z. B. Käufe, Anmeldungen), die aus diesen Empfehlungen resultierten.                                                                                                                  |
| stats.goals                                         | Anzahl bestimmter Zielabschlüsse im Zusammenhang mit der Empfehlungsaktivität des Teilnehmers (im Programm benutzerdefiniert definiert).                                                                          |
| stats.rewards                                       | Gesamtzahl der vom Teilnehmer verdienten Belohnungen.                                                                                                                                                             |
| stats.widget Loads                                  | Anzahl der Male, die das Empfehlungs-Widget oder die Freigabeoberfläche von diesem Teilnehmer geladen wurde.                                                                                                      |
| stats.revenue                                       | Gesamtumsatz, der von Nutzern generiert wurde, die von diesem Teilnehmer geworben wurden.                                                                                                                         |
| stats.generated Revenue                             | Synonym für stats.revenue; einige Berichte unterscheiden möglicherweise, ob der Umsatz aus mehreren Quellen stammt.                                                                                               |
| stats.referred Revenue                              | Umsatz, der speziell den Teilnehmern zugerechnet wird, die sich über den Empfehlungslink dieses Teilnehmers angemeldet oder gekauft haben.                                                                        |
| **Benutzerdefinierte Daten**                        |                                                                                                                                                                                                                   |
| custom Fields.example                               | Ein Platzhalter für alle von Ihrem Programm definierten benutzerdefinierten Felder (z. B. *Loyalitäts-ID*, *interne Notizen*, *Region-Tag*). Jedes Feld erscheint als eigene Spalte mit dem Präfix custom Fields. |
| **Sonstiges**                                       |                                                                                                                                                                                                                   |
| Empfehlungsquelle                                   | Die ursprüngliche Quelle oder der Kanal, der den Teilnehmer zu Ihrem Programm geführt hat (z. B. *organisch*, *E-Mail*, *Partnerseite*).                                                                          |

</details>

#### Export der Benutzerereignisse

Die *Export der Benutzerereignisse* Der Bericht liefert eine Aufzeichnung aller Benutzerereignisse, die wir von Ihrer Organisation für Ihr Advocate-Programm erhalten haben. Sie können Filter anwenden, um einen Zeitbereich, den Ereignisschlüssel, die Benutzer-ID und mehr einzugrenzen.

<details>

<summary>Berichtsdetails</summary>

Standardmäßig enthält der Bericht:

* Ereignis-ID
* Ereignisschlüssel
* Benutzer- und Konto-ID
* Auslösedatum
* Empfangsdatum
* Verarbeitungsdatum

**Spaltenreferenz des Berichts**

| Spalte                                                             | Beschreibung                                                                                                                                                                                                                            |
| ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ereignis- und Benutzerinformationen**                            |                                                                                                                                                                                                                                         |
| Ereignis-ID                                                        | Eine eindeutige ID, die für jedes empfangene Ereignis generiert wird. Nützlich für Nachverfolgung, Debugging oder Prüfung von Ereignisübermittlungen.                                                                                   |
| Ereignisschlüssel                                                  | Der Typ oder das Label des Ereignisses, z. B. `purchase`, `Anmeldung`, oder jeder von Ihrem System gesendete benutzerdefinierte Schlüssel.                                                                                              |
| Benutzer-ID                                                        | Die eindeutige Kennung des Teilnehmers in Advocate, dem das Ereignis zugeordnet ist.                                                                                                                                                    |
| Konto-ID                                                           | Die dem Benutzer zugeordnete Konto-ID, besonders relevant in Programmen, in denen Benutzer verschiedenen Kontostrukturen angehören können.                                                                                              |
| **Zeitstempel des Ereignisses**                                    |                                                                                                                                                                                                                                         |
| Ereignis-Auslösedatum – JJJJ-MM-TT                                 | Das Datum, an dem das Ereignis tatsächlich stattgefunden hat (wie von Ihrem System gemeldet). Zum Beispiel das Datum eines Kaufs oder einer Anmeldung.                                                                                  |
| Ereignis-Empfangsdatum – JJJJ-MM-TT                                | Das Datum, an dem Advocate das Ereignis von Ihrem System empfangen hat. Kann sich aufgrund von Stapelverarbeitung oder Systemverzögerungen vom Auslösedatum unterscheiden.                                                              |
| Ereignis-Verarbeitungsdatum – JJJJ-MM-TT                           | Das Datum, an dem das Ereignis erfolgreich verarbeitet und in Advocate gespeichert wurde. Markiert den Zeitpunkt, ab dem das Ereignis für Tracking, Belohnungen oder Berichte nutzbar wurde.                                            |
| **Ereignisdatenfelder (falls in Ihren Event-Nutzdaten enthalten)** |                                                                                                                                                                                                                                         |
| fields.coupon                                                      | Jeder während des Ereignisses angewendete Gutschein- oder Rabattcode, sofern in den Ereignisdaten gesendet. Nützlich zum Nachverfolgen der Nutzung von Anreizen oder bestimmter Auslöser von Aktionen.                                  |
| fields.revenue                                                     | Der mit dem Ereignis verbundene Umsatzbetrag. Wird typischerweise in Kaufereignissen verwendet, um Leistung, Belohnungen oder ROI zu berechnen.                                                                                         |
| fields.currency                                                    | Der Währungscode (z. B. *USD*, *ZAR*, *EUR*) der dem Umsatzbetrag zugeordnet ist. Wichtig beim Berichtswesen über Regionen hinweg oder bei der Berechnung wechselkursbereinigter Belohnungen.                                           |
| fields.lead Created Date                                           | Das ursprüngliche Datum, an dem der Lead (Benutzer) in Ihrem System erstellt wurde, sofern als Teil des Ereignisses übermittelt. Hilft, Benutzerereignisse mit den ursprünglichen Akquisitionsdaten oder CRM-Datensätzen zu verknüpfen. |

</details>

#### Belohnungshistorie

Die *Belohnungshistorie* Der Bericht liefert eine detaillierte Aufzeichnung jeder Ihrer Belohnungen und der Beziehungen zu Teilnehmern und Empfehlungen. Diese Informationen können nützlich sein, um Bilanzen zu erstellen sowie den Status all Ihrer Belohnungen zu einem bestimmten Zeitpunkt abzurufen.

<details>

<summary>Berichtsdetails</summary>

Standardmäßig enthält der Bericht **Belohnungsfelder** Informationen wie:

* Belohnungs-ID
* Belohnungstyp
* Belohnungswert

Eine vollständige Liste der enthaltenen Felder finden Sie beim [Herunterladen unserer Beispiel-CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7E5DNWKrh7iQMNGYQBWRiS/3ae6c7a9109542215763a07a18cb0494/Reward_Details_Example_Report_CSV.csv), [Beispiel-Excel](https://assets.ctfassets.net/s68ib1kj8k5n/2MQjc4XjXGPNhsv10tHal6/dc40679812b99d0aef4ace46a780e1ee/Reward_Details_Example_Report_XLSX.xlsx) ![](/files/dd207a11d348872e1e27a6b04cce9bdb367c6a60) oder [Beispiel-JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl) ![](/files/dd207a11d348872e1e27a6b04cce9bdb367c6a60) Berichte mit Belohnungsdetails.

Beim Erstellen des Berichts können Sie optional Folgendes einschließen:

* **Teilnehmerdetails** wie Name, Benutzer- und Konto-ID, E-Mail-Adresse, benutzerdefinierte Felder, Segmente und Empfehlungsinformationen (falls zutreffend).
* **Empfehlungsfelder** wie Empfehlungs-ID, Felder des Kundenbotschafters, Felder des empfohlenen Freundes und mehr.

**Spaltenreferenz des Berichts**

| Spalte                                                                                                             | Beschreibung                                                                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Belohnungsinformationen**                                                                                        |                                                                                                                                                                      |
| ID                                                                                                                 | Eindeutige ID der Belohnungsinstanz (von Advocate generiert).                                                                                                        |
| Typ                                                                                                                | Die Belohnungskategorie oder -art (z. B. *Bargeld*, *Geschenkkarte*, *Coupon*, *Benutzerdefiniert*).                                                                 |
| Wert                                                                                                               | Der numerische Wert der Belohnung (z. B. 10, 100 usw.).                                                                                                              |
| Einheit                                                                                                            | Die dem Wert zugeordnete Einheit (z. B. *USD*, *Punkte*, *ZAR*, *%*).                                                                                                |
| Name                                                                                                               | Anzeigename der Belohnung (wie in der [Belohnungskonfiguration](/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/create-a-reward.md)). |
| Belohnungsquelle                                                                                                   | Beschreibt, was die Belohnung ausgelöst hat (z. B. *Empfehlung*, *Ziel*, *Manuell*, *API*).                                                                          |
| Fuel Tank-Typ                                                                                                      | Die Art des verwendeten Belohnungstopfes (falls FuelTank-Integration verwendet wird). Z. B. *Vorausbezahlt*, *Geschenkkarte*.                                        |
| Fuel-Tank-Code                                                                                                     | Der Code, der mit der externen Einlösung verknüpft ist (z. B. Gutschein- oder Geschenkkartencode).                                                                   |
| Programm-ID                                                                                                        | ID des Advocate-Programms, unter dem die Belohnung ausgegeben wurde.                                                                                                 |
| Programm-Belohnungsschlüssel                                                                                       | Interne Kennung für die spezifische im Programm verwendete Belohnungskonfiguration.                                                                                  |
| Globaler Belohnungsschlüssel                                                                                       | Programmübergreifende Kennung für Belohnungen, die auf globaler Ebene konfiguriert sind (falls zutreffend).                                                          |
| **Zeitstempel der Belohnung**                                                                                      |                                                                                                                                                                      |
| Erstellungsdatum                                                                                                   | Wann der Belohnungsdatensatz im System erstellt wurde.                                                                                                               |
| Geplant für                                                                                                        | Wann die Belohnung zur Ausgabe geplant wurde (z. B. nach einer Verzögerung oder Wartezeit).                                                                          |
| Datum der Vergabe                                                                                                  | Wann die Belohnung tatsächlich an den Teilnehmer ausgegeben wurde.                                                                                                   |
| Läuft ab am                                                                                                        | Das Ablaufdatum der Belohnung (falls zutreffend).                                                                                                                    |
| Storniert am                                                                                                       | Das Datum, an dem die Belohnung für ungültig erklärt oder storniert wurde.                                                                                           |
| Datum der Einlösung                                                                                                | Das Datum, an dem der Teilnehmer die Belohnung eingelöst hat (falls zutreffend).                                                                                     |
| Geändert am                                                                                                        | Das Datum, an dem die jüngste Aktualisierung des Belohnungsdatensatzes vorgenommen wurde.                                                                            |
| **Guthaben- und Wertverfolgung**                                                                                   |                                                                                                                                                                      |
| Zugewiesenes Guthaben                                                                                              | Der dieser Belohnung zugewiesene Guthabenbetrag (kann in einigen Modellen vom Wert abweichen).                                                                       |
| Eingelöstes Guthaben                                                                                               | Der Guthabenbetrag, der aus der Belohnung eingelöst wurde.                                                                                                           |
| Verbleibender Wert                                                                                                 | Der verbleibende, ungenutzte oder nicht eingelöste Teil der Belohnung.                                                                                               |
| **Belohnungsstatus und Nachrichten**                                                                               |                                                                                                                                                                      |
| Status                                                                                                             | Aktueller Status der Belohnung (z. B. *Ausstehend*, *Geplant*, *Ausgegeben*, *Abgelaufen*, *Abgebrochen*).                                                           |
| meta.status                                                                                                        | Technischer oder systemweiter Status (nützlich für Diagnose oder Fehlerbehandlung).                                                                                  |
| meta.message                                                                                                       | Mit der Auslieferung der Belohnung verknüpfte Nachricht (z. B. „Belohnung erfolgreich zugestellt“).                                                                  |
| meta.internal Message                                                                                              | Nur für Administratoren sichtbare interne Notizen (z. B. Fehlererklärungen oder Kennzeichnungen).                                                                    |
| meta.date Modified                                                                                                 | Zuletzt wurde Metadaten zu der Belohnung aktualisiert.                                                                                                               |
| meta.customMeta.testMeta                                                                                           | Ein Platzhalter für alle benutzerdefinierten Metadatenfelder, die Ihr Programm sendet (in diesem Fall ist testMeta ein Beispiel).                                    |
| **Informationen zum Teilnehmer (Benutzer)**                                                                        |                                                                                                                                                                      |
| user.id                                                                                                            | ID des Benutzers, der die Belohnung erhält.                                                                                                                          |
| user.account Id                                                                                                    | Die dem Benutzer in Advocate zugeordnete Konto-ID.                                                                                                                   |
| <p>user.first Name</p><p>user.last Name</p><p>user.email</p>                                                       | Grundlegende Teilnehmerinformationen zur Referenz oder zum CRM-Abgleich.                                                                                             |
| **Empfehlungskontext (wenn die Belohnung auf einer Empfehlung basiert)**                                           |                                                                                                                                                                      |
| referral.id                                                                                                        | Die ID der Empfehlung, die diese Belohnung ausgelöst hat.                                                                                                            |
| referral.date Referral Started                                                                                     | Wann die Empfehlungsaktion begonnen hat (z. B. Klick- oder Freigabeereignis).                                                                                        |
| referral.date Modified                                                                                             | Wann der Empfehlungsdatensatz zuletzt aktualisiert wurde.                                                                                                            |
| referral.referral Code Used                                                                                        | Der Code, den der empfohlene Benutzer verwendet hat, um beizutreten oder eine Aktion auszuführen.                                                                    |
| **Informationen zum empfohlenen Benutzer (Freund)**                                                                |                                                                                                                                                                      |
| referral.referred User.id                                                                                          | ID der Person, die empfohlen wurde (der „Freund“).                                                                                                                   |
| referral.referred User.account Id                                                                                  | Die eindeutige Konto-ID des Empfehlers.                                                                                                                              |
| <p>referral.referred User.first Name</p><p>referral.referred User.last Name</p><p>referral.referred User.email</p> | Die grundlegenden Kontaktdaten des Empfehlers.                                                                                                                       |
| **Informationen zum Empfehlenden (Advocate)**                                                                      |                                                                                                                                                                      |
| referral.referrer User.id                                                                                          | ID der Person, die die Empfehlung ausgesprochen hat (der „Advocate“).                                                                                                |
| referral.referrer User.account Id                                                                                  | Die eindeutige Konto-ID des Empfehlers.                                                                                                                              |
| <p>referral.referrer User.first Name</p><p>referral.referrer User.last Name</p><p>referral.referrer User.email</p> | Die grundlegenden Kontaktdaten des Empfehlers.                                                                                                                       |
| referral.date Converted                                                                                            | Das Datum, an dem die Empfehlung offiziell konvertiert wurde (z. B. abgeschlossene Anmeldung oder Kauf), wodurch die Belohnung ausgelöst wurde.                      |

</details>

#### Empfehlungshistorie

Die *Empfehlungshistorie* Der Bericht liefert eine Aufzeichnung des Status jeder in Ihrem Empfehlungsprogramm hergestellten Empfehlungsverbindung. Diese Informationen können nützlich sein, wenn Sie den Erfolg Ihres Programms überprüfen und die Anzahl neuer Kunden verfolgen, die Ihr Programm gewonnen hat.

<details>

<summary>Berichtsdetails</summary>

Standardmäßig enthält der Bericht:

* Details zum empfohlenen Freund wie Name, Benutzer- und Konto-ID, E-Mail-Adresse und mehr
* Details zum Kundenbotschafter wie Name, Benutzer- und Konto-ID, E-Mail-Adresse und mehr
* Empfehlungsstatus
* Moderationsstatus
* Belohnungs-IDs

Eine vollständige Liste der Felder finden Sie beim [Herunterladen unserer Beispiel-CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7B4pBHawfu9GtzE5mL1yo2/4fd194ee3080c5190639abab70b35e47/Referral_Activity_Report.csv) ![](/files/dd207a11d348872e1e27a6b04cce9bdb367c6a60) Bericht zur Empfehlungsaktivität.

**Spaltenreferenz des Berichts**

| Spalte                                                                                                                      | Beschreibung                                                                                                                                                          |
| --------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Empfehlungsmetadaten**                                                                                                    |                                                                                                                                                                       |
| ID                                                                                                                          | Eindeutige Kennung des Empfehlungsdatensatzes in Advocate.                                                                                                            |
| Geändert am                                                                                                                 | Das jüngste Datum, an dem ein Teil des Empfehlungsdatensatzes aktualisiert wurde.                                                                                     |
| Datum des Empfehlungsstarts                                                                                                 | Wann die Empfehlung erstmals initiiert wurde (z. B. wenn der empfohlene Benutzer auf einen Empfehlungslink geklickt hat).                                             |
| Konvertierungsdatum                                                                                                         | Wann die Empfehlung konvertiert wurde, typischerweise wenn der empfohlene Benutzer die erforderliche Aktion abgeschlossen hat (z. B. eine Anmeldung oder einen Kauf). |
| Datum der Benutzeränderung                                                                                                  | Der letzte Zeitpunkt, zu dem die an dieser Empfehlung beteiligten Benutzerdaten (Empfehler oder Empfohlener) aktualisiert wurden.                                     |
| Programm-ID                                                                                                                 | Die ID des Advocate-Empfehlungsprogramms, zu dem diese Empfehlung gehört.                                                                                             |
| Programmname                                                                                                                | Der Name des Empfehlungsprogramms, nützlich, wenn mehrere Programme verwaltet werden.                                                                                 |
| **Informationen zum empfohlenen Freund (Neukunde)**                                                                         |                                                                                                                                                                       |
| <p>E-Mail des empfohlenen Benutzers</p><p>Vorname des empfohlenen Benutzers</p><p>Nachname des empfohlenen Benutzers</p>    | Grundlegende Identitätsinformationen des empfohlenen Benutzers.                                                                                                       |
| Empfehlungscode des empfohlenen Benutzers                                                                                   | Der dem empfohlenen Benutzer zugewiesene Empfehlungscode (für den Fall, dass er später auch andere empfehlen kann).                                                   |
| <p>Erste gesehene IP des empfohlenen Benutzers</p><p>Zuletzt gesehene IP des empfohlenen Benutzers</p>                      | Bei der ersten und jüngsten Aktivität des empfohlenen Benutzers erfasste IP-Adressen.                                                                                 |
| Bild-URL des empfohlenen Benutzers                                                                                          | Bild- oder Avatar-URL, sofern beim empfohlenen Benutzer erfasst oder zugewiesen.                                                                                      |
| Gebietsschema des empfohlenen Benutzers                                                                                     | Sprach-/Regionseinstellung (z. B. *en-US*, *fr-FR*) des empfohlenen Benutzers.                                                                                        |
| Erstellungsdatum des empfohlenen Benutzers                                                                                  | Das Datum, an dem das Konto des empfohlenen Benutzers in Advocate erstellt wurde.                                                                                     |
| Empfohlener Benutzer                                                                                                        | Interne ID des empfohlenen Benutzers im Advocate-System.                                                                                                              |
| Empfohlenes Konto                                                                                                           | Mit dem empfohlenen Benutzer verknüpfte interne Konto-ID (wird in Multi-Account-Programmen verwendet).                                                                |
| **Informationen zum Empfehlenden (Kundenbotschafter)**                                                                      |                                                                                                                                                                       |
| <p>E-Mail des empfehlenden Benutzers</p><p>Vorname des empfehlenden Benutzers</p><p>Nachname des empfehlenden Benutzers</p> | Grundlegende Identitätsinformationen des empfehlenden Teilnehmers.                                                                                                    |
| Empfehlungscode des empfehlenden Benutzers                                                                                  | Der zum Empfehlenden gehörende Empfehlungscode, den der empfohlene Benutzer wahrscheinlich verwendet hat.                                                             |
| <p>Erste gesehene IP des empfehlenden Benutzers</p><p>Zuletzt gesehene IP des empfehlenden Benutzers</p>                    | Bei der ersten und jüngsten Aktivität des Empfehlenden erfasste IP-Adressen.                                                                                          |
| Bild-URL des empfehlenden Benutzers                                                                                         | Die URL des Bildes oder Avatars des Empfehlenden.                                                                                                                     |
| Gebietsschema des empfehlenden Benutzers                                                                                    | Gebietsschema-Einstellung des Empfehlenden.                                                                                                                           |
| Erstellungsdatum des empfehlenden Benutzers                                                                                 | Wann der Empfehlende erstmals beigetreten ist oder im System erfasst wurde.                                                                                           |
| Empfehlender Benutzer                                                                                                       | Interne ID des Empfehlenden in Advocate.                                                                                                                              |
| Konto des Empfehlenden                                                                                                      | Mit dem Empfehlenden verknüpfte Konto-ID.                                                                                                                             |
| **Moderation und Status**                                                                                                   |                                                                                                                                                                       |
| Moderationsstatus                                                                                                           | Gesamter Moderationsstatus der Empfehlung. (Z. B. *Genehmigt*, *Abgelehnt*, *Ausstehend*.)                                                                            |
| Datum der Moderation                                                                                                        | Das Datum, an dem die Moderationsentscheidung (Genehmigung/Ablehnung) getroffen wurde.                                                                                |
| Datum der Auszahlung der Empfehlung                                                                                         | Wann eine damit verbundene Belohnung für die Empfehlung ausgezahlt wurde.                                                                                             |
| Datum des Endes der Empfehlung                                                                                              | Wann der Empfehlungsdatensatz offiziell geschlossen wurde (z. B. aufgrund von Ablauf oder Abschluss).                                                                 |
| Moderationsstatus des Empfohlenen                                                                                           | Moderationsstatus, der sich speziell auf den Teil der Empfehlung des empfohlenen Benutzers bezieht.                                                                   |
| Moderationsstatus des Empfehlenden                                                                                          | Moderationsstatus, der sich speziell auf den Teil der Empfehlung des Empfehlenden bezieht.                                                                            |
| **Prämienreferenzen**                                                                                                       |                                                                                                                                                                       |
| Geworbene Prämie                                                                                                            | Die Prämien-ID oder Referenz, die dem geworbenen Nutzer ausgestellt wurde (falls zutreffend).                                                                         |
| Werber-Prämie                                                                                                               | Die Prämien-ID oder Referenz, die dem Werber ausgestellt wurde (falls zutreffend).                                                                                    |

</details>

#### Prämienguthaben nach Nutzer

Die *Prämienguthaben nach Nutzer* Der Bericht liefert eine Aufzeichnung ausstehender Prämien, einschließlich des Werts und des vorgesehenen Empfängers, die über Ihr Empfehlungsprogramm generiert wurden. Dieser Bericht wird häufig als Teil der manuellen Prämienauszahlung oder im Rahmen eines Batch-Prozesses an ein System wie Tango Card verwendet. Er kann auch nützlich sein, um nachzuverfolgen, wie viel Ihr Empfehlungsprogramm in einem bestimmten Zeitraum ausgezahlt hat.

<details>

<summary>Berichtsdetails</summary>

Standardmäßig enthält der Bericht:

* Teilnehmerdetails wie Name, Benutzer- und Konto-ID, E-Mail-Adresse und mehr
* Prämientyp
* Prämieneinheit
* Prämienbetrag

Eine vollständige Liste der Felder finden Sie beim [Herunterladen unserer Beispiel-CSV](https://assets.ctfassets.net/s68ib1kj8k5n/5iv0ByBQquLwShSyRjawck/e04b55a4e5afe24c01d5192c10682aab/Reward_Balances_by_User.csv) ![](/files/dd207a11d348872e1e27a6b04cce9bdb367c6a60) Bericht über Prämienguthaben.

**Spaltenreferenz des Berichts**

| Spalte                        | Beschreibung                                                                                                                                                                                                         |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Teilnehmerinformationen**   |                                                                                                                                                                                                                      |
| Benutzer-ID                   | Die eindeutige Kennung des Teilnehmers innerhalb von Advocate. Wird verwendet, um das Prämienguthaben mit dem einzelnen Nutzer zu verknüpfen.                                                                        |
| Konto-ID                      | Die interne Konto-ID, die dem Teilnehmer zugeordnet ist. Besonders relevant, wenn Nutzer zu Organisationen oder segmentierten Kontogruppen gehören.                                                                  |
| E-Mail                        | Die E-Mail-Adresse des Teilnehmers. Wird häufig für die manuelle Prämienauszahlung oder zur Synchronisierung mit externen Systemen verwendet.                                                                        |
| <p>Vorname</p><p>Nachname</p> | Der Vor- und Nachname des Teilnehmers. Nützlich für Personalisierung oder Filterung während der Prämienbearbeitung.                                                                                                  |
| Empfehlungscode               | Der dem Teilnehmer zugewiesene Empfehlungscode. Dies ist der Code, den er weitergibt, um andere zu werben und die Prämienberechtigung zu verfolgen.                                                                  |
| **Belohnungsinformationen**   |                                                                                                                                                                                                                      |
| Typ                           | Die Kategorie oder Methode der Prämie (z. B., *Bargeld*, *Geschenkkarte*, *Punkte*, *Benutzerdefiniert* ). Hilft dabei, zu bestimmen, wie Prämien ausgezahlt oder gruppiert werden sollen.                           |
| Einheit                       | Die Einheit des Prämienwerts (z. B., *USD*, *ZAR*, *Punkte*, *%* ). Wichtig für die Berechnung von Guthaben und für die regionale Auszahlungsabwicklung.                                                             |
| Betrag                        | Der gesamte verfügbare Saldo aus ausstehenden Prämien für diesen Nutzer. Dies ist der Kernwert, der bei der Vorbereitung von Auszahlungen oder Exporten verwendet wird.                                              |
| Gesamt zugewiesenes Guthaben  | Der gesamte Guthabenbetrag, der diesem Nutzer jemals zugewiesen wurde (unabhängig von der Einlösung). Spiegelt die insgesamt diesem Teilnehmer zugewiesenen Programmkosten wider.                                    |
| Gesamt eingelöstes Guthaben   | Der gesamte Anteil der Prämien, den dieser Teilnehmer bereits eingelöst hat. Nützlich für die Nachverfolgung der tatsächlichen Kosten gegenüber den Verbindlichkeiten.                                               |
| Gesamt verfallenes Guthaben   | Die gesamten Prämien, die dem Nutzer zugewiesen wurden, aber vor der Einlösung abgelaufen sind. Hilft dabei, nicht beanspruchte Prämien oder verpasste Auszahlungsgelegenheiten zu verfolgen.                        |
| **Benutzermetadaten**         |                                                                                                                                                                                                                      |
| Bild-URL                      | Profilbild- oder Avatar-URL des Teilnehmers (falls erfasst). Meist ästhetisch oder gegebenenfalls in benutzerseitigen Dashboards verwendet.                                                                          |
| Erste gesehene IP             | Die erste IP-Adresse, die erfasst wurde, als der Teilnehmer hinzugefügt wurde oder aktiv wurde. Nützlich für Compliance, Standortkennzeichnung oder Betrugsanalyse.                                                  |
| Zuletzt gesehene IP           | Die zuletzt mit dem Teilnehmer verknüpfte IP-Adresse. Hilft festzustellen, ob der Nutzer noch aktiv oder engagiert ist.                                                                                              |
| Erstellungsdatum              | Das Datum, an dem das Teilnehmerkonto in Advocate erstellt wurde. Nützlich für Kohortenanalysen oder das Prämienverhalten im Zeitverlauf.                                                                            |
| Empfehlungsquelle             | Die ursprüngliche Quelle oder der Kanal, über den der Teilnehmer gewonnen wurde (z. B., *E-Mail*, *organisch*, *partner* ). Hilft dabei, Reichweite und Wirksamkeit des Empfehlungsprogramms nach Kanal zu bewerten. |
| Gebietsschema                 | Die Sprache und regionale Einstellung des Teilnehmers (z. B., *en-US*, *fr-FR* ). Wichtig für personalisierte Kommunikation oder regionale Prämienoptionen.                                                          |

</details>

#### Verfügbare Prämienguthaben nach Benutzer

Die *Verfügbare Prämienguthaben nach Benutzer* Der Bericht liefert eine Liste nicht eingelöster Prämien. Dieser Berichtstyp ist dafür gedacht, im Rahmen der Prämienauszahlung über die [Sammel-Einlösung von Prämien](/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md) Prozess.

<details>

<summary>Berichtsdetails</summary>

Standardmäßig enthält der Bericht:

* Teilnehmerdetails wie Name, Benutzer- und Konto-ID, E-Mail-Adresse und mehr
* Prämieneinheit
* Prämienwährung
* Verfügbarer Betrag

Eine vollständige Liste der Felder finden Sie beim [Herunterladen unserer Beispiel-CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7CggBzV2U5EoJqp1HFF5SA/f3b417f460c0d960f8429b26824a225b/Available_Reward_Balances_by_User.csv) ![](/files/dd207a11d348872e1e27a6b04cce9bdb367c6a60) im Bericht über verfügbare Prämienguthaben.

{% hint style="info" %}
**Hinweis**: Dieser Bericht enthält keine Details zu Prämien vom Typ Prozent-Rabatt, Fuel Tank oder Geschenkkarte. Verwenden Sie den *Prämienguthaben nach Nutzer* Bericht für weitere Details zu diesen Prämientypen.
{% endhint %}

**Spaltenreferenz des Berichts**

| Spalte                           | Beschreibung                                                                                                                                                                                                                                                                                                                                         |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Teilnehmerinformationen**      |                                                                                                                                                                                                                                                                                                                                                      |
| Vorname                          | Der Vorname des Teilnehmers, verwendet zur Identifikation oder Personalisierung während der Prämienbearbeitung.                                                                                                                                                                                                                                      |
| Nachname                         | Der Nachname des Teilnehmers.                                                                                                                                                                                                                                                                                                                        |
| E-Mail                           | Die E-Mail-Adresse des Teilnehmers, verwendet zum Versenden von Prämien oder zum Abgleich mit externen Systemen wie einem CRM oder Prämienanbieter.                                                                                                                                                                                                  |
| Benutzer-ID                      | Die dem Teilnehmer innerhalb von Advocate zugewiesene eindeutige Kennung.                                                                                                                                                                                                                                                                            |
| Konto-ID                         | Die mit dem Teilnehmer verknüpfte interne Konto-ID.                                                                                                                                                                                                                                                                                                  |
| Segmente                         | Tags oder Kategorien, die verwendet werden, um [Teilnehmer zu gruppieren](/brand/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md) (z. B., *nach Region*, *nach Lebenszyklusphase*, *nach Kundentyp* ). Hilfreich zum Filtern oder Anwenden unterschiedlicher Auszahlungsregeln. |
| **Prämienstatus und -zeitpunkt** |                                                                                                                                                                                                                                                                                                                                                      |
| Datum der Sperrung               | Das Datum, an dem der Nutzer von der Prämienerstellung ausgeschlossen wurde, falls zutreffend. Ein gesperrter Status kann die Einlösung verhindern; dieses Feld gibt an, wann diese Sperre angewendet wurde.                                                                                                                                         |
| **Prämiendaten**                 |                                                                                                                                                                                                                                                                                                                                                      |
| Name der Einheit                 | Die Bezeichnung oder der Anzeigename der Prämieneinheit (z. B., *Empfehlungsgeld*, *Store-Guthaben* ). Dies hilft dabei, zwischen mehreren Prämientypen zu unterscheiden, die ein Programm anbieten kann.                                                                                                                                            |
| Währung                          | Der Währungscode des Prämienwerts (z. B., *USD*, *ZAR*, *EUR* ). Wird zur Auszahlung von Prämien benötigt, insbesondere länderübergreifend oder über verschiedene Auszahlungssysteme hinweg.                                                                                                                                                         |
| Verbleibender Wert               | Der Betrag der nicht eingelösten Prämie, der diesem Teilnehmer derzeit zur Verfügung steht. Dies ist der Kernwert, der bei der Bestimmung der Auszahlung verwendet wird.                                                                                                                                                                             |
| Einzulösender Wert               | Der aktuell zur Einlösung vorgemerkte Wert (z. B. ausstehend in einer Sammelbearbeitung oder wartend auf Verarbeitung). Nützlich, um doppelte Einlösungen zu verhindern oder Überschneidungen bei Einlösungen zu vermeiden.                                                                                                                          |
| Gesamt eingelöster Wert          | Der Gesamtwert der Prämien, die dieser Teilnehmer bereits eingelöst hat. Gibt Einblick in frühere Einlösungen und kann nützlich für die Nachverfolgung von Prämienobergrenzen sein                                                                                                                                                                   |
| Einheit                          | Der interne oder Systemcode für die Prämieneinheit (z. B., *USD*, *Punkte* , usw.). Kann bei API-Aufrufen oder in der internen Logik während der Auszahlung verwendet werden.                                                                                                                                                                        |

</details>

#### US-W-9-Steuerbericht

Der US-W-9-Steuerbericht zeigt den US-W-9-Steuerstatus der Teilnehmer sowie verdiente oder ausstehende Prämien nach Jahr.

<details>

<summary>Berichtsdetails</summary>

Standardmäßig enthält der Bericht:

* Teilnehmerdetails wie Name, Benutzer- und Konto-ID, E-Mail-Adresse und mehr
* Datum, an dem das W-9-Formular des Teilnehmers als eingegangen markiert wurde
* In den USA steuerpflichtiger Wert der pro Steuerjahr verdienten Prämien
* Gesamtanzahl der im Steuerjahr verdienten Prämien je Teilnehmer

**Spaltenreferenz des Berichts**

| Spalte                                                               | Beschreibung                                                                                                                                                                                                                                         |
| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Teilnehmerinformationen**                                          |                                                                                                                                                                                                                                                      |
| Benutzer-ID                                                          | Die eindeutige Kennung des Teilnehmers in Advocate.                                                                                                                                                                                                  |
| Konto-ID                                                             | Interne Konto-ID, die dem Teilnehmer zugeordnet ist.                                                                                                                                                                                                 |
| E-Mail                                                               | Die E-Mail-Adresse des Teilnehmers.                                                                                                                                                                                                                  |
| Vorname                                                              | Der Vorname des Teilnehmers.                                                                                                                                                                                                                         |
| Nachname                                                             | Der Nachname des Teilnehmers.                                                                                                                                                                                                                        |
| **W-9-Steuerinformationen**                                          |                                                                                                                                                                                                                                                      |
| <p>Datum der Einreichung des US-Steuerformulars</p><p>YYYY-MM-DD</p> | Das Datum, an dem das W-9-Formular des Teilnehmers in Advocate als eingereicht und erfasst markiert wurde. Wichtig für die IRS-Konformität und zur Überprüfung des Status der Steuerunterlagen.                                                      |
| **Zusammenfassung nach Steuerjahr**                                  |                                                                                                                                                                                                                                                      |
| Jahr                                                                 | Das Steuerjahr, in dem der Teilnehmer Prämien verdient hat. Wird verwendet, um Einnahmen für die 1099-Verarbeitung nach Kalenderjahr zu gruppieren.                                                                                                  |
| In US-Cent steuerpflichtiger Wert                                    | Gesamtwert der in den USA steuerpflichtigen Prämien, die dieser Teilnehmer im angegebenen Steuerjahr verdient hat, ausgedrückt in Cent (z. B. 2500 = 25,00 $). Hilft bei Rohberechnungen oder Integrationen, bei denen Genauigkeit erforderlich ist. |
| In US-Dollar steuerpflichtiger Wert                                  | Dasselbe wie oben, aber im standardmäßigen Dollarformat angezeigt (z. B. 25,00). Leichter zu prüfen oder in offizielle Zusammenfassungen aufzunehmen.                                                                                                |
| Anzahl                                                               | Gesamtanzahl der einzelnen Prämienvorgänge, die der Teilnehmer im angegebenen Steuerjahr verdient hat. Nützlich für Prüfpfade oder zum Verständnis der Prämienhäufigkeit und des Programmengagements.                                                |

</details>

#### Auszahlungen und Steuern

Die *Auszahlung und Steuer* Der Bericht zeigt den Steuerstatus der Teilnehmer sowie verdiente oder ausstehende Prämien nach Jahr.

Wenn Ihr Programm den Teilnehmern Barauszahlungen bietet, werden bestimmte Felder zum Status des Steuerformulars des Teilnehmers verfügbar gemacht.

<details>

<summary>Berichtsdetails</summary>

Standardmäßig enthält der Bericht:

* Teilnehmerdetails wie Name, Benutzer- und Konto-ID, E-Mail-Adresse und mehr
* Datum, an dem das Steuerformular des Teilnehmers – wie ein W-8 oder W-9 – als eingereicht markiert wurde
* In den USA steuerpflichtiger Wert der pro Steuerjahr verdienten Prämien
* Gesamtanzahl der im Steuerjahr verdienten Prämien je Teilnehmer
* Der Status des Steuerformulars, z. B., *gültig*, *zurückgehalten*, oder *ausstehenden*. Gründe für Auszahlungssperren sind ebenfalls im Bericht enthalten

**Spaltenreferenz des Berichts**

| Spalte                                                               | Beschreibung                                                                                                                                                                                                                                                     |
| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Teilnehmerinformationen**                                          |                                                                                                                                                                                                                                                                  |
| Benutzer-ID                                                          | Die eindeutige Kennung des Teilnehmers in Advocate.                                                                                                                                                                                                              |
| Konto-ID                                                             | Die Konto-ID des Teilnehmers, verwendet für Gruppierungs- oder Organisationsberichte.                                                                                                                                                                            |
| E-Mail                                                               | Die E-Mail-Adresse des Teilnehmers.                                                                                                                                                                                                                              |
| Vorname                                                              | Der Vorname des Teilnehmers.                                                                                                                                                                                                                                     |
| Nachname                                                             | Der Nachname des Teilnehmers.                                                                                                                                                                                                                                    |
| **W-9-Steuerinformationen**                                          |                                                                                                                                                                                                                                                                  |
| <p>Datum der Einreichung des US-Steuerformulars</p><p>YYYY-MM-DD</p> | Das Datum, an dem der Teilnehmer sein W-9-Formular (oder das relevante US-Steuerformular) eingereicht hat. Wichtig für die Überprüfung der Steuerberechtigung vor der Auszahlung von Bargeldprämien.                                                             |
| **Zusammenfassung nach Auszahlungsjahr**                             |                                                                                                                                                                                                                                                                  |
| Jahr                                                                 | Das Kalenderjahr, in dem der Teilnehmer die Prämien verdient hat.                                                                                                                                                                                                |
| Wert                                                                 | Gesamtauszahlungswert in kleinsten Einheiten (z. B. Cent), den dieser Teilnehmer im Jahr verdient hat oder der im Laufe des Jahres aussteht. Zum Beispiel entspricht 1750 = 17,50 $.                                                                             |
| Wert in Dollar                                                       | Gleicher Wert, angezeigt im standardmäßigen Währungsformat zur einfachen Überprüfung (z. B. 17,50).                                                                                                                                                              |
| Anzahl                                                               | Gesamtanzahl der einzelnen Auszahlungs-Prämienvorgänge für den Teilnehmer im angegebenen Jahr. Nützlich, um zu verstehen, wie oft ein Teilnehmer Auszahlungen verdient hat.                                                                                      |
| **Auszahlungsberechtigung und -status**                              |                                                                                                                                                                                                                                                                  |
| Auszahlungssperre                                                    | Gibt an, ob die Auszahlungen des Teilnehmers derzeit gesperrt sind (Ja oder Nein). Auszahlungen können aufgrund fehlender Steuerformulare oder einer unvollständigen Einrichtung gesperrt werden.                                                                |
| Gründe für Auszahlungssperren                                        | Erklärt, warum die Auszahlung des Teilnehmers gesperrt ist (falls zutreffend). Beispielgründe: *Fehlendes Steuerformular*, *Bankdaten nicht angegeben*, *Compliance-Prüfung*.                                                                                    |
| Auszahlungswährung                                                   | Die Währung, in der die Auszahlungen des Teilnehmers verarbeitet werden oder verarbeitet werden sollen (z. B., *USD*, *EUR*, *ZAR* ). Wichtig für globale Auszahlungssysteme und die Buchhaltung.                                                                |
| Auszahlungssetup gestartet                                           | Gibt an, ob der Teilnehmer mit der Einrichtung seiner Auszahlungsmethode begonnen hat (z. B. über eine Integration eines Auszahlungsanbieters). Hilft dabei, den Onboarding-Fortschritt oder den Nachverfolgungsbedarf für ausstehende Auszahlungen zu erfassen. |

</details>


---

# 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-reporting-and-analytics/advocate-program-reports-explained.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.
