> 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
Belegen Sie den PXA-Kurs
Advocate bietet verschiedene herunterladbare Berichte für Ihre Programmdaten und Teilnehmerdaten an. Alle Berichte verfügen über Filteroptionen, damit Sie mehr Kontrolle über die heruntergeladenen Daten haben. Jeder Bericht kann als .CSV- oder Excel-Datei heruntergeladen werden.
Dieser Artikel erklärt die verschiedenen Berichte und welche Art von Daten jeder enthält. 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.
#### Bericht mit Benutzerdetails
Die *Benutzerdetails* Der Bericht enthält detaillierte Informationen zu jedem Teilnehmer in all Ihren Programmen. Exportieren Sie eine Liste aller Teilnehmer, um Ihre Datensätze mit den Advocate-Freigabelinks und Empfehlungscodes auf dem neuesten Stand zu halten.
Berichtsdetails
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.
* **Freigabelinks und -codes für Empfehlungen**, falls zutreffend. Diese Informationen können beim Aktualisieren von Kontaktdatensätzen in Ihrem CMS oder E-Mail-System hilfreich sein, um die Advocate-Freigabelinks und -Codes jedes Teilnehmers einzuschließen.
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)  Bericht zu den Benutzerdetails.
**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 in mehreren Programmen 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 des Teilnehmers, nützlich für datenschutzkonformes Abgleichen mit anderen Systemen. |
| **Empfehlungs- und Freigabeinformationen** | |
| Empfehlungscode | Der eindeutige Code, der dem Teilnehmer zugeordnet ist und zum Nachverfolgen der von ihm generierten Empfehlungen verwendet wird. |
| Freigabelink | Der eindeutige Empfehlungslink, der dem Teilnehmer zugeordnet ist. |
| Facebook-Freigabelink | Ein vorab erstellter Link zum Teilen der Empfehlung auf Facebook. |
| Twitter-Freigabelink | Ein vorab erstellter Link zum Teilen der Empfehlung auf Twitter. |
| E-Mail-Freigabelink | Ein vorab erstellter Link zum Teilen der Empfehlung per E-Mail. |
| LinkedIn-Freigabelink | Ein vorab erstellter Link zum Teilen der Empfehlung auf LinkedIn. |
| Bereinigter Freigabelink | Eine Version des Empfehlungslinks ohne Tracking-Parameter; für bestimmte Plattformen oder Anwendungsfälle neutraler. |
| **Geolokalisierung & Gebietsschema** | |
| Erstmals gesehene IP | Die IP-Adresse, von der aus der Teilnehmer erstmals erfasst wurde. |
| Zuletzt gesehene IP | Die zuletzt für diesen Teilnehmer gesehene IP-Adresse. |
| Gebietsschema | Die bevorzugte Sprache und Regionseinstellungen 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 Einreichung des US-Steuerformulars | (Falls zutreffend) Das Datum, an dem ein US-Steuerformular zur Einhaltung von Vorschriften oder zur Prämienverarbeitung eingereicht wurde. |
| **Benutzerstatistiken (falls im Export enthalten)** | |
| stats.date Geändert | Das letzte Datum, an dem die Statistiken des Teilnehmers aktualisiert wurden. |
| stats.traffic | Gesamtzahl der Besuche, die durch die Empfehlungsaktivität des Teilnehmers verursacht wurden. |
| stats.Empfehlungen | Gesamtzahl der vom Teilnehmer erfolgreich vermittelten Empfehlungen. |
| stats.Konversionen | Gesamtzahl der Conversions (z. B. Käufe, Anmeldungen), die aus diesen Empfehlungen resultierten. |
| stats.Ziele | Anzahl der spezifischen Zielabschlüsse, die mit der Empfehlungsaktivität des Teilnehmers verknüpft sind (im Programm benutzerdefiniert definiert). |
| stats.Belohnungen | Gesamtzahl der Belohnungen, die der Teilnehmer erhalten hat. |
| stats.Widget-Ladevorgänge | Anzahl der Male, die das Empfehlungs-Widget oder die Freigabeoberfläche von diesem Teilnehmer geladen wurde. |
| stats.Umsatz | Der gesamte Umsatz, der von Nutzern generiert wurde, die von diesem Teilnehmer geworben wurden. |
| stats.generierter Umsatz | Synonym für stats.revenue; einige Berichte unterscheiden möglicherweise, wenn der Umsatz aus mehreren Quellen stammt. |
| stats.zugeordneter Umsatz | Umsatz, der speziell Teilnehmern zugeschrieben wird, die sich über den Empfehlungslink dieses Teilnehmers angemeldet oder einen Kauf getätigt haben. |
| **Benutzerdefinierte Daten** | |
| custom Fields.Beispiel | Ein Platzhalter für alle von Ihrem Programm definierten benutzerdefinierten Felder (z. B., *Treue-ID*, *interne Notizen*, *Regions-Tag*). Jedes Feld wird als eigene Spalte angezeigt, mit dem Präfix custom Fields. |
| **Sonstige** | |
| Empfehlungsquelle | Die ursprüngliche Quelle oder der Kanal, der den Teilnehmer zu Ihrem Programm geführt hat (z. B., *organisch*, *E-Mail*, *Partner-Website*). |
#### Export der Benutzerereignisse
Die *Export der Benutzerereignisse* Der Bericht bietet eine Aufzeichnung aller Benutzerereignisse, die wir von Ihrer Organisation für Ihr Advocate-Programm erhalten haben. Sie können Filter anwenden, um einen Zeitraum, einen Ereignisschlüssel, eine Benutzer-ID und mehr einzugrenzen.
Berichtsdetails
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 das Nachverfolgen, Debuggen oder Prüfen von Ereignisübermittlungen. |
| Ereignisschlüssel | Der Typ oder die Bezeichnung des Ereignisses, wie z. B. `Kauf`, `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 mit dem Benutzer verknüpfte Konto-ID, besonders relevant in Programmen, in denen Benutzer zu unterschiedlichen Kontostrukturen gehören können. |
| **Ereignis-Zeitstempel** | |
| 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, an dem ein Kauf oder eine Anmeldung stattfand. |
| Ereignis-Empfangsdatum – JJJJ-MM-TT | Das Datum, an dem Advocate das Ereignis von Ihrem System erhalten hat. Kann aufgrund von Stapelverarbeitung oder Systemverzögerungen vom Auslösedatum abweichen. |
| Ereignis-Verarbeitungsdatum – JJJJ-MM-TT | Das Datum, an dem das Ereignis erfolgreich verarbeitet und in Advocate gespeichert wurde. Markiert, wann das Ereignis für Tracking, Prämien oder Berichte nutzbar wurde. |
| **Ereignisdatenfelder (falls in Ihren Ereignis-Payloads enthalten)** | |
| fields.coupon | Ein während des Ereignisses angewendeter Coupon- oder Rabattcode, falls in den Ereignisdaten gesendet. Nützlich zum Nachverfolgen der Nutzung von Anreizen oder bestimmter Promotionsauslöser. |
| fields.revenue | Der mit dem Ereignis verknüpfte Umsatzbetrag. Wird typischerweise in Kaufereignissen verwendet, um Leistung, Prämien oder ROI zu berechnen. |
| fields.Währung | Der Währungscode (z. B., *USD*, *ZAR*, *EUR*) der mit dem Umsatzbetrag verknüpft ist. Wichtig bei Berichten über Regionen hinweg oder bei der Berechnung von wechselkursbereinigten Prämien. |
| fields.Lead-Erstellungsdatum | Das ursprüngliche Datum, an dem der Lead (Benutzer) in Ihrem System erstellt wurde, sofern es als Teil des Ereignisses übermittelt wurde. Hilft, Benutzerereignisse mit ursprünglichen Akquisitionsdaten oder CRM-Datensätzen zu verknüpfen. |
#### Prämienhistorie
Die *Prämienhistorie* Der Bericht bietet eine detaillierte Aufzeichnung jeder Ihrer Prämien sowie der Beziehungen zu Teilnehmern und Empfehlungen. Diese Informationen können nützlich sein, um Bilanzen zu erstellen und den Status aller Ihrer Prämien zu einem bestimmten Zeitpunkt abzurufen.
Berichtsdetails
Standardmäßig enthält der Bericht **Prämienfelder** Informationen wie:
* Prämien-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)  oder [Beispiel-JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl)  Berichten zu Prämien-Details.
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 Kunden-Advocates, Felder des empfohlenen Freundes und mehr.
**Spaltenreferenz des Berichts**
| Spalte | Beschreibung |
| --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Prämieninformationen** | |
| ID | Eindeutige ID der Prämieninstanz (von Advocate generiert). |
| Typ | Die Prämienkategorie oder der Typ (z. B. *Bargeld*, *Geschenkkarte*, *Coupon*, *Benutzerdefiniert*). |
| Wert | Der numerische Wert der Prämie (z. B. 10, 100 usw.). |
| Einheit | Die mit dem Wert verknüpfte Einheit (z. B., *USD*, *Punkte*, *ZAR*, *%*). |
| Name | Anzeigename der Prämie (wie definiert in der [Prämienkonfiguration](/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/create-a-reward.md)). |
| Prämienquelle | Beschreibt, was die Prämie ausgelöst hat (z. B. *Empfehlung*, *Ziel*, *Manuell*, *API*). |
| Fuel-Tank-Typ | Der verwendete Typ des Prämienguthabens (bei Verwendung der FuelTank-Integration). Z. B., *Prepaid*, *Geschenkkarte*. |
| FuelTank-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 Prämie ausgegeben wurde. |
| Programm-Prämien-Schlüssel | Interne Kennung für die spezifische Prämienkonfiguration, die im Programm verwendet wird. |
| Globaler Prämien-Schlüssel | Programmübergreifende Kennung für auf globaler Ebene konfigurierte Prämien (falls zutreffend). |
| **Prämien-Zeitstempel** | |
| Erstellungsdatum | Wann der Prämien-Datensatz im System erstellt wurde. |
| Geplantes Datum | Wann die Prämie zur Ausgabe geplant wurde (z. B. nach einer Verzögerung oder Wartezeit). |
| Vergebungsdatum | Wann die Prämie tatsächlich an den Teilnehmer ausgegeben wurde. |
| Ablaufdatum | Das Ablaufdatum der Prämie (falls zutreffend). |
| Stornierungsdatum | Das Datum, an dem die Prämie für ungültig erklärt oder storniert wurde. |
| Einlösedatum | Das Datum, an dem der Teilnehmer die Prämie eingelöst hat (falls zutreffend). |
| Änderungsdatum | Das Datum, an dem die jüngste Aktualisierung des Prämien-Datensatzes vorgenommen wurde. |
| **Kredit- und Wertverfolgung** | |
| Zugewiesenes Guthaben | Der diesem Prämienposten zugewiesene Guthabenbetrag (kann in einigen Modellen vom Wert abweichen). |
| Eingelöstes Guthaben | Der Guthabenbetrag, der von der Prämie eingelöst wurde. |
| Verfügbarer Wert | Der verbleibende ungenutzte oder nicht eingelöste Teil der Prämie. |
| **Prämienstatus & Nachrichten** | |
| Status | Aktueller Status der Prämie (z. B. *Ausstehend*, *Geplant*, *Vergeben*, *Abgelaufen*, *Abgebrochen*). |
| meta.status | Technischer oder systemseitiger Status (nützlich für Diagnose oder Fehlerbehandlung). |
| meta.Nachricht | Mit der Auslieferung der Prämie verknüpfte Nachricht (z. B. „Prämie erfolgreich zugestellt“). |
| meta.interne Nachricht | Nur interne Notizen für Administratoren (z. B. Erklärungen zu Fehlern oder Kennzeichnungen). |
| meta.date Geändert | Letztes Mal, dass die mit der Prämie verbundenen Metadaten aktualisiert wurden. |
| meta.customMeta.testMeta | Ein Platzhalter für alle benutzerdefinierten Metadatenfelder, die Ihr Programm sendet (in diesem Fall ist testMeta ein Beispiel). |
| **Teilnehmer-(Benutzer-)Informationen** | |
| user.id | ID des Benutzers, der die Prämie erhält. |
| user.Konto-ID | Die zugehörige Konto-ID des Benutzers in Advocate. |
| user.Vorname
user.Nachname
user.E-Mail
| Grundlegende Teilnehmerinformationen, die als Referenz oder für den CRM-Abgleich enthalten sind. |
| **Empfehlungskontext (falls die Prämie empfehlungsbasiert ist)** | |
| referral.id | Die ID der Empfehlung, die diese Prämie ausgelöst hat. |
| referral.Empfehlungsstartdatum | Wann die Empfehlungsaktion begann (z. B. Klick- oder Freigabeereignis). |
| referral.Geändert | Wann der Empfehlungsdatensatz zuletzt aktualisiert wurde. |
| referral.verwendeter Empfehlungscode | 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.Konto-ID | Die eindeutige Konto-ID des Empfehliers. |
| referral.referred User.Vorname
referral.referred User.Nachname
referral.referred User.E-Mail
| Die grundlegenden Kontaktdaten des Empfehliers. |
| **Informationen zum Empfehler (Advocate)** | |
| referral.referrer User.id | ID der Person, die die Empfehlung abgegeben hat (der „Advocate“). |
| referral.referrer User.Konto-ID | Die eindeutige Konto-ID des Empfehliers. |
| referral.referrer User.Vorname
referral.referrer User.Nachname
referral.referrer User.E-Mail
| Die grundlegenden Kontaktdaten des Empfehliers. |
| referral.Datum der Konvertierung | Das Datum, an dem die Empfehlung offiziell konvertiert wurde (z. B. abgeschlossene Anmeldung oder Kauf), wodurch die Prämie ausgelöst wurde. |
#### Empfehlungsverlauf
Die *Empfehlungsverlauf* Der Bericht bietet eine Aufzeichnung des Status jeder in Ihrem Empfehlungsprogramm hergestellten Empfehlungsverbindung. Diese Informationen können nützlich sein, um den Erfolg Ihres Programms zu überprüfen und die Anzahl der neuen Kunden zu verfolgen, die Ihr Programm gebracht hat.
Berichtsdetails
Standardmäßig enthält der Bericht:
* Details zum empfohlenen Freund wie Name, Benutzer- und Konto-ID, E-Mail-Adresse und mehr
* Details zum Kunden-Advocate wie Name, Benutzer- und Konto-ID, E-Mail-Adresse und mehr
* Empfehlungsstatus
* Moderationsstatus
* Prämien-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)  Bericht zur Empfehlungsaktivität.
**Spaltenreferenz des Berichts**
| Spalte | Beschreibung |
| ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Empfehlungsmetadaten** | |
| ID | Eindeutige Kennung des Empfehlungsdatensatzes in Advocate. |
| Änderungsdatum | Das aktuellste Datum, an dem irgendein 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). |
| Datum der Konvertierung | 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, an 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 bei der Verwaltung mehrerer Programme. |
| **Informationen zum empfohlenen Freund (Neukunde)** | |
| E-Mail des empfohlenen Benutzers
Vorname des empfohlenen Benutzers
Nachname des empfohlenen Benutzers
| Grundlegende Identitätsinformationen des empfohlenen Benutzers. |
| Empfehlungscode des empfohlenen Benutzers | Der dem empfohlenen Benutzer zugewiesene Empfehlungscode (falls er später ebenfalls andere empfehlen kann). |
| Erstmals gesehene IP des empfohlenen Benutzers
Zuletzt gesehene IP des empfohlenen Benutzers
| IP-Adressen, die bei der ersten und jüngsten Aktivität des empfohlenen Benutzers erfasst wurden. |
| Bild-URL des empfohlenen Benutzers | Bild- oder Avatar-URL, falls für den 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 | Interne Konto-ID, die mit dem empfohlenen Benutzer verknüpft ist (in Programmen mit mehreren Konten verwendet). |
| **Informationen zum Empfehler (Kunden-Advocate)** | |
| E-Mail des Empfehliers
Vorname des Empfehliers
Nachname des Empfehliers
| Grundlegende Identitätsinformationen des empfehlenden Teilnehmers. |
| Empfehlungscode des Empfehliers | Der dem Empfehler zugehörige Empfehlungscode, also der Code, den der empfohlene Benutzer wahrscheinlich verwendet hat. |
| Erstmals gesehene IP des Empfehliers
Zuletzt gesehene IP des Empfehliers
| IP-Adressen, die bei der ersten und jüngsten Aktivität des Empfehliers erfasst wurden. |
| Bild-URL des Empfehliers | Die URL des Bildes oder Avatars des Empfehliers. |
| Gebietsschema des Empfehliers | Gebietsschema-Einstellung des Empfehliers. |
| Erstellungsdatum des Empfehliers | Wann der Empfehler dem System erstmals beigetreten ist oder darin erfasst wurde. |
| Empfehler | Interne ID des Empfehliers in Advocate. |
| Empfehler-Konto | Konten-ID, die mit dem Empfehlungsgeber verknüpft ist. |
| **Moderation & Status** | |
| Moderationsstatus | Gesamtmoderationsstatus der Empfehlung. (Z. B., *Genehmigt*, *Abgelehnt*, *Ausstehend*.) |
| Moderiert am | Das Datum, an dem die Moderationsentscheidung (Genehmigung/Ablehnung) getroffen wurde. |
| Datum der Auszahlungs-Empfehlung | Wann eine zugehörige 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 der empfohlenen Person | Moderationsstatus, der sich auf den Teil der Empfehlung für die empfohlene Person bezieht. |
| Moderationsstatus des Empfehlungsgebers | Moderationsstatus, der sich auf den Teil der Empfehlung für den Empfehlungsgeber bezieht. |
| **Belohnungsreferenzen** | |
| Belohnung für die empfohlene Person | Die Belohnungs-ID oder Referenz, die der empfohlenen Person zugewiesen wurde (falls zutreffend). |
| Belohnung für den Empfehlungsgeber | Die Belohnungs-ID oder Referenz, die dem Empfehlungsgeber zugewiesen wurde (falls zutreffend). |
#### Belohnungssalden nach Benutzer
Die *Belohnungssalden nach Benutzer* Der Bericht liefert eine Aufstellung offener Belohnungen, einschließlich des Werts und des vorgesehenen Empfängers, die über Ihr Empfehlungsprogramm generiert wurden. Dieser Bericht wird häufig als Teil der manuellen Belohnungsauszahlung oder als Teil 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.
Berichtsdetails
Standardmäßig enthält der Bericht:
* Teilnehmerdetails wie Name, Benutzer- und Konten-ID, E-Mail-Adresse und mehr
* Belohnungsart
* Belohnungseinheit
* Belohnungsbetrag
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)  Bericht zu Belohnungssalden.
**Spaltenreferenz des Berichts**
| Spalte | Beschreibung |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Teilnehmerinformationen** | |
| Benutzer-ID | Die eindeutige Kennung des Teilnehmers innerhalb von Advocate. Wird verwendet, um den Belohnungssaldo mit dem einzelnen Benutzer zu verknüpfen. |
| Konto-ID | Die interne Konten-ID, die dem Teilnehmer zugeordnet ist. Besonders relevant, wenn Benutzer Organisationen oder segmentierten Kontogruppen angehören. |
| E-Mail | Die E-Mail-Adresse des Teilnehmers. Wird häufig für die manuelle Belohnungsauszahlung oder die Synchronisierung mit externen Systemen verwendet. |
| Vorname
Nachname
| Der Vor- und Nachname des Teilnehmers. Nützlich für Personalisierung oder Filterung bei der Belohnungsbearbeitung. |
| Empfehlungscode | Der dem Teilnehmer zugewiesene Empfehlungscode. Dies ist der Code, den er weitergibt, um andere zu empfehlen und die Berechtigung für Belohnungen nachzuverfolgen. |
| **Prämieninformationen** | |
| Typ | Die Kategorie oder Methode der Belohnung (z. B., *Bargeld*, *Geschenkkarte*, *Punkte*, *Benutzerdefiniert*). Hilft festzustellen, wie Belohnungen ausgezahlt oder gruppiert werden sollen. |
| Einheit | Die Einheit des Belohnungswerts (z. B., *USD*, *ZAR*, *Punkte*, *%*). Wichtig für die Berechnung von Salden und für die regionale Auszahlungsabwicklung. |
| Betrag | Der gesamte verfügbare Saldo aus offenen Belohnungen für diesen Benutzer. Dies ist die Kernzahl, die bei der Vorbereitung von Auszahlungen oder Exporten verwendet wird. |
| Gesamte zugewiesene Gutschrift | Der gesamte Betrag an Gutschriften, der diesem Benutzer jemals zugewiesen wurde (unabhängig von der Einlösung). Zeigt die gesamten Programmkosten an, die diesem Teilnehmer zugeordnet wurden. |
| Gesamte eingelöste Gutschrift | Der gesamte Anteil der Belohnungen, den dieser Teilnehmer bereits eingelöst hat. Nützlich für die Überprüfung tatsächlicher Kosten gegenüber Verbindlichkeiten. |
| Gesamte abgelaufene Gutschrift | Gesamte Belohnungen, die dem Benutzer zugewiesen wurden, aber vor der Einlösung abgelaufen sind. Hilft dabei, nicht beanspruchte Belohnungen oder verlorene Auszahlungsmöglichkeiten nachzuverfolgen. |
| **Benutzermetadaten** | |
| Bild-URL | Profilbild oder Avatar-URL des Teilnehmers (falls erfasst). Meist ästhetisch oder gegebenenfalls für benutzerseitige Dashboards verwendet. |
| Erstmals gesehene IP | Die erste IP-Adresse, die erfasst wurde, als der Teilnehmer hinzugefügt wurde oder aktiv wurde. Nützlich für Compliance, Standortzuordnung oder Betrugsanalyse. |
| Zuletzt gesehene IP | Die aktuellste mit dem Teilnehmer verknüpfte IP-Adresse. Hilft festzustellen, ob der Benutzer noch aktiv oder engagiert ist. |
| Erstellungsdatum | Das Datum, an dem das Teilnehmerkonto in Advocate erstellt wurde. Nützlich für Kohortenanalysen oder das Belohnungsverhalten 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 Regionseinstellung des Teilnehmers (z. B., *en-US*, *fr-FR*). Wichtig für personalisierte Kommunikation oder regionale Belohnungsoptionen. |
#### Verfügbare Prämienguthaben nach Benutzer
Die *Verfügbare Prämienguthaben nach Benutzer* Der Bericht liefert eine Liste nicht eingelöster Belohnungen. Dieser Berichtstyp ist dazu gedacht, als Teil der Belohnungsauszahlung über den [Massen-Belohnungseinlösung](/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md) Prozess verwendet zu werden.
Berichtsdetails
Standardmäßig enthält der Bericht:
* Teilnehmerdetails wie Name, Benutzer- und Konten-ID, E-Mail-Adresse und mehr
* Belohnungseinheit
* Belohnungswä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)  im Bericht über verfügbare Belohnungssalden.
{% hint style="info" %}
**Hinweis**: Dieser Bericht enthält keine Details zu Belohnungen vom Typ Prozent-Rabatt, Fuel Tank oder Geschenkkarte. Verwenden Sie den *Belohnungssalden nach Benutzer* Bericht
{% endhint %}
**Spaltenreferenz des Berichts**
| Spalte | Beschreibung |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Teilnehmerinformationen** | |
| Vorname | Der Vorname des Teilnehmers, verwendet zur Identifizierung oder Personalisierung bei der Belohnungsbearbeitung. |
| Nachname | Der Nachname des Teilnehmers. |
| E-Mail | Die E-Mail-Adresse des Teilnehmers, verwendet, um Belohnungen zu senden oder sie mit externen Systemen wie einem CRM oder Belohnungsanbieter abzugleichen. |
| Benutzer-ID | Die eindeutige Kennung, die dem Teilnehmer innerhalb von Advocate zugewiesen wurde. |
| Konto-ID | Die mit dem Teilnehmer verknüpfte interne Konten-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*, *Lebenszyklusphase*, *Kundentyp*). Hilfreich zum Filtern oder Anwenden unterschiedlicher Auszahlungsregeln. |
| **Belohnungsstatus & Zeitplanung** | |
| Blockiert am | Das Datum, an dem der Benutzer vom Erhalt von Belohnungen ausgeschlossen wurde, falls zutreffend. Ein blockierter Status kann die Einlösung verhindern; dieses Feld zeigt, wann diese Sperre angewendet wurde. |
| **Belohnungsdaten** | |
| Einheitsname | Die Bezeichnung oder der Anzeigename der Belohnungseinheit (z. B., *Empfehlungs-Cash*, *Guthaben im Store*). Dies hilft, zwischen mehreren Belohnungstypen zu unterscheiden, die ein Programm anbieten könnte. |
| Währung | Der Währungscode des Belohnungswerts (z. B., *USD*, *ZAR*, *EUR*). Wird für die Belohnungsauszahlung benötigt, insbesondere länderübergreifend oder bei Auszahlsystemen. |
| Verfügbarer Wert | Der Betrag der nicht eingelösten Belohnung, der diesem Teilnehmer derzeit zur Verfügung steht. Dies ist der Kernwert, der bei der Bestimmung der Auszahlung verwendet wird. |
| Einzulösender Wert | Der derzeit zur Einlösung vorgemerkte Wert (z. B. in einer Massen-Auszahlung ausstehend oder wartend auf Verarbeitung). Nützlich, um Doppelteinlösungen zu verhindern oder Überschneidungen bei Einlösungen sicherzustellen. |
| Gesamter eingelöster Wert | Der Gesamtwert der Belohnungen, die dieser Teilnehmer bereits eingelöst hat. Gibt Einblick in vergangene Einlösungen und kann für die Nachverfolgung von Belohnungsobergrenzen nützlich sein |
| Einheit | Der interne oder Systemcode für die Belohnungseinheit (z. B., *USD*, *Punkte*, usw.). Kann bei API-Aufrufen oder interner Logik während der Auszahlung verwendet werden. |
#### U.S.-Steuerbericht W-9
Der US-W-9-Steuerbericht zeigt den US-W-9-Steuerstatus der Teilnehmer sowie jährlich verdiente oder ausstehende Belohnungen.
Berichtsdetails
Standardmäßig enthält der Bericht:
* Teilnehmerdetails wie Name, Benutzer- und Konten-ID, E-Mail-Adresse und mehr
* Datum, an dem das W-9-Formular des Teilnehmers als erfasst markiert wurde
* US-pflichtiger Wert der pro Steuerjahr verdienten Belohnungen
* Gesamtanzahl der im Steuerjahr verdienten Belohnungen je Teilnehmer
**Spaltenreferenz des Berichts**
| Spalte | Beschreibung |
| -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Teilnehmerinformationen** | |
| Benutzer-ID | Die eindeutige Kennung des Teilnehmers in Advocate. |
| Konto-ID | Mit dem Teilnehmer verknüpfte interne Konten-ID. |
| E-Mail | Die E-Mail-Adresse des Teilnehmers. |
| Vorname | Der Vorname des Teilnehmers. |
| Nachname | Der Nachname des Teilnehmers. |
| **W-9-Steuerinformationen** | |
| Datum der Einreichung des US-Steuerformulars
JJJJ-MM-TT
| Das Datum, an dem das W-9-Formular des Teilnehmers in Advocate als eingereicht und erfasst markiert wurde. Wichtig für die IRS-Compliance und zur Überprüfung des Status der Steuerdokumentation. |
| **Zusammenfassung des Steuerjahres** | |
| Jahr | Das Steuerjahr, in dem der Teilnehmer Belohnungen verdient hat. Wird verwendet, um Einnahmen nach Kalenderjahr für die 1099-Verarbeitung zu gruppieren. |
| US-pflichtiger Wert in Cent | Gesamtwert der in den USA steuerpflichtigen Belohnungen, 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. |
| US-pflichtiger Wert in Dollar | Gleicher Wert, aber im Standard-Dollarformat angezeigt (z. B. 25,00). Leichter zu prüfen oder in offizielle Zusammenfassungen aufzunehmen. |
| Anzahl | Gesamtanzahl der einzelnen Belohnungsinstanzen, die der Teilnehmer im angegebenen Steuerjahr verdient hat. Nützlich für Prüfpfade oder zum Verständnis der Belohnungshäufigkeit und des Programm-Engagements. |
#### Auszahlungen und Steuern
Die *Auszahlung und Steuern* Der Bericht zeigt den Steuerstatus der Teilnehmer sowie jährlich verdiente oder ausstehende Belohnungen.
Wenn Ihr Programm den Teilnehmern Barauszahlungen anbietet, werden bestimmte Felder zum Status des Steuerformulars des Teilnehmers verfügbar gemacht.
Berichtsdetails
Standardmäßig enthält der Bericht:
* Teilnehmerdetails wie Name, Benutzer- und Konten-ID, E-Mail-Adresse und mehr
* Datum, an dem das Steuerformular des Teilnehmers – wie ein W-8 oder W-9 – als eingereicht markiert wurde
* US-pflichtiger Wert der pro Steuerjahr verdienten Belohnungen
* Gesamtanzahl der im Steuerjahr verdienten Belohnungen je Teilnehmer
* Der Status des Steuerformulars, z. B., *gültig*, *zurückgestellt*, oder *ausstehenden*. Gründe für eine Zurückstellung der Auszahlung sind ebenfalls im Bericht enthalten
**Spaltenreferenz des Berichts**
| Spalte | Beschreibung |
| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Teilnehmerinformationen** | |
| Benutzer-ID | Die eindeutige Kennung des Teilnehmers in Advocate. |
| Konto-ID | Die Konten-ID des Teilnehmers, verwendet für Gruppierungen oder organisatorische Berichte. |
| E-Mail | Die E-Mail-Adresse des Teilnehmers. |
| Vorname | Der Vorname des Teilnehmers. |
| Nachname | Der Nachname des Teilnehmers. |
| **W-9-Steuerinformationen** | |
| Datum der Einreichung des US-Steuerformulars
JJJJ-MM-TT
| Das Datum, an dem der Teilnehmer sein W-9-Formular (oder das relevante US-Steuerformular) eingereicht hat. Wichtig zur Überprüfung der Steuerberechtigung vor der Auszahlung von Bargeldbelohnungen. |
| **Zusammenfassung des Auszahlungsjahres** | |
| Jahr | Das Kalenderjahr, in dem der Teilnehmer die Belohnungen verdient hat. |
| Wert | Gesamter Auszahlungswert in Mindesteinheiten (z. B. Cent), der für diesen Teilnehmer im Jahr verdient oder ausstehend ist. Beispiel: 1750 = 17,50 $. |
| Wert in Dollar | Gleicher Wert, im Standard-Währungsformat angezeigt, damit er leicht geprüft werden kann (z. B. 17,50). |
| Anzahl | Gesamtanzahl der einzelnen Auszahlungs-Belohnungsinstanzen für den Teilnehmer im angegebenen Jahr. Nützlich, um zu verstehen, wie oft ein Teilnehmer Auszahlungen verdient hat. |
| **Auszahlungsberechtigung & Status** | |
| Auszahlungsstopp | Gibt an, ob die Auszahlungen des Teilnehmers derzeit gesperrt sind (Ja oder Nein). Auszahlungen können wegen fehlender Steuerformulare oder unvollständiger Einrichtung zurückgehalten werden. |
| Gründe für den Auszahlungsstopp | Erklärt, warum für den Teilnehmer ein Auszahlungsstopp besteht (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 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, den Onboarding-Fortschritt oder den Nachfassbedarf für ausstehende Auszahlungen zu verfolgen. |
---
# 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=&goal=
```
`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.