Formular-Events der Donation Form Suite für externes Tracking nutzen

Geändert am: Di, 17 Nov, 2026 um 10:15 VORMITTAGS

Applicable plans a b c d

INHALTSVERZEICHNIS

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.

EventWann wird es ausgelöst?
form_viewedDas Spendenformular wurde geladen und ist einsatzbereit.
donation_startedDie spendende Person ändert erstmals einen Formularwert.
payment_attemptedEin Zahlungsversuch wird gestartet.
donation_successEine Spende wurde erfolgreich abgeschlossen.
payment_canceledEin 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_viewed wird einmal pro Seitenaufruf ausgelöst.
  • Spendenbeginn: donation_started wird einmal pro Seitenaufruf ausgelöst, sobald die erste Formularänderung erfolgt.
  • Zahlungsversuch: payment_attempted wird bei jedem Zahlungsversuch ausgelöst.
  • Spendenabschluss: donation_success signalisiert eine erfolgreich abgeschlossene Spende.
  • Zahlungsabbruch: payment_canceled wird 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

  1. Öffne Deinen Google Tag Manager.
  2. Erstelle einen neuen Trigger.
  3. Wähle als Triggertyp Benutzerdefiniertes Ereignis (Custom Event).
  4. Trage unter Ereignisname folgenden Wert ein: frb.donation_success.
  5. 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

  1. Erstelle in Google Tag Manager ein neues Google Analytics: GA4-Ereignis-Tag.
  2. Trage als Ereignisnamen beispielsweise donation_success ein.
  3. Weise dem Tag den zuvor erstellten Trigger zu.
  4. Stelle sicher, dass die Ausführung des Tags die Consent-Einstellungen Deiner Website berücksichtigt.
  5. 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:

InformationData-Layer-Variablenname
Formular-IDfrb.properties.formUuid
Formulartypfrb.properties.formType
Zahlungsweisefrb.properties.paymentMethod
Spendenintervallfrb.properties.interval
Gebührenübernahmefrb.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_success bezeichnet das DOM-Event für eine erfolgreiche Spende.
  • event.detail.properties.formUuid enthä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.

EreignisDOM-EventDataLayer-Event
Formular geladenfrb:form_viewedfrb.form_viewed
Spende begonnenfrb:donation_startedfrb.donation_started
Zahlungsversuch gestartetfrb:payment_attemptedfrb.payment_attempted
Spende erfolgreichfrb:donation_successfrb.donation_success
Zahlung abgebrochenfrb:payment_canceledfrb.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

EigenschaftBeschreibung
versionVersion des Event-Datenformats
nameTechnischer Name des ausgelösten Events
formUuidEindeutige Kennung des Spendenformulars
formTypeTechnische Kennung des Formulartyps
paymentMethodAusgewählte Zahlungsweise
intervalNumerische Kennung des Spendenintervalls
donorCoversTheFeeGibt 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

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_viewed und donation_started, um Formularaufrufe und begonnene Spendenprozesse zu unterscheiden.
  • Zahlungsversuche richtig interpretieren: Berücksichtige, dass payment_attempted bei 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

Lassen Sie uns bitte wissen, wie wir diesen Beitrag verbessern können.

Weitere Artikel in Donation Form Suite