Ambassadors platziert an mehreren Stellen im Admin-Bereich einen Button CSV herunterladen. Diese Seite erklärt, wo sich jeder Button befindet, wofür er nützlich ist, und bietet eine vollständige Spaltendefinition für jeden Export, damit Sie genau wissen, womit Sie arbeiten.

Ob Sie Daten für einen Bericht an den Vorstand abrufen, Botschafterdatensätze in ein CRM importieren oder einfach nur eine Aufzeichnung Ihrer Moderationsentscheidungen führen möchten, dies ist Ihre Referenz.

Erfordert: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

So exportieren Sie Ihre Daten

Jeder CSV-Export in Ambassadors funktioniert auf die gleiche Weise: Suchen Sie den gewünschten Abschnitt, klicken Sie auf den Button CSV herunterladen, und die Datei wird sofort heruntergeladen. Es gibt keine separate Exportseite oder Warteschlange, auf die man warten müsste. Hier erfahren Sie, wo sich jeder Button befindet und wofür Sie ihn verwenden würden.

Exporte im Übersichts-Dashboard

Gehen Sie zu Charitable » Ambassadors » Übersicht. Mehrere Abschnitte auf diesem Bildschirm haben ihren eigenen CSV herunterladen-Button, und jeder exportiert Daten für den aktuell ausgewählten Zeitraum. Passen Sie zuerst den Zeitraum an, klicken Sie dann auf Export, und die Datei spiegelt genau das wider, was Sie auf dem Bildschirm sehen.

• KPI-Zusammenfassung: Die sechs wichtigsten Zahlen (Einnahmen, Spenden, Spender usw.) plus Trendprozentsätze im Vergleich zum Vorzeitraum. Nützlich für Vorstandberichte oder monatliche Momentaufnahmen.
• Spenden im Zeitverlauf: Dieselben Daten wie im Hauptdiagramm, aufgeteilt in Zeitintervalle. Gut für die Darstellung von Trends in einer Tabellenkalkulation.
• Top-Fundraiser: Eine Rangliste Ihrer leistungsstärksten Fundraiser mit Zielerreichung und Spenderanzahl.
• Top-Botschafter: Pro Person aufgeschlüsselte Gesamteinnahmen und Fundraiser-Anzahl. Nützlich zur Anerkennung der Top-Performer.
• Top-Eltern: Welche Elternkampagnen treiben die meiste Aktivität an. Nützlich für die Entscheidung, worauf man sich konzentrieren soll.
• Rekrutierungs-Log / Top-Rekrutierer: Nur verfügbar, wenn Einladungen aktiviert sind. Zeigt, wer wen rekrutiert hat und wie Ihre Top-Einladenden abschneiden.

Moderations-Export

Gehen Sie zu Charitable » Ambassadors » Moderation und wählen Sie die Ansicht aus, die Sie exportieren möchten (Ausstehend, Aktion erforderlich, Abgelehnt oder Genehmigt). Der Button CSV herunterladen exportiert die aktuell aktive Ansicht. Dies ist nützlich für Audits, Übergaben zwischen Moderatoren oder die Führung von Aufzeichnungen über abgelehnte Anträge.

Verzeichnis-Exporte

Gehen Sie zu Charitable » Ambassadors » Verzeichnis. Der Export auf Listen-Ebene lädt jeden Botschafter in Ihrer aktuell gefilterten Ansicht herunter, einschließlich seiner lebenslangen Statistiken, seines Verifizierungsstatus und wer ihn rekrutiert hat. Sie können auch das Profil eines einzelnen Botschafters öffnen und nur seine Spendenhistorie über den Reiter Spenden auf dieser Profilseite exportieren.

Einladungs-Exporte

Gehen Sie zu Charitable » Ambassadors » Einladungen. Hier finden Sie zwei Exporte: ein chronologisches Aktivitätsprotokoll jedes einladungsbezogenen Ereignisses und eine Rangliste Ihrer Top-Rekrutierer. Beide spiegeln den aktuell ausgewählten Zeitraum wider.

Pro-Botschafter-Spendenexport

Dieser ist für Ihre Botschafter selbst, nicht für Administratoren. Wenn Sie die Einstellung Export der Spendenhistorie zulassen aktivieren, sehen die einzelnen Botschafter eine Exportoption für Spenden auf ihrer Seite Meine Kampagnen. Sie können nur die Spendenhistorie für ihre eigenen Spendenaktionen herunterladen. Spender-E-Mail-Adressen sind standardmäßig ausgeschlossen, es sei denn, Sie aktivieren diese Option ausdrücklich.

---

Was jeder Export gemeinsam hat

Bevor Sie sich mit den Spaltendetails befassen, gilt für jeden CSV-Export, den Ambassadors erstellt, Folgendes:

Garantie	Notizen
Formelinjektionssicher	Jede Zelle, die mit =, +, -, @, Tabulator oder Wagenrücklauf beginnt, wird mit einem einfachen Anführungszeichen versehen, damit Excel sie nicht als Formel interpretiert. Standardmäßige OWASP-Abwehr.
Zeilenlimit von 10.000	Standard pro Export. Filterbar über charitable_ambassadors_<surface>_csv_max_rows. Größere Exporte sollten nach Datumsbereichen aufgeteilt werden.
UTF-8-kodiert	Enthält das BOM, damit Excel auf Windows Akzente korrekt darstellt.
Erste Zeile ist die Kopfzeile	Spaltennamen in einfachem Englisch.
Keine PII, es sei denn, Sie stimmen zu	Anonyme Spendernamen erscheinen standardmäßig als „Anonym“. Die Einstellung „Export von anonymen Spenderdetails“ im Verzeichnis ändert dies, und Exporte, die als „owner“-Oberflächen gekennzeichnet sind, zeigen vollständige Namen an.

Übersichts-Exporte

Das Übersicht-Dashboard verfügt über Schaltflächen zum Herunterladen von CSVs in mehreren Abschnitten. Jede exportiert Daten für den aktuell oben auf dem Bildschirm ausgewählten Zeitraum.

KPI-Zusammenfassung CSV

Dieser Export liefert Ihnen die sechs wichtigsten Zahlen von der Spitze des Dashboards sowie die Entwicklung jeder Metrik im Vergleich zum vorherigen Zeitraum gleicher Länge. Gut zum Einfügen in einen Monatsbericht oder eine Vorstandspräsentation.

Spalte	Typ	Notizen
Metrik	Zeichenkette	„Einnahmen“, „Spenden“, „Spender“ usw.
Wert	Gleitkommazahl	Numerischer Wert für den aktuellen Zeitraum.
Vorheriger Wert	Gleitkommazahl	Wert für den vorherigen Zeitraum gleicher Länge.
Trend %	Gleitkommazahl	Prozentuale Veränderung. Leer, wenn einer der Werte Null ist.
Trendrichtung	Zeichenkette	„auf“, „ab“, „flach“ oder leer.

Spenden im Zeitverlauf CSV

Dieser Export enthält die gleichen gruppierten Daten wie das Hauptdiagramm auf dem Übersichts-Bildschirm. Jede Zeile ist ein Datumsintervall, sodass Sie problemlos Ihre eigenen Diagramme oder Trendanalysen in einer Tabellenkalkulation erstellen können.

Spalte	Typ	Notizen
Intervallstart	Datum	Erster Tag des Intervalls (JJJJ-MM-TT).
Intervallende	Datum	Letzter Tag des Intervalls.
Übergeordnete Kampagnen	Gleitkommazahl	Dollar-Gesamtbetrag für übergeordnete Kampagnen in diesem Intervall.
Spendenaktionen	Gleitkommazahl	Dollar-Gesamtbetrag für Spendenaktionen in diesem Intervall.
Gesamt	Gleitkommazahl	Summe der beiden.

Top-Spendenaktionen CSV

Eine Rangliste Ihrer leistungsstärksten Spendenaktionen für den ausgewählten Zeitraum mit vollständigem Ziel-Fortschritt und Spenderzahlen. Nützlich zur Anerkennung von Top-Performern oder zum Teilen von Ergebnissen mit Kampagnenorganisatoren.

Spalte	Typ	Notizen
Rang	Ganzzahl	1-basierte Position in der Top-Liste.
Titel der Spendenaktion	Zeichenkette	Der Kampagnentitel.
Name des Botschafters	Zeichenkette	Der Autor.
Titel der übergeordneten Kampagne	Zeichenkette	Die übergeordnete Kampagne, zu der dies gehört.
Eingenommen	Gleitkommazahl	Im aktiven Zeitraum.
Ziel	Gleitkommazahl	Statisches Ziel.
Prozent des Ziels	Gleitkommazahl	Einnahmen / Ziel.
Spenderanzahl	Ganzzahl	Eindeutige Spender im Bereich.

Top-Botschafter CSV

Eine pro Person aufgeschlüsselte Übersicht, die zeigt, wie viel jeder Botschafter über alle seine Spendenaktionen im ausgewählten Zeitraum gesammelt hat. Gut für E-Mails zur Anerkennung auf Ranglisten oder für den Import in CRM-Systeme.

Spalte	Typ	Notizen
Rang	Ganzzahl	1-basiert.
Name des Botschafters	Zeichenkette	Anzeigename.
E-Mail	Zeichenkette	E-Mail-Adresse.
Anzahl der Spendenaktionen	Ganzzahl	Anzahl der Spendenaktionen im Bereich.
Eingenommen	Gleitkommazahl	Gesamtbetrag über alle ihre Spendenaktionen im Bereich.
Spenderanzahl	Ganzzahl	Eindeutige Spender im Bereich.

Top-Eltern-Kampagnen CSV

Die Daten hinter dem Tortendiagramm auf dem Übersichts-Bildschirm, die zeigen, welche Elternkampagnen die meisten Spendenaktivitäten antreiben. Nützlich für die Entscheidung, wo Rekrutierungs- oder Werbemaßnahmen konzentriert werden sollen.

Spalte	Typ	Notizen
Rang	Ganzzahl	1-basiert.
Titel der übergeordneten Kampagne	Zeichenkette	Titel der Elternkampagne.
Eingenommen	Gleitkommazahl	Im Bereich.
Spenderanzahl	Ganzzahl	Eindeutige Spender im Bereich.
Anteil am Gesamtbetrag	Gleitkommazahl	Die von dieser Elternkampagne gesammelten Beträge geteilt durch den Gesamtbetrag der Website.

Rekrutierungs-Protokoll CSV

Nur verfügbar, wenn Einladungen aktiviert sind. Dieser Export gibt Ihnen einen chronologischen Datensatz jedes Rekruten, wer ihn angeworben hat und was sein aktueller Status ist.

Spalte	Typ	Notizen
Name des Rekruten	Zeichenkette	Der angeworbene Botschafter.
E-Mail des Rekruten	Zeichenkette	E-Mail.
Name des Einladenden	Zeichenkette	Der Werber.
E-Mail des Einladenden	Zeichenkette	E-Mail.
Status	Zeichenkette	„Genehmigt“, „Ausstehend“, „Abgelehnt“.
Rekrutiert am	Datum Uhrzeit	Wenn die Zuordnung abgestempelt wird (JJJJ-MM-TT HH:MM:SS).
Token	Zeichenkette	Der Token, über den sie hereingekommen sind.

Rekrutierung Top-Rekrutierer CSV

Eine Rangliste Ihrer aktivsten Einlader, die die Gesamtzahl der Rekruten zusammen mit den genehmigten Rekruten anzeigt, damit Sie Aktivität von Ergebnissen trennen können.

Spalte	Typ	Notizen
Rang	Ganzzahl	1-basiert.
Name des Einladenden	Zeichenkette	Der Werber.
E-Mail des Einladenden	Zeichenkette	E-Mail.
Gesamte Rekruten	Ganzzahl	Alle Status.
Genehmigte Rekruten	Ganzzahl	Status = Nur genehmigt.

Moderations-Export

Verfügbar im Tab Moderation. Der Export spiegelt immer die Ansicht wider, die Sie gerade haben. Wechseln Sie also zu der Ansicht, die Sie benötigen (Ausstehend, Handlungsbedarf, Abgelehnt oder Genehmigt), bevor Sie auf CSV herunterladen klicken.

Export der Moderationswarteschlange

Spalte	Typ	Notizen
Spendenaktion-ID	Ganzzahl	ID des Kampagnenbeitrags.
Titel	Zeichenkette	Titel der Spendenaktion.
Name des Botschafters	Zeichenkette	Anzeigename des Autors.
E-Mail des Botschafters	Zeichenkette	E-Mail des Autors.
Titel der übergeordneten Kampagne	Zeichenkette	Übergeordnete Kampagne.
Status	Zeichenkette	Ausstehend / Handlungsbedarf / Abgelehnt / Genehmigt.
Eingereicht	Datum Uhrzeit	Erste Einreichung.
Letzte Aktion	Datum Uhrzeit	Zeitstempel des letzten Audit-Log-Eintrags.
Grund / Notizen	Zeichenkette	Letzter Ablehnungsgrund oder Notizen zur Änderungsanforderung.

Verzeichnis-Exporte

Das Verzeichnis bietet zwei Exportebenen: einen Export auf Listen-Ebene für Ihre gesamte Botschafterliste und einen Export auf Profil-Ebene für die Spendenhistorie eines einzelnen Botschafters.

Verzeichnisliste CSV

Dies exportiert jeden Botschafter in der Ansicht, die Sie gerade betrachten, einschließlich aller angewendeten Filter. Wenn Sie nur nach verifizierten Botschaftern gefiltert haben, wird genau das exportiert. Alle in der Listentabelle sichtbaren Spalten sind enthalten, plus einige zusätzliche.

Spalte	Typ	Notizen
Benutzer-ID	Ganzzahl	WP-Benutzer-ID.
Anzeigename	Zeichenkette
E-Mail	Zeichenkette
Rollen	Zeichenkette	Kommagetrennte WP-Rollen.
Verifiziert	bool	„1“ oder „0“.
Gesamtzahl der Spendenaktionen	Ganzzahl	Anzahl aller Status.
Veröffentlichte Spendenaktionen	Ganzzahl
Ausstehende Spendenaktionen	Ganzzahl
Abgelehnte Spendenaktionen	Ganzzahl
Gesamtbetrag im Lebenszeitraum	Gleitkommazahl	Über alle ihre Spendenaktionen hinweg.
Im laufenden Jahr gesammelt	Gleitkommazahl	Aktuelles Jahr.
Spenderanzahl	Ganzzahl	Eindeutige Spender.
Anzahl der Spenden	Ganzzahl	Eingegangene Spenden.
Letzte Aktivität	Datum Uhrzeit
Beigetreten	Datum Uhrzeit	WP user_registered.
Geworben von	Zeichenkette	Anzeigename des Einladenden oder „“ bei Selbstregistrierung.

CSV-Datei für Spenden aus dem Verzeichnisprofil

Verfügbar über den Reiter „Spenden“ auf der Profilseite eines einzelnen Botschafters. Diese Liste enthält jede Spende, die die Spendenaktionen dieses Botschafters erhalten haben, was nützlich ist, um einem Botschafter ein vollständiges Bild seiner Wirkung zu vermitteln oder für die Einhaltung von Aufzeichnungspflichten.

Spalte	Typ	Notizen
Datum	Datum Uhrzeit
Name des Spenders	Zeichenkette	„Anonym“ es sei denn, die Überschreibungseinstellung ist aktiviert.
E-Mail-Adresse des Spenders	Zeichenkette	„“ bei Anonymität.
Betrag	Gleitkommazahl
Währung	Zeichenkette	ISO-Code.
Titel der Spendenaktion	Zeichenkette	Welche Spendenaktion hat die Spende erhalten.
Status	Zeichenkette	Abgeschlossen / Rückerstattet / Fehlgeschlagen.

Einladungen Exporte

Verfügbar über den Tab „Einladungen“, wenn „Einladungen“ aktiviert ist.

CSV mit aktuellen Aktivitäten

Ein chronologisches Protokoll aller einladungsbezogenen Ereignisse im aktiven Zeitraum, einschließlich Klicks, die nicht zu einer Anmeldung führten. Nützlich, um zu verstehen, wo Ihre Einladungslinks Anklang finden und wo sie kalt werden.

Spalte	Typ	Notizen
Zeitstempel	Datum Uhrzeit
Ereignis	Zeichenkette	„Geklickt“, „Beansprucht“, „Selbst-Rekrutierung übersprungen“ usw.
Name des Einladenden	Zeichenkette
E-Mail des Einladenden	Zeichenkette
Name des Rekruten	Zeichenkette	„“ für Klickereignisse ohne Beanspruchung.
E-Mail des Rekruten	Zeichenkette	„“.
Token	Zeichenkette
Übergeordnete Kampagne	Zeichenkette	Kampagne, auf die sich bezogen wird (falls vorhanden).

CSV der Top-Rekrutierer

Dieser Export hat die gleichen Spalten wie die CSV der Top-Rekrutierer in der Übersicht. Er wird hier im Tab „Einladungen“ angezeigt, damit Sie Rekrutiererdaten abrufen können, ohne zum Bildschirm „Übersicht“ zurückkehren zu müssen. Wenn Sie bereits unter „Einladungen“ arbeiten, erspart Ihnen dies den Weg.

Spendenbericht pro Botschafter

Botschafter können ihre eigene Spendenhistorie von der Seite Meine Kampagnen über die Aktion „Spenden“ auf jeder Spendenaktionskarte exportieren. Dies wird durch die Einstellung Export der Spendenhistorie zulassen gesteuert, sodass Sie die Kontrolle darüber behalten, ob diese verfügbar ist.

Die Spalten entsprechen der CSV der Verzeichnisprofil-Spenden mit drei Unterschieden:

• „E-Mail-Adresse des Spenders“ wird standardmäßig weggelassen. Aktivieren Sie Persönliche Details für anonyme Spender einschließen unter den Einstellungen für „Meine Kampagnen“, um sie einzuschließen.
• „Währung“ wird weggelassen, da dies immer ein Export in einer einzigen Währung ist.
• „Spendenaktions-Titel“ wird weggelassen, da der Export bereits auf eine einzelne Spendenaktion beschränkt ist.

Dateinamensmuster

Jede CSV für Botschafter folgt der gleichen Namenskonvention, was es einfach macht, die richtige Datei später zu finden:

ambassadors-<section>-<start-date>-to-<end-date>.csv

Zum Beispiel:

ambassadors-kpi-summary-2026-01-01-to-2026-12-31.csv
ambassadors-top-fundraisers-2026-05-01-to-2026-05-31.csv
ambassadors-directory-2026-05-30.csv

Die Daten im Dateinamen sind das Exportfenster, sodass Sie den Dateinamen selbst als Archivschlüssel verwenden können, ohne die Datei öffnen zu müssen.

Zeilenobergrenze

Die Standardobergrenze liegt bei 10.000 Zeilen pro Export. Wenn Sie dieses Limit regelmäßig erreichen, haben Sie zwei Möglichkeiten: Verkleinern Sie Ihren Datumsbereich, um den Export in kleinere Teile aufzuteilen, oder erhöhen Sie die Obergrenze mithilfe des Filters für diese Oberfläche:

add_filter( 'charitable_ambassadors_overview_csv_max_rows', function () {
    return 50000;
} );

add_filter( 'charitable_ambassadors_directory_csv_max_rows', function () {
    return 50000;
} );

add_filter( 'charitable_ambassadors_invitations_csv_max_rows', function () {
    return 50000;
} );

Ein paar Dinge, die Sie wissen sollten, bevor Sie diese CSV-Datei öffnen

Die meisten davon treten nur einmal auf, aber es sind die Dinge, die Ihnen 20 Minuten Frustration ersparen, wenn sie doch auftreten.

• Verwenden Sie Google Tabellen, wenn Excel Probleme macht. Sheets verarbeitet die UTF-8-BOM korrekt unter Mac und Linux. Excel unter Windows kann Akzentzeichen verfälschen, auch wenn die BOM vorhanden ist. Wenn also Namen oder Adressen fehlerhaft aussehen, versuchen Sie es zuerst mit Sheets.
• Speichern Sie die Datei, bevor Sie sie in Excel öffnen. Einige Excel-Versionen unter Windows konvertieren Spalten automatisch, sobald Sie sie öffnen, was numerische IDs in Daten umwandeln oder führende Nullen entfernen kann. Das Speichern der Rohdatei zuerst gibt Ihnen eine Rückfallebene.
• Aktivieren Sie anonyme Spenderdetails nur, wenn Sie sie tatsächlich benötigen. Die meisten Programme müssen keine anonymisierten PII in ihren Exporten preisgeben, und wenn diese Einstellung deaktiviert bleibt, bedeutet dies weniger Daten, die verwaltet und gesichert werden müssen.
• Verwenden Sie den Dateinamen als Archivschlüssel. Der Datumsbereich ist in jedem Dateinamen enthalten, sodass Sie immer wissen, welches Fenster eine bestimmte Datei abdeckt, ohne sie öffnen zu müssen.

---

Entwicklerreferenz

CSV-Handler-Klassen

Klasse	Behandelt
Charitable_Ambassadors_Overview_CSV	Übersichts-Dashboard-Exporte.
Charitable_Ambassadors_Directory_CSV	Verzeichnisliste + Profil-Exporte.
Charitable_Ambassadors_Invitations_CSV	Exporte aus dem Einladungs-Tab.

Jeder Handler wird über admin-post.php?action=charitable_ambassadors_<surface>_csv mit einem section-Query-Argument und Nonce aufgerufen.

Formel-Injektions-Neutralisierung

Jeder Zellwert durchläuft:

$value = Charitable_Ambassadors_Overview_CSV::neutralize_csv_cell( $value );

Dies stellt ein einzelnes Anführungszeichen vor jeden String, der mit =, +, -, @, einem Tabulator oder einem Wagenrücklauf beginnt, und folgt damit OWASP's empfohlener Abwehr gegen CSV-Injektion und Excel-Formelinjektion.

Filter

Filter	Standard	Zweck
charitable_ambassadors_overview_csv_max_rows	10000	Obergrenze für Übersichts-Exporte.
charitable_ambassadors_directory_csv_max_rows	10000	Obergrenze für Verzeichnis-Exporte.
charitable_ambassadors_invitations_csv_max_rows	10000	Obergrenze für Einladungs-Exporte.
charitable_ambassadors_directory_csv_cell	''	Überschreibt den Wert für eine benutzerdefinierte Spalte. Empfängt ('', $col, $user).
charitable_ambassadors_overview_csv_header_<section>	berechnet	Ändern Sie die Kopfzeile für einen bestimmten Abschnitt.
charitable_ambassadors_overview_csv_row_<section>	berechnet	Ändern Sie die Datenzeilen für einen bestimmten Abschnitt.

Funktionen

Alle Exporte auf der Admin-Seite erfordern manage_charitable_settings. Der Spendenbericht pro Botschafter auf „Meine Kampagnen“ erfordert, dass der Benutzer der post_author der exportierten Kampagne ist.

Das könnten Sie auch interessieren

Dies sind die Botschafter-Dokumente, die diesem am nächsten kommen. Lesezeichen für diejenigen, die zu Ihrer Datennutzung passen, und kehren Sie zu ihnen zurück, wenn Sie eine Auffrischung benötigen.

• Übersicht Dashboard – wo die meisten dieser Exporte leben und wo Ihre Datumsauswahl stattfindet.
• Verzeichnis – die vollständige Botschafterliste mit eigenen Exporten auf Listen- und Profil-Ebene.
• Moderation – die Warteschlange, in der Sie Spendenaktionen überprüfen und genehmigen, mit eigenen Exporten pro Ansicht.
• Einladungen – das Rekrutierungssystem hinter den Exporten „Rekrutierungsprotokoll“ und „Top-Rekrutierer“.
• Hooks & Filter in Botschaftern – die Entwicklerreferenz zur Anpassung des Exportverhaltens.