Formular-Events der Donation Form Suite für externes Tracking nutzen
Geändert am: Di, 17 Nov, 2026 um 10:15 VORMITTAGS
INHALTSVERZEICHNIS
- So profitierst Du vom Event-Tracking der Donation Form Suite
- Voraussetzungen für das Event-Tracking
- Verfügbare Formular-Events im Überblick
- So stellt die Donation Form Suite die Events bereit
- Formular-Events mit Google Tag Manager und GA4 erfassen
- Formular-Events direkt mit JavaScript verarbeiten
- Technischer Aufbau der Event-Daten
- Datenschutz und Consent beim Event-Tracking berücksichtigen
- Häufige Fragen und mögliche Probleme
- Empfehlungen für die Auswertung Deiner Formular-Events
Mit den Formular-Events der Donation Form Suite kannst Du wichtige Schritte im Spendenprozess erfassen und in das Tracking Deiner Website einbinden. So erkennst Du beispielsweise, wann Spender*innen eine Spende beginnen, eine Zahlung abbrechen oder erfolgreich spenden.
In diesem Artikel erfährst Du, welche Events verfügbar sind und wie Du sie mit Google Tag Manager, Google Analytics 4 oder eigenem JavaScript verwendest.
So profitierst Du vom Event-Tracking der Donation Form Suite
Bei den klassischen Spendenformularen können Tracking-Skripte direkt im Formular hinterlegt werden. Da das Tracking innerhalb eines iframes stattfindet, ist es jedoch weitgehend vom Tracking und der Consent-Steuerung Deiner Website getrennt.
Die Donation Form Suite stellt wichtige Ereignisse aus dem Spendenprozess dagegen direkt auf Deiner Website bereit. Dadurch kannst Du:
- Die gesamte Donor Journey nachvollziehen: Verknüpfe Formular-Events mit Deinen bestehenden Website- und Kampagnenanalysen.
- Erfolgreiche Spenden zuverlässig erfassen: Werte tatsächliche Spendenabschlüsse aus, statt dafür eine separate Dankes-Seite als Tracking-Workaround zu verwenden.
- Abbrüche besser erkennen: Analysiere, wie häufig Spenden begonnen, Zahlungsversuche gestartet oder Zahlungen abgebrochen werden.
- Dein bestehendes Analytics-Setup nutzen: Verarbeite die Events beispielsweise mit Google Tag Manager, Google Analytics 4 oder Matomo.
- Die Consent-Steuerung Deiner Website berücksichtigen: Integriere die Event-Verarbeitung in Deine vorhandene Tracking- und Einwilligungskonfiguration.
Info: Die Donation Form Suite stellt die Events automatisch bereit. Damit sie in Deinem Analytics-System erfasst werden, musst Du die entsprechende Tracking-Integration auf Deiner Website einrichten.
Voraussetzungen für das Event-Tracking
Die Event-Schnittstelle unterstützt beide Formulartypen der Donation Form Suite:
Die Events stehen automatisch zur Verfügung, sobald Du ein Formular regulär über die JavaScript-Einbettung auf Deiner Website eingebunden hast. Eine zusätzliche Aktivierung im Formular-Editor ist nicht erforderlich.
Achtung:
Das Event-Tracking funktioniert nur bei der regulären JavaScript-Einbettung über die Web Component der Donation Form Suite. Bei einer Einbettung über einen iframe werden die Events nicht an die umgebende Website weitergegeben.
Verfügbare Formular-Events im Überblick
Die Donation Form Suite stellt fünf Events bereit, mit denen Du wichtige Schritte im Spendenprozess erfassen kannst.
| Event | Wann wird es ausgelöst? |
|---|---|
form_viewed | Das Spendenformular wurde geladen und ist einsatzbereit. |
donation_started | Die spendende Person ändert erstmals einen Formularwert. |
payment_attempted | Ein Zahlungsversuch wird gestartet. |
donation_success | Eine Spende wurde erfolgreich abgeschlossen. |
payment_canceled | Ein Zahlungsvorgang wird abgebrochen, beispielsweise im PayPal-Fenster. |
Wie häufig werden die Events ausgelöst?
Die Anzahl der Events hängt vom jeweiligen Ereignis ab:
- Formularaufruf:
form_viewedwird einmal pro Seitenaufruf ausgelöst. - Spendenbeginn:
donation_startedwird einmal pro Seitenaufruf ausgelöst, sobald die erste Formularänderung erfolgt. - Zahlungsversuch:
payment_attemptedwird bei jedem Zahlungsversuch ausgelöst. - Spendenabschluss:
donation_successsignalisiert eine erfolgreich abgeschlossene Spende. - Zahlungsabbruch:
payment_canceledwird bei jedem Abbruch eines Zahlungsvorgangs ausgelöst.
Weitere intern erfasste Ereignisse, beispielsweise Validierungsfehler, stehen über die öffentliche Event-Schnittstelle nicht zur Verfügung.
So stellt die Donation Form Suite die Events bereit
Du kannst die Formular-Events über zwei technische Schnittstellen verwenden. Beide stellen die Ereignisse lokal im Browser bereit.
DataLayer für Google Tag Manager
Die Donation Form Suite schreibt die Events automatisch in window.dataLayer. Dadurch kannst Du sie mit Google Tag Manager (GTM) erfassen und beispielsweise an Google Analytics 4 (GA4) weitergeben.
DOM-Events für eigene JavaScript-Integrationen
Zusätzlich stellt die Donation Form Suite die Ereignisse als JavaScript Custom Events bereit. Entwickler*innen und Agenturen können diese direkt auf Deiner Website empfangen und individuell verarbeiten.
Info: Die FundraisingBox überträgt die Events nicht selbst an externe Analytics-Dienste und lädt dafür keine zusätzlichen Tracking-Skripte. Ob und wohin Event-Daten weitergegeben werden, hängt von der Tracking-Konfiguration Deiner Website ab.
Formular-Events mit Google Tag Manager und GA4 erfassen
Wenn Du Google Tag Manager bereits auf Deiner Website verwendest, kannst Du die Formular-Events über benutzerdefinierte Ereignisse erfassen. Das folgende Beispiel zeigt Dir, wie Du erfolgreich abgeschlossene Spenden als GA4-Ereignis übermittelst.
Schritt 1: Trigger in Google Tag Manager erstellen
- Öffne Deinen Google Tag Manager.
- Erstelle einen neuen Trigger.
- Wähle als Triggertyp Benutzerdefiniertes Ereignis (Custom Event).
- Trage unter Ereignisname folgenden Wert ein:
frb.donation_success. - Speichere den Trigger.
Der Trigger reagiert auf das DataLayer-Event, das die Donation Form Suite nach einer erfolgreich abgeschlossenen Spende bereitstellt.
Schritt 2: GA4-Ereignis-Tag konfigurieren
- Erstelle in Google Tag Manager ein neues Google Analytics: GA4-Ereignis-Tag.
- Trage als Ereignisnamen beispielsweise
donation_successein. - Weise dem Tag den zuvor erstellten Trigger zu.
- Stelle sicher, dass die Ausführung des Tags die Consent-Einstellungen Deiner Website berücksichtigt.
- Speichere Deine Konfiguration.
Sobald eine Spende erfolgreich abgeschlossen wurde, stellt die Donation Form Suite das Event frb.donation_success im DataLayer bereit. Google Tag Manager kann daraufhin das konfigurierte GA4-Tag auslösen, sofern die erforderliche Einwilligung vorliegt.
Schritt 3: Zusätzliche Formularinformationen auslesen
Du kannst weitere Event-Eigenschaften über Data-Layer-Variablen in Google Tag Manager auslesen. Damit lässt sich beispielsweise erkennen, über welches Formular eine Spende abgeschlossen wurde.
Erstelle dazu für die gewünschten Eigenschaften jeweils eine Variable vom Typ Datenschichtvariable (Data Layer Variable) und verwende den entsprechenden Variablennamen:
| Information | Data-Layer-Variablenname |
|---|---|
| Formular-ID | frb.properties.formUuid |
| Formulartyp | frb.properties.formType |
| Zahlungsweise | frb.properties.paymentMethod |
| Spendenintervall | frb.properties.interval |
| Gebührenübernahme | frb.properties.donorCoversTheFee |
Wichtig: Die Zahlungsweise, das Spendenintervall und die Gebührenübernahme werden ausschließlich beim Event payment_attempted bereitgestellt. Beim Event donation_success sind diese Eigenschaften nicht enthalten.
Formular-Events direkt mit JavaScript verarbeiten
Wenn Du die Events ohne Google Tag Manager verarbeiten möchtest, kannst Du JavaScript Event Listener verwenden. Damit reagiert Deine Website direkt auf die bereitgestellten DOM-Events.
Beispiel: Erfolgreiche Spende erkennen
Der folgende Event Listener reagiert auf eine erfolgreich abgeschlossene Spende und gibt die Formular-ID in der Browser-Konsole aus:
document.addEventListener('frb:donation_success', function (event) {
const properties = event.detail.properties;
console.log('Spende erfolgreich:', properties.formUuid);
});Der Code verwendet zwei Bestandteile:
frb:donation_successbezeichnet das DOM-Event für eine erfolgreiche Spende.event.detail.properties.formUuidenthält die eindeutige Formular-ID.
Technische Eventnamen für beide Schnittstellen
Die Eventnamen unterscheiden sich je nach Schnittstelle. DataLayer-Events verwenden einen Punkt, DOM-Events einen Doppelpunkt nach dem Präfix frb.
| Ereignis | DOM-Event | DataLayer-Event |
|---|---|---|
| Formular geladen | frb:form_viewed | frb.form_viewed |
| Spende begonnen | frb:donation_started | frb.donation_started |
| Zahlungsversuch gestartet | frb:payment_attempted | frb.payment_attempted |
| Spende erfolgreich | frb:donation_success | frb.donation_success |
| Zahlung abgebrochen | frb:payment_canceled | frb.payment_canceled |
Technischer Aufbau der Event-Daten
Alle Formular-Events verwenden ein einheitliches, versioniertes Datenformat. Welche Eigenschaften enthalten sind, hängt vom jeweiligen Event ab.
Beispiel: DataLayer-Eintrag bei einem Zahlungsversuch
Bei einem Zahlungsversuch kann der DataLayer-Eintrag beispielsweise so aussehen:
{
event: 'frb.payment_attempted',
frb: {
version: 1,
name: 'payment_attempted',
properties: {
formUuid: 'beispiel-formular-uuid',
formType: 'Express',
paymentMethod: 'payPal',
interval: 1,
donorCoversTheFee: true
}
}
}formType gibt den Formulartyp an. Verwende je nach Formular einen der folgenden Werte:
- Express Formular:
formType: 'Express' - Single-Step Formular:
formType: 'SingleStep'
Bedeutung der Event-Eigenschaften
| Eigenschaft | Beschreibung |
|---|---|
version | Version des Event-Datenformats |
name | Technischer Name des ausgelösten Events |
formUuid | Eindeutige Kennung des Spendenformulars |
formType | Technische Kennung des Formulartyps |
paymentMethod | Ausgewählte Zahlungsweise |
interval | Numerische Kennung des Spendenintervalls |
donorCoversTheFee | Gibt an, ob die Gebührenübernahme aktiviert wurde |
Unterschiede zwischen den Event-Daten
Nicht alle Events enthalten dieselben Eigenschaften.
- Bei
payment_attempted: Zusätzlich zu den Formularinformationen stehen die Zahlungsweise, das Spendenintervall und die Gebührenübernahme zur Verfügung. - Bei
donation_success: Es werden nur die Formular-ID und der Formulartyp bereitgestellt, soweit diese Werte vorhanden sind.
Die Datenstruktur ist bei beiden Schnittstellen identisch. Du findest sie an unterschiedlichen Stellen:
- DataLayer: im Objekt
frb - DOM-Events: unter
event.detail
Datenschutz und Consent beim Event-Tracking berücksichtigen
Die Donation Form Suite stellt ausschließlich ausgewählte Informationen über die Event-Schnittstelle bereit.
Folgende Daten sind nicht enthalten:
- Personenbezogene Angaben von Spender*innen
- Spendenbeträge
- Währungsinformationen
- UTM-Parameter
Die Events werden lokal im Browser bereitgestellt. Die FundraisingBox übermittelt sie nicht automatisch an externe Analytics-Anbieter.
Die Bereitstellung der Events erfolgt unabhängig vom Consent-Status. Wenn Du die Daten über Google Tag Manager oder eigene Integrationen an externe Dienste übermittelst, musst Du die geltenden Datenschutzanforderungen und Consent-Einstellungen Deiner Website berücksichtigen.
Wichtig: Die lokale Bereitstellung eines Events bedeutet nicht, dass Du es ohne entsprechende Einwilligung an externe Tracking-Dienste übermitteln darfst. Berücksichtige deshalb die Consent-Einstellungen bei der Konfiguration Deiner Analytics-Tags.
Häufige Fragen und mögliche Probleme
Warum werden keine Formular-Events erfasst?
Prüfe zunächst, wie das Formular auf Deiner Website eingebettet ist. Die Event-Weitergabe funktioniert bei der regulären JavaScript-Einbettung über die Web Component, nicht bei einer iframe-Einbettung.
Wenn Du Google Tag Manager verwendest, prüfe außerdem, ob Dein Trigger den richtigen DataLayer-Eventnamen verwendet. Für erfolgreiche Spenden lautet dieser frb.donation_success.
Warum werden mehrere Zahlungsversuche erfasst?
Das Event payment_attempted wird bei jedem Zahlungsversuch ausgelöst. Startet eine spendende Person den Zahlungsvorgang mehrfach, entstehen entsprechend mehrere Events.
Ein Zahlungsversuch ist deshalb nicht mit einer erfolgreich abgeschlossenen Spende gleichzusetzen.
Warum fehlen Zahlungsinformationen beim Event für erfolgreiche Spenden?
Die Eigenschaften paymentMethod, interval und donorCoversTheFee stehen ausschließlich bei payment_attempted zur Verfügung.
Das Event donation_success enthält diese Eigenschaften nicht.
Kann ich Spendenbeträge oder einzelne Formularfelder erfassen?
Nein. Die öffentliche Event-Schnittstelle stellt derzeit weder Spendenbeträge noch Währungsinformationen, einzelne Feldinteraktionen oder Validierungsfehler bereit.
Muss ich Google Tag Manager oder Google Analytics verwenden?
Nein. Du kannst die Formular-Events auch direkt über JavaScript Custom Events verarbeiten.
Wenn Du Google Tag Manager oder Google Analytics 4 einsetzen möchtest, musst Du diese Dienste separat auf Deiner Website einrichten.
Empfehlungen für die Auswertung Deiner Formular-Events
- Erfolgreiche Spenden auswerten: Verwende
donation_success, um abgeschlossene Spenden zu erfassen. - Formularinteraktionen nachvollziehen: Nutze
form_viewedunddonation_started, um Formularaufrufe und begonnene Spendenprozesse zu unterscheiden. - Zahlungsversuche richtig interpretieren: Berücksichtige, dass
payment_attemptedbei wiederholten Versuchen mehrfach ausgelöst werden kann. - Formulare unterscheiden: Verwende
formUuid, um Events dem jeweiligen Spendenformular zuzuordnen. - Datenschutz berücksichtigen: Konfiguriere externe Tracking-Dienste entsprechend den Consent-Einstellungen Deiner Website.
War diese Antwort hilfreich? Ja Nein