Möchten Sie genau wissen, welche Daten in Ihrem Zap landen, wenn ein Charitable-Trigger ausgelöst wird? Jeder Trigger sendet eine strukturierte Nutzlast von Spenden-, Spender-, wiederkehrenden Abonnement- oder Kampagnenfeldern, und diese Referenz listet jedes Feld nach Trigger-Typ auf, damit Sie sie zuversichtlich in den nächsten Schritt zuordnen können.
Diese Anleitung führt Sie durch die Felder, die in jedem Charitable Zapier-Trigger verfügbar sind.
Hinweis: Die Zapier-Integration von Charitable erfordert Charitable Pro 1.8.14+ und das Automation Connect Addon 2.1.0+ (Pro-Plan oder höher).
Stellen Sie vor Beginn sicher, dass Sie Charitable mit Zapier verbunden haben.
- Spenden-Trigger-Felder
- Felder für wiederkehrende Abonnements
- Kampagnen-Trigger-Felder
- Aktions- und Such-Eingaben
Spenden-Trigger-Felder
Diese Felder werden von Neue Spende, Spende abgeschlossen, Spende zurückerstattet und Erstmaliger Spender gesendet. Die exakte Nutzlaststruktur ist für alle vier gleich, sodass ein für einen erstellter Zap leicht an die anderen angepasst werden kann.
| Feld | Beschreibung | Beispiel |
|---|---|---|
donation_id | Die interne WordPress-Post-ID für die Spende. | 123 |
Ereignis | Der Slug des Trigger-Ereignisses. | Spende abgeschlossen |
Titel | Titelpräfix des Spenders, wenn auf dem Formular erfasst. | Frau |
vorname | Vorname des Spenders. | Wanda |
nachname | Nachname des Spenders. | Maximoff |
E-Mail | E-Mail-Adresse des Spenders. | [email protected] |
Adresse | Straße. | Einheit 2b |
Stadt | Stadt. | Novi Grad |
Bundesland | Bundesland oder Region. | Novi Grad Staat |
Postleitzahl | Postleitzahl. | 12345 |
Land | Ländercode oder vollständiger Name, abhängig von der Formular-Konfiguration. | Sokovia |
Telefon | Telefonnummer des Spenders, wenn erfasst. | 987654321 |
Zwischensumme | Der Spendenbetrag vor Gebühren. | 25 |
Gesamtbetrag | Der endgültige Spendenbetrag, der dem Spender berechnet wird, einschließlich etwaiger Gebühren, die er übernommen hat. | 26.50 |
Datum | Zeitstempel der Spende im ISO 8601-Format. | 2026-05-08T14:20:27+00:00 |
Status | Interner Spendenstatus mit dem Präfix charitable-. Siehe die Statusreferenz unten. | charitable-abgeschlossen |
Spendenzahlungstor | Slug des verwendeten Zahlungs-Gateways. | stripe, paypal, manual |
Zahlungstransaktions-ID | Die Transaktionsreferenz des Gateways, nützlich für den Abgleich. | ch_abc123def |
Testmodus | 1 , wenn die Spende im Testmodus des Gateways getätigt wurde, andernfalls 0. | 0 |
campaign_id | Die Kampagne, für die die Spende getätigt wurde. Wenn eine Spende auf mehrere Kampagnen aufgeteilt wird, ist dies eine durch Kommas getrennte Liste von IDs. | 8 |
Kontaktzustimmung | 1 , wenn der Spender dem Erhalt von Kontakten zugestimmt hat, andernfalls 0. | 1 |
Gebühren übernehmen | 1 , wenn der Spender die Übernahme der Bearbeitungsgebühr gewählt hat. | 1 |
Gebührenbetrag | Der Teil von total , der die Gateway-Gebühren abdeckt. | 1.50 |
Zustimmung zur Nachverfolgung | 1 , wenn der Spender dem Tracking-Pixeln und der Analyse zugestimmt hat. | 0 |
Newsletter-Anmeldung | 1 , wenn der Spender dem Newsletter zugestimmt hat. | 1 |
Geschenk-Hilfe | 1 , wenn der Spender Gift Aid (britische Spender) beansprucht hat. | 0 |
Anonyme Spende | 1 , wenn der Spender gewählt hat, öffentlich als anonym angezeigt zu werden. | 1 |
Kommentar des Spenders | Freitextnachricht des Spenders bei der Spende. | In Gedenken an Maria |
Spendenstatuswerte
Das status-Feld verwendet die internen Slugs von Charitable, alle mit dem Präfix charitable-. Filterregeln und bedingte Logik sollten mit diesen exakten Werten übereinstimmen.
charitable-abgeschlossen– Zahlung erhalten und vom Gateway bestätigt. Verwenden Sie dies, wenn Sie nur auf echte Spenden reagieren möchten.charitable-ausstehend– Spendenzeile erstellt, aber Zahlung noch nicht bestätigt. Üblich für Offline-Gateways und Banküberweisungen.charitable-fehlgeschlagen– Gateway meldete einen Fehler. Dem Spender wurden keine Kosten berechnet.charitable-storniert– Spender oder Administrator haben die Transaktion abgebrochen.charitable-erstattet– die Spende wurde nach Abschluss zurückerstattet.
Felder für wiederkehrende Abonnements
Diese Felder werden von Neue wiederkehrende Abonnement, Wiederkehrende Spende erneuert, Wiederkehrendes Abonnement gekündigt, und Wiederkehrende Zahlung fehlgeschlagen gesendet. Die Nutzlast beschreibt den wiederkehrenden Plan selbst, nicht eine einzelne Abbuchung.
| Feld | Beschreibung | Beispiel |
|---|---|---|
ID der wiederkehrenden Spende | Die Post-ID des wiederkehrenden Plans. | 122 |
Ereignis | Der Slug des Trigger-Ereignisses. | subscription_renewed |
ID der ersten Spende | Die Spenden-ID der ersten Abbuchung, die diesen Plan gestartet hat. | 123 |
Zwischensumme wiederkehrende Spende | Der wiederkehrende Basisbetrag vor Gebühren. | 50 |
recurring_total | Der wiederkehrende abgebuchte Betrag inklusive Gebühren. | 53 |
wiederkehrende_periode | Die Einheit der Wiederholung. | Tag, Woche, Monat, Jahr |
recurring_interval | Wie viele recurring_period Einheiten zwischen Abbuchungen. 1 = jeden Monat, 3 = alle drei Monate usw. | 1 |
recurring_length | Gesamtzahl der Abbuchungen. 0 bedeutet kein festes Ende. | 6 |
recurring_expiration_date | Datum, an dem der Plan endet, ISO 8601. Leer, wenn unbefristet. | 2026-09-08T00:00:00+00:00 |
recurring_renewal_date | Datum der nächsten geplanten Abbuchung, ISO 8601. | 2026-06-01T00:00:00+00:00 |
gateway_subscription_id | Die Abonnementreferenz des Gateways. Nützlich für den direkten Abgleich mit Stripe oder PayPal. | sub_xyz987 |
vorname | Vorname des Spenders. | Wanda |
nachname | Nachname des Spenders. | Maximoff |
E-Mail | E-Mail-Adresse des Spenders. | [email protected] |
Adresse, Adresszusatz, Stadt, Bundesland, Postleitzahl, Land, Telefon | Adresse und Telefonnummer des Spenders, wenn sie im Formular erfasst wurden. | |
Zwischensumme | Der Grundbetrag der letzten einzelnen Abbuchung. | 25 |
Gesamtbetrag | Der Endbetrag der letzten einzelnen Abbuchung. | 26.50 |
Datum | Datum, an dem der Plan erstellt wurde, ISO 8601. | 2026-05-08T14:20:27+00:00 |
Status | Der aktuelle Status des Plans. Siehe unten. | charitable-active |
Spendenzahlungstor | Gateway-Slug. | stripe |
Testmodus | 1 wenn im Testmodus erstellt. | 0 |
campaign_id | Die Kampagne, die der Plan unterstützt. Bei Aufteilung durch Kommas getrennt. | 8 |
Kontaktzustimmung, Gebührenübernahme, Gebührenbetrag, Tracking-Zustimmung, Newsletter-Anmeldung, giftaid_claimed, anonyme_spende, spenderkommentar | Gleiche Bedeutungen wie die obige Spenden-Payload. | |
GoCardless-Kunden-ID | GoCardless-Kundenreferenz, falls zutreffend. | goc123123 |
GoCardless-Mandats-ID | GoCardless-Mandatsreferenz, falls zutreffend. | goc987987 |
Werte für den Status von wiederkehrenden Abonnements
charitable-active– der Plan ist aktiv und wird planmäßig erneuert.charitable-cancelled– der Spender oder Administrator hat den Plan storniert.charitable-expired– der Plan hat sein Enddatum erreicht.charitable-failed– ein Verlängerungsversuch ist fehlgeschlagen und der Plan ist ausgesetzt.
Kampagnen-Trigger-Felder
Diese Felder werden von Kampagnenziel erreicht und Kampagne beendet gesendet. Die Nutzlast beschreibt die Kampagne selbst.
| Feld | Beschreibung | Beispiel |
|---|---|---|
campaign_id | Die Beitrags-ID der Kampagne. | 123 |
Ereignis | Der Slug des Trigger-Ereignisses. | campaign_goal_reached |
Titel | Kampagnentitel. | Jahresendappell |
description | Kurzer Beschreibungstext der Kampagne. | Helfen Sie uns, unser Spenden-Ziel zu erreichen |
Ziel | Spendenziel in der Währung Ihres Shops. | 2000 |
gespendeter_betrag | Gesamtbetrag, der zum Zeitpunkt des Auslösens des Ereignisses gesammelt wurde. | 2045 |
spender_anzahl | Gesamtzahl der eindeutigen Spender. | 38 |
Enddatum | Kampagnenenddatum, ISO 8601. Leer, wenn die Kampagne kein Enddatum hat. | 2026-12-31T23:59:59+00:00 |
Datum | Wann die Kampagne veröffentlicht wurde, ISO 8601. | 2026-05-01T10:00:00+00:00 |
Status | WordPress-Beitragsstatus. | veröffentlichen |
Permalink | Öffentliche URL der Kampagne. | https://example.org/campaigns/year-end/ |
campaign_creator_id | WordPress-Benutzer-ID des Kampagnenbesitzers. | 4 |
campaign_creator_name | Anzeigename des Kampagnenbesitzers. | Bruce Banner |
campaign_creator_email | E-Mail-Adresse des Kampagnenbesitzers. | [email protected] |
Empfänger | Wohin die Gelder fließen – typischerweise fundraiser für Peer-to-Peer oder parent für Kind-Kampagnen. | Fundraiser |
post_parent | Wenn die Kampagne eine Peer-to-Peer-Kindkampagne ist, die ID der übergeordneten Kampagne. 0für eigenständige Kampagnen. | 99 |
fundraiser_type | Für Peer-to-Peer-Kampagnen, der Spendentyp. | Einzelperson, Team |
Team-ID, Teamname, Teamkapitän-ID | Team-Metadaten für Peer-to-Peer-Team-Fundraiser. |
Hinweis: Für Kampagnenziel erreicht enthält das Ereignis amount_raised, goal und percent_funded als zusätzliche Felder über die Standard-Kampagnennutzlast hinaus. Diese werden in dem Moment berechnet, in dem das Ziel erreicht wurde, und werden danach nicht mehr aktualisiert.
Aktions- und Such-Eingaben
Die beiden Aktionsschritte und zwei Suchschritte haben jeweils eigene Eingabefelder, die im Zap-Editor sichtbar sind. Da sich Eingabefelder häufiger ändern als Trigger-Nutzdaten, ist dieser Abschnitt eine kurze Zusammenfassung und keine vollständige Tabelle – öffnen Sie den Schritt im Zap-Editor für die aktuelle vollständige Liste mit Hilfetext.
- Spender erstellen – akzeptiert Spenderprofilfelder (Vorname, Nachname, E-Mail, Adressfelder, Telefon, Kontaktzustimmung, Newsletter-Opt-in). Gibt den vollständigen Datensatz des erstellten oder übereinstimmenden Spenders zurück.
- Spender aktualisieren – nimmt ein Nachschlagefeld (E-Mail oder Spender-ID) plus beliebige der gleichen Spenderprofilfelder. Nur die von Ihnen bereitgestellten Felder werden geändert.
- Spender per E-Mail finden – nimmt eine Eingabe, die E-Mail-Adresse. Gibt den vollständigen Datensatz des Spenders zurück oder keine Übereinstimmung.
- Kampagne finden – nimmt entweder einen Kampagnen-Slug oder eine Kampagnen-ID. Gibt die Kampagnennutzlast zurück, die im Abschnitt „Kampagnen-Triggerfelder“ oben beschrieben ist.
Das ist alles! Sie wissen jetzt, was jeder Charitable Zapier-Trigger sendet. Das bedeutet, dass die Feldzuordnung in jedem nachfolgenden Zap-Schritt unkompliziert sein sollte. Sehen Sie als Nächstes Filtern von Charitable Zaps nach Kampagne, um einen Zap auf bestimmte Kampagnen oder Bedingungen zu beschränken, und Verbinden von Charitable mit Zapier für die Hauptanleitung zum Einstieg.
FAQ
Was ist der Unterschied zwischen subtotal und total?
subtotal ist der Basisbetrag der Spende, den der Spender ausgewählt hat. total ist der Betrag, der tatsächlich abgebucht wurde, der höher sein kann, wenn der Spender sich entschieden hat, die Verarbeitungsgebühr des Gateways zu übernehmen. Der Unterschied wird im Feld fee_amount angezeigt.
Warum beginnt status immer mit charitable-?
Charitable registriert eigene WordPress-Beitragsstatus, um sie von integrierten WordPress-Status wie publish und draft zu trennen. Das Präfix charitable- ist intern, aber für Filter erforderlich – Regeln für (Text) Stimmt genau überein benötigen den vollständigen Präfixwert, nicht nur completed oder refunded.
Gibt es Felder, die nicht in dieser Liste aufgeführt sind?
Ja. Charitable ermöglicht es Entwicklern, benutzerdefinierte Spenden-, Spender- und Kampagnenfelder hinzuzufügen, und jedes Feld, das in der Donation Fields API als show_in_webhook gekennzeichnet ist, wird automatisch neben den Standardwerten in die Nutzlast aufgenommen. Überprüfen Sie die Beispiel-Triggerdaten im Zap-Editor, um benutzerdefinierte Felder anzuzeigen, die von Ihrer spezifischen Installation oder von anderen Charitable-Erweiterungen hinzugefügt wurden.
Kann ich nur eine Teilmenge von Feldern an meine nachgelagerte Aktion senden?
Ja. Der Aktionsschritt des Zap-Editors ermöglicht es Ihnen, eine beliebige Teilmenge der Felder des Triggers den Eingaben der Aktion zuzuordnen. Felder, die Sie nicht zuordnen, werden einfach ignoriert. Dies ist der sauberste Weg, um CRM-Kontaktdatensätze übersichtlich zu halten.
Woher weiß ich, zu welcher Kampagne eine Peer-to-Peer-Spendenaktion gehört?
Sehen Sie sich post_parent in einer Kampagnen-Trigger-Nutzlast an. Bei untergeordneten Kampagnen enthält post_parent die ID der übergeordneten Kampagne. Bei eigenständigen Kampagnen ist es 0.
