> 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).
# Berichte zum Advocate-Programm erklärt
Nehmen Sie am PXA-Kurs teil
Advocate bietet verschiedene herunterladbare Berichte für Ihr Programm und Ihre 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 Aufzeichnungen mit den Advocate-Share-Links 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 über den Teilnehmer wie Traffic, Umsatz und mehr.
* **Empfehlungs-Share-Links und -Codes**, falls zutreffend. Diese Informationen können hilfreich sein, wenn Sie Kontaktdatensätze in Ihrem CMS oder E-Mail-System aktualisieren, um die Advocate-Share-Links und -Codes jedes Teilnehmers aufzunehmen.
Eine vollständige Liste der Felder finden Sie beim [Herunterladen unserer CSV-Beispieldatei](https://assets.ctfassets.net/s68ib1kj8k5n/7Am85AH6wmNdArmjRNW3vr/95f52c5d79311509d795a0be4c94166f/User_Details_Report_Sample.csv)  Bericht mit Benutzerdetails.
**Referenz der Berichtsspalten**
| 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 des Teilnehmers, nützlich für datenschutzkonformes Abgleichen mit anderen Systemen. |
| **Empfehlungs- und Share-Informationen** | |
| Empfehlungscode | Der eindeutige dem Teilnehmer zugeordnete Code, der zur Nachverfolgung der von ihm erzeugten Empfehlungen verwendet wird. |
| Share-Link | Der eindeutige Empfehlungslink, der dem Teilnehmer zugeordnet ist. |
| Facebook-Share-Link | Ein vorab generierter Link zum Teilen der Empfehlung auf Facebook. |
| Twitter-Share-Link | Ein vorab generierter Link zum Teilen der Empfehlung auf Twitter. |
| E-Mail-Share-Link | Ein vorab generierter Link zum Teilen der Empfehlung per E-Mail. |
| LinkedIn-Share-Link | Ein vorab generierter Link zum Teilen der Empfehlung auf LinkedIn. |
| Bereinigter Share-Link | Eine Version des Empfehlungslinks ohne Tracking-Parameter; für bestimmte Plattformen oder Anwendungsfälle neutraler. |
| **Geolokalisierung und Gebietsschema** | |
| Erste gesehene IP | Die IP-Adresse, von der aus der Teilnehmer erstmals erfasst wurde. |
| Zuletzt gesehene IP | Die zuletzt für diesen Teilnehmer erfasste IP-Adresse. |
| Gebietsschema | Die bevorzugte Sprache und 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 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 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 erfolgreichen Empfehlungen des Teilnehmers. |
| stats.conversions | Gesamtzahl der Konversionen (z. B. Käufe, Anmeldungen), die aus diesen Empfehlungen resultierten. |
| stats.goals | Anzahl bestimmter Zielabschlüsse, die mit der Empfehlungsaktivität des Teilnehmers verbunden sind (im Programm benutzerdefiniert definiert). |
| stats.rewards | Gesamtzahl der Prämien, die der Teilnehmer erhalten hat. |
| stats.widget Loads | Anzahl der Male, die das Empfehlungs-Widget oder die Freigabeoberfläche von diesem Teilnehmer geladen wurde. |
| stats.revenue | Gesamtumsatz, der durch Nutzer generiert wurde, die von diesem Teilnehmer empfohlen wurden. |
| stats.generated Revenue | Synonym für stats.revenue; einige Berichte unterscheiden möglicherweise, wenn der Umsatz aus mehreren Quellen stammt. |
| stats.referred Revenue | Umsatz, der speziell den Teilnehmern zugeschrieben 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. *Treue-ID*, *interne Notizen*, *Region-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*, *Partnerseite*). |
#### Export der Benutzerereignisse
Die *Bericht zum Export von Benutzerereignissen* Der Bericht enthält 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
**Referenz der Berichtsspalten**
| 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 Auditing von Ereignisübermittlungen. |
| Ereignisschlüssel | Die Art oder Bezeichnung des Ereignisses, z. B. `Kauf`, `Registrierung`, oder jeden benutzerdefiniert definierten Schlüssel, den Ihr System sendet. |
| Nutzer-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 verschiedenen Kontostrukturen angehören können. |
| **Ereignis-Zeitstempel** | |
| Auslösedatum des Ereignisses – 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. |
| Empfangsdatum des Ereignisses – JJJJ-MM-TT | Das Datum, an dem Advocate das Ereignis von Ihrem System erhalten hat. Kann sich aufgrund von Bündelung oder Systemverzögerungen vom Auslösedatum unterscheiden. |
| Verarbeitungsdatum des Ereignisses – JJJJ-MM-TT | Das Datum, an dem das Ereignis erfolgreich verarbeitet und in Advocate gespeichert wurde. Markiert den Zeitpunkt, zu dem das Ereignis für Nachverfolgung, Prämien oder Berichte nutzbar wurde. |
| **Ereignis-Datenfelder (falls in Ihren Ereignis-Payloads enthalten)** | |
| fields.coupon | Jeder Coupon- oder Rabattcode, der während des Ereignisses angewendet wurde, falls in den Ereignisdaten gesendet. Nützlich zur Nachverfolgung der Nutzung von Anreizen oder bestimmter Kampagnenauslöser. |
| fields.revenue | Der mit dem Ereignis verbundene Umsatzbetrag. Wird typischerweise bei Kaufereignissen verwendet, um Leistung, Prämien oder ROI zu berechnen. |
| fields.currency | Der Währungscode (z. B. *USD*, *ZAR*, *EUR*) der dem Umsatzbetrag zugeordnet ist. Wichtig bei Berichten über Regionen hinweg oder bei der Berechnung wechselkursbereinigter Prämien. |
| fields.lead Created Date | Das ursprüngliche Datum, an dem der Lead (Benutzer) in Ihrem System erstellt wurde, falls als Teil des Ereignisses übermittelt. Hilft, Benutzerereignisse mit ursprünglichen Erfassungsdaten oder CRM-Datensätzen zu verknüpfen. |
#### Prämienhistorie
Die *Prämienhistorie* Der Bericht liefert 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 all Ihrer Prämien zu einem bestimmten Zeitpunkt abzurufen.
Berichtsdetails
Standardmäßig enthält der Bericht **Prämienfelder** Informationen wie:
* Prämien-ID
* Prämientyp
* Belohnungswert
Eine vollständige Liste der enthaltenen Felder finden Sie beim [Herunterladen unserer CSV-Beispieldatei](https://assets.ctfassets.net/s68ib1kj8k5n/7E5DNWKrh7iQMNGYQBWRiS/3ae6c7a9109542215763a07a18cb0494/Reward_Details_Example_Report_CSV.csv), [Excel-Beispieldatei](https://assets.ctfassets.net/s68ib1kj8k5n/2MQjc4XjXGPNhsv10tHal6/dc40679812b99d0aef4ace46a780e1ee/Reward_Details_Example_Report_XLSX.xlsx)  oder [JSONL-Beispieldatei](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl)  Berichten mit Prämiendetails.
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 für Kunden-Advocates, Felder für empfohlene Freunde und mehr.
**Referenz der Berichtsspalten**
| Spalte | Beschreibung |
| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Prämieninformationen** | |
| ID | Eindeutige ID der Prämieninstanz (von Advocate generiert). |
| Typ | Die Prämienkategorie oder -art (z. B. *Bargeld*, *Geschenkkarte*, *Gutschein*, *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. *Verweis*, *Ziel*, *Manuell*, *API*). |
| FuelTank-Typ | Der Art des verwendeten Prämienfonds (bei Verwendung der FuelTank-Integration). Z. B. *Prepaid*, *Geschenkkarte*. |
| FuelTank-Code | Der mit der externen Einlösung verknüpfte Code (z. B. Gutschein- oder Geschenkkartencode). |
| Programm-ID | ID des Advocate-Programms, unter dem die Prämie ausgegeben wurde. |
| Programm-Prämienschlüssel | Interne Kennung für die im Programm verwendete spezifische Prämienkonfiguration. |
| Globaler Prämienschlüssel | Programmübergreifende Kennung für auf globaler Ebene konfigurierte Prämien (falls zutreffend). |
| **Prämien-Zeitstempel** | |
| Erstellungsdatum | Wann der Prämiendatensatz im System erstellt wurde. |
| Geplantes Datum | Wann die Prämie zur Ausgabe geplant wurde (z. B. nach einer Verzögerung oder Wartezeit). |
| Datum der Vergabe | 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 der Prämiendatensatz zuletzt aktualisiert wurde. |
| **Guthaben- und Wertnachverfolgung** | |
| Zugewiesenes Guthaben | Der dieser Prämie 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 und Nachrichten** | |
| Status | Aktueller Status der Prämie (z. B. *Ausstehend*, *Geplant*, *Ausgegeben*, *Abgelaufen*, *Abgebrochen*). |
| meta.status | Technischer oder systemweiter Status (nützlich für Diagnose oder Fehlerbehandlung). |
| meta.message | Nachricht im Zusammenhang mit der Prämienzustellung (z. B. „Prämie erfolgreich zugestellt“). |
| meta.internal Message | Nur interne Hinweise für Administratoren (z. B. Erläuterungen zu Fehlern oder Markierungen). |
| meta.date Modified | Zeitpunkt der letzten Aktualisierung der mit der Prämie verbundenen Metadaten. |
| 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 Prämie erhält. |
| user.account Id | Die zugehörige Konto-ID des Benutzers in Advocate. |
| user.first Name
user.last Name
user.email
| Grundlegende Teilnehmerinformationen, die als Referenz oder zum Abgleich mit dem CRM enthalten sind. |
| **Empfehlungskontext (wenn die Prämie auf einer Empfehlung basiert)** | |
| referral.id | Die ID der Empfehlung, die diese Prämie ausgelöst hat. |
| referral.date Referral Started | Wann die Empfehlungsaktion begann (z. B. Klick- oder Share-Ereignis). |
| 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 Freund** | |
| referral.referred User.id | ID der Person, die empfohlen wurde („Freund“). |
| referral.referred User.account Id | Die eindeutige Konto-ID des Empfehlenden. |
| referral.referred User.first Name
referral.referred User.last Name
referral.referred User.email
| Die grundlegenden Kontaktdaten des Empfehlenden. |
| **Informationen zum Empfehlenden (Advocate)** | |
| referral.referrer User.id | ID der Person, die die Empfehlung ausgesprochen hat („Advocate“). |
| referral.referrer User.account Id | Die eindeutige Konto-ID des Empfehlenden. |
| referral.referrer User.first Name
referral.referrer User.last Name
referral.referrer User.email
| Die grundlegenden Kontaktdaten des Empfehlenden. |
| referral.date Converted | Das Datum, an dem die Empfehlung offiziell konvertiert wurde (z. B. abgeschlossene Anmeldung oder Kauf), wodurch die Prämie ausgelöst wurde. |
#### Empfehlungshistorie
Die *Empfehlungshistorie* Der Bericht enthält eine Aufzeichnung des Status jeder Empfehlungsverknüpfung, die in Ihrem Empfehlungsprogramm erstellt wurde. Diese Informationen können nützlich sein, um den Erfolg Ihres Programms zu überprüfen und die Anzahl der neuen Kunden nachzuverfolgen, die Ihr Programm gewonnen 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 empfehlenden Kunden 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 CSV-Beispieldatei](https://assets.ctfassets.net/s68ib1kj8k5n/7B4pBHawfu9GtzE5mL1yo2/4fd194ee3080c5190639abab70b35e47/Referral_Activity_Report.csv)  Bericht zur Empfehlungsaktivität.
**Referenz der Berichtsspalten**
| Spalte | Beschreibung |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Empfehlungsmetadaten** | |
| ID | Eindeutige Kennung des Empfehlungsdatensatzes in Advocate. |
| Änderungsdatum | Das aktuellste Datum, an dem ein Teil des Empfehlungsdatensatzes aktualisiert wurde. |
| Datum des Empfehlungsstarts | Wann die Empfehlung erstmals initiiert wurde (z. B. als der empfohlene Benutzer auf einen Empfehlungslink geklickt hat). |
| Konvertierungsdatum | Wann die Empfehlung konvertiert wurde, typischerweise wenn der empfohlene Benutzer die erforderliche Aktion abgeschlossen hat (wie eine Anmeldung oder einen Kauf). |
| Datum der Benutzeränderung | Der Zeitpunkt der letzten Aktualisierung der an dieser Empfehlung beteiligten Benutzerdaten (Empfehlender oder Empfohlener). |
| 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 auch andere empfehlen kann). |
| Erste 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 Multi-Account-Programmen verwendet). |
| **Informationen zum Empfehlenden (Customer Advocate)** | |
| E-Mail des Empfehlenden
Vorname des Empfehlenden
Nachname des Empfehlenden
| Grundlegende Identitätsinformationen des empfehlenden Teilnehmers. |
| Empfehlungscode des Empfehlenden | Der dem Empfehlenden zugehörige Empfehlungscode, also der Code, den der empfohlene Benutzer wahrscheinlich verwendet hat. |
| Erste gesehene IP des Empfehlenden
Zuletzt gesehene IP des Empfehlenden
| IP-Adressen, die bei der ersten und jüngsten Aktivität des Empfehlenden erfasst wurden. |
| Bild-URL des Empfehlenden | Die URL des Bildes oder Avatars des Empfehlenden. |
| Gebietsschema des Empfehlenden | Gebietsschema-Einstellung des Empfehlenden. |
| Erstellungsdatum des Empfehlenden | Wann der Empfehlende dem System erstmals beigetreten oder dort erfasst wurde. |
| Empfehlender Benutzer | Interne ID des Werbenden in Advocate. |
| Werbender-Account | Mit dem Werbenden verknüpfte Konto-ID. |
| **Moderation & Status** | |
| Moderationsstatus | Gesamt-Moderationsstatus der Empfehlung. (Z. B., *Genehmigt*, *Abgelehnt*, *Ausstehend*.) |
| Datum der Moderation | Das Datum, an dem die Moderationsentscheidung (Genehmigung/Ablehnung) getroffen wurde. |
| Datum der ausgezahlten Empfehlung | Wann eine zugehörige Prämie 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 Geworbenen | Moderationsstatus speziell für den Teil der Empfehlung des geworbenen Nutzers. |
| Moderationsstatus des Werbenden | Moderationsstatus speziell für den Teil der Empfehlung des Werbenden. |
| **Prämien-Referenzen** | |
| Prämie für den Geworbenen | Die Prämien-ID oder Referenz, die dem geworbenen Nutzer zugewiesen wurde (falls zutreffend). |
| Prämie für den Werbenden | Die Prämien-ID oder Referenz, die dem Werbenden zugewiesen wurde (falls zutreffend). |
#### Prämienguthaben nach Nutzer
Die *Prämienguthaben nach Nutzer* Der Bericht liefert eine Aufstellung ausstehender Prämien, einschließlich des Werts und des vorgesehenen Empfängers, die über Ihr Empfehlungsprogramm generiert wurden. Dieser Bericht wird häufig verwendet, um Prämien manuell oder im Rahmen eines Stapelprozesses an ein System wie Tango Card auszuzahlen. 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 Konto-ID, E-Mail-Adresse und mehr
* Prämientyp
* Prämieneinheit
* Prämienbetrag
Eine vollständige Liste der Felder finden Sie beim [Herunterladen unserer CSV-Beispieldatei](https://assets.ctfassets.net/s68ib1kj8k5n/5iv0ByBQquLwShSyRjawck/e04b55a4e5afe24c01d5192c10682aab/Reward_Balances_by_User.csv)  Bericht über Prämienguthaben.
**Referenz der Berichtsspalten**
| Spalte | Beschreibung |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Teilnehmerinformationen** | |
| Nutzer-ID | Die eindeutige Kennung des Teilnehmers in Advocate. Wird verwendet, um das Prämienguthaben dem einzelnen Nutzer zuzuordnen. |
| 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 die Synchronisierung mit externen Systemen verwendet. |
| Vorname
Nachname
| Vor- und Nachname des Teilnehmers. Nützlich für Personalisierung oder Filterung während der Prämienbearbeitung. |
| Empfehlungscode | Der dem Teilnehmer zugewiesene Empfehlungscode. Diesen teilen sie, um andere zu werben und die Prämienberechtigung nachzuverfolgen. |
| **Prämieninformationen** | |
| Typ | Die Kategorie oder Methode der Prämie (z. B., *Bargeld*, *Geschenkkarte*, *Punkte*, *Benutzerdefiniert*). Hilft 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 | Das insgesamt verfügbare Guthaben an 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 Einlösung). Spiegelt die dem Teilnehmer zugewiesenen Gesamtkosten des Programms wider. |
| Gesamt eingelöstes Guthaben | Der gesamte Anteil der Prämien, den dieser Teilnehmer bereits eingelöst hat. Nützlich zur Prüfung tatsächlicher Kosten gegenüber Verbindlichkeiten. |
| Gesamt abgelaufenes Guthaben | Insgesamt an den Nutzer zugewiesene Prämien, die jedoch abgelaufen sind, bevor sie eingelöst wurden. Hilft, nicht beanspruchte Prämien oder verpasste Ausfüllungs-/Auszahlungsgelegenheiten nachzuverfolgen. |
| **Nutzer-Metadaten** | |
| Bild-URL | URL des Profilbilds oder Avatars des Teilnehmers (falls erfasst). Meist aus ästhetischen Gründen oder in benutzerseitigen Dashboards verwendet, sofern zutreffend. |
| Erste gesehene IP | Die erste erfasste IP-Adresse, als der Teilnehmer hinzugefügt wurde oder aktiv wurde. Nützlich für Compliance, Standortzuordnung oder Betrugsanalyse. |
| Zuletzt gesehene IP | Die zuletzt mit dem Teilnehmer verknüpfte IP-Adresse. Hilft festzustellen, ob der Nutzer noch aktiv oder eingebunden 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, Reichweite und Effektivität des Empfehlungsprogramms nach Kanal zu bewerten. |
| Gebietsschema | Die Sprach- und Regionseinstellung des Teilnehmers (z. B., *en-US*, *fr-FR*). Wichtig für personalisierte Kommunikation oder regionale Prämienoptionen. |
#### Verfügbare Prämienguthaben nach Nutzer
Die *Verfügbare Prämienguthaben nach Nutzer* Der Bericht liefert eine Liste nicht eingelöster Prämien. Dieser Berichtstyp ist dazu gedacht, als Teil der Prämienauszahlung über den [Massen-Prämieneinlösung](/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md) Prozess.
Berichtsdetails
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 CSV-Beispieldatei](https://assets.ctfassets.net/s68ib1kj8k5n/7CggBzV2U5EoJqp1HFF5SA/f3b417f460c0d960f8429b26824a225b/Available_Reward_Balances_by_User.csv)  im Bericht über verfügbare Prämienguthaben.
{% hint style="info" %}
**Hinweis**: Dieser Bericht enthält keine Details zu Prozent-Rabatt-, Fuel-Tank- oder Geschenkkarten-Prämien. Verwenden Sie den *Prämienguthaben nach Nutzer* Bericht für weitere Details zu diesen Prämientypen.
{% endhint %}
**Referenz der Berichtsspalten**
| 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. |
| Nutzer-ID | Die dem Teilnehmer in Advocate zugewiesene eindeutige Kennung. |
| Konto-ID | Die interne Konto-ID, die mit dem Teilnehmer verknüpft ist. |
| 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. |
| **Prämienstatus & Zeitpunkt** | |
| Datum der Sperrung | Das Datum, an dem der Nutzer vom Erhalt von Prämien ausgeschlossen wurde, falls zutreffend. Ein gesperrter Status kann die Einlösung verhindern; dieses Feld zeigt an, wann die Sperre angewendet wurde. |
| **Prämiendaten** | |
| Einheitenname | Die Bezeichnung oder der Anzeigename der Prämieneinheit (z. B., *Empfehlungs-Bargeld*, *Store-Guthaben*). Dies hilft, zwischen mehreren Prämientypen zu unterscheiden, die ein Programm anbieten könnte. |
| Währung | Der Währungscode des Prämienwerts (z. B., *USD*, *ZAR*, *EUR*). Wird zur Prämienauszahlung benötigt, insbesondere über Länder- oder Auszahlungsgrenzen hinweg. |
| Verfügbarer Wert | Der Betrag der derzeit verfügbaren, nicht eingelösten Prämie für diesen Teilnehmer. Dies ist der Kernwert, der bei der Festlegung der Auszahlung verwendet wird. |
| Einzulösender Wert | Der derzeit zur Einlösung vorgemerkte Wert (z. B. in einer Sammel-Auszahlung ausstehend oder noch in Bearbeitung). 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 für die Nachverfolgung von Prämienobergrenzen nützlich 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. |
#### U.S.-W-9-Steuerbericht
Der US-W-9-Steuerbericht zeigt den US-W-9-Steuerstatus der Teilnehmer sowie verdiente oder ausstehende Prämien nach Jahr.
Berichtsdetails
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
* Gesamtzahl der von jedem Teilnehmer im Steuerjahr verdienten Prämien
**Referenz der Berichtsspalten**
| Spalte | Beschreibung |
| -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Teilnehmerinformationen** | |
| Nutzer-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** | |
| Datum der Einreichung des US-Steuerformulars
JJJJ-MM-TT
| Das Datum, an dem das W-9-Formular des Teilnehmers in Advocate als eingereicht und eingegangen markiert wurde. Wichtig für die IRS-Compliance und die Überprüfung des Status der Steuerdokumentation. |
| **Zusammenfassung des Steuerjahres** | |
| Jahr | Das Steuerjahr, in dem der Teilnehmer Prämien verdient hat. Wird verwendet, um Einnahmen für die 1099-Bearbeitung nach Kalenderjahren zu gruppieren. |
| In den USA steuerpflichtiger Wert in Cent | 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 Präzision erforderlich ist. |
| In den USA steuerpflichtiger Wert in Dollar | Wie oben, jedoch im standardmäßigen Dollarformat angezeigt (z. B. 25,00). Einfacher zur Prüfung oder für die Aufnahme in offizielle Zusammenfassungen. |
| Prämienanzahl | Gesamtzahl der einzelnen Prämienereignisse, die der Teilnehmer im angegebenen Steuerjahr verdient hat. Nützlich für Prüfpfade oder zum Verständnis der Prämienhäufigkeit und Programmteilnahme. |
#### Auszahlungen und Steuern
Die *Auszahlung und Steuern* Der Bericht zeigt den Steuerstatus der Teilnehmer sowie verdiente oder ausstehende Prämien nach Jahr.
Wenn Ihr Programm Barauszahlungen an Teilnehmer vorsieht, werden bestimmte Felder zum Status des Steuerformulars des Teilnehmers verfügbar gemacht.
Berichtsdetails
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
* Gesamtzahl der von jedem Teilnehmer im Steuerjahr verdienten Prämien
* Der Status des Steuerformulars, z. B., *gültig*, *zurückgestellt*oder *ausstehenden*. Gründe für die Zurückstellung der Auszahlung sind ebenfalls im Bericht enthalten
**Referenz der Berichtsspalten**
| Spalte | Beschreibung |
| -------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Teilnehmerinformationen** | |
| Nutzer-ID | Die eindeutige Kennung des Teilnehmers in Advocate. |
| Konto-ID | Die Konto-ID des Teilnehmers, verwendet für Gruppierung 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- (oder entsprechendes US-Steuer-) Formular eingereicht hat. Wichtig zur Überprüfung der Steuerberechtigung vor der Auszahlung von Bargeld. |
| **Zusammenfassung des Auszahlungsjahres** | |
| Jahr | Das Kalenderjahr, in dem der Teilnehmer die Prämien verdient hat. |
| Wert | Gesamt-Auszahlungswert in kleineren Einheiten (z. B. Cent), der für diesen Teilnehmer im Laufe des Jahres verdient oder ausstehend ist. Zum Beispiel: 1750 = 17,50 $. |
| Wert in Dollar | Derselbe Wert, angezeigt im standardmäßigen Währungsformat zur einfachen Prüfung (z. B. 17,50). |
| Anzahl | Gesamtzahl der einzelnen Auszahlungs-Prämienereignisse für den Teilnehmer im angegebenen Jahr. Nützlich, um zu verstehen, wie oft ein Teilnehmer Auszahlungen verdient hat. |
| **Auszahlungsberechtigung & Status** | |
| Auszahlungszurückstellung | Gibt an, ob die Auszahlungen des Teilnehmers derzeit zurückgestellt sind (Ja oder Nein). Auszahlungen können aufgrund fehlender Steuerformulare oder unvollständiger Einrichtung zurückgestellt werden. |
| Gründe für die Auszahlungszurückstellung | Erklärt, warum die Auszahlung des Teilnehmers zurückgestellt 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 werden sollen (z. B., *USD*, *EUR*, *ZAR*). Wichtig für globale Auszahlungssysteme und die Buchhaltung. |
| Auszahlungs-Setup gestartet | Gibt an, ob der Teilnehmer mit der Einrichtung seiner Auszahlungsart begonnen hat (z. B. über eine Integration eines Auszahlungsanbieters). Hilft, den Onboarding-Fortschritt oder Nachverfolgungsbedarf 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.