Werte für Spendenaktionen oder dazugehörige Spendenformulare vorausfüllen (z.B. für Tracking)
Geändert am: Fr, 23 Okt, 2026 um 4:50 NACHMITTAGS
INHALTSVERZEICHNIS
- Voraussetzungen
- Unterschied zwischen Aktionsformular und Spendenformular
- Werte über URL-Parameter vorausfüllen
- Unsichtbare Werte und Tracking-Informationen übergeben
- Werte über den Einbettungscode vorausfüllen
- Häufige Probleme bei der Vorausfüllung
- Best Practices für vorausgefüllte Werte
Du kannst Felder im Spendenaktions-Tool automatisch mit bestimmten Werten vorausfüllen. Dafür übergibst Du die gewünschten Werte über die URL oder den Einbettungscode. In diesem Artikel erfährst Du, wie Du beispielsweise Spendenziele, Spendenbeträge oder Tracking-Informationen vorausfüllst.
Voraussetzungen
Du benötigst ein eingerichtetes Spendenaktions-Tool mit den entsprechenden Formularfeldern.
Falls Du das Spendenaktions-Tool noch nicht eingerichtet hast, findest Du die erforderlichen Schritte im Artikel Spendenaktions-Tool einrichten und auf Deiner Website einbetten.
Das Spendenaktions-Tool kannst Du direkt in Deiner FundraisingBox buchen. Informationen dazu findest Du im Artikel Verträge: Übersicht, Upgrades und neue Funktionen buchen. Bei Fragen hilft Dir das Support-Team weiter.
Unterschied zwischen Aktionsformular und Spendenformular
Ein Spendenaktions-Tool verwendet zwei unterschiedliche Formulare. Beide kannst Du mit Werten vorausfüllen. Allerdings unterscheiden sie sich in ihrer Funktion und den verfügbaren Parametern.
Formular zum Erstellen einer Spendenaktion
Über dieses Formular starten Aktionsstarter*innen ihre eigene Spendenaktion und geben die dafür benötigten Informationen ein.
- Das Formular verwendet grundsätzlich dieselbe URL, solange Du das Spendenaktions-Tool nicht auf eine andere Seite verschiebst.
- Du kannst beispielsweise ein Spendenziel oder benutzerdefinierte Felder vorausfüllen.
- Die Übergabe über URL-Parameter eignet sich besonders, wenn Du über einen eigenen Button auf das Formular verlinkst und dabei bestimmte Werte vorgeben möchtest.
Eine Übersicht der verfügbaren Parameter findest Du in der Developer-Dokumentation zur Vorausfüllung von Spendenaktionen.
Spendenformular einer Spendenaktion
Über dieses Formular können Spender*innen eine bestehende Spendenaktion unterstützen.
- Jede Spendenaktion hat eine eigene URL für ihr Spendenformular.
- Über URL-Parameter kannst Du Werte gezielt für eine bestimmte Spendenaktion übergeben, beispielsweise für eine Kampagne oder ein Mailing.
- Wenn ein Wert in allen Spendenformularen des Tools vorausgefüllt sein soll, empfiehlt sich die Übergabe über den Einbettungscode.
Die verfügbaren Parameter findest Du im Artikel Werte im Spendenformular vorausfüllen sowie in der Developer-Dokumentation zur Formular-Vorausfüllung.
Werte über URL-Parameter vorausfüllen
Mit URL-Parametern kannst Du Werte gezielt für einen bestimmten Formularaufruf vorgeben. Das eignet sich beispielsweise, wenn Du für eine Kampagne einen festen Spendenbetrag oder ein bestimmtes Spendenziel vorschlagen möchtest.
URL-Parameter ergänzen
- Öffne die URL des Formulars, das Du vorausfüllen möchtest.
- Ermittle den passenden Parameter für das gewünschte Feld.
- Ergänze den Parameter und den gewünschten Wert in der URL.
- Platziere zusätzliche Parameter möglichst vor den Standardparametern des Spendenaktions-Tools.
- Öffne die angepasste URL und prüfe, ob der Wert korrekt übernommen wird.
Spendenaktions-URLs enthalten bereits Parameter, die auf die jeweilige Ansicht des eingebetteten Tools verweisen. Dazu gehören beispielsweise:
?cfs=e?cfd=abcd#cff
Wenn Du weitere Parameter ergänzt, musst Du diese korrekt mit einem kaufmännischen Und-Zeichen (&) voneinander trennen.
Hinweis: Über URL-Parameter übergebene Werte sind in der Adresszeile des Browsers sichtbar. Veränderbare Werte können Nutzer*innen dort auch selbst anpassen.
Beispiele für das Formular zum Erstellen einer Spendenaktion
Die folgenden Beispiele zeigen unterschiedliche Möglichkeiten, Werte über die URL zu übergeben.
Beispiel 1: Spendenziel vorausfüllen
Mit dem Parameter goal=500 wird ein Spendenziel von 500 € vorausgefüllt.
https://international-action.org/de/anlassspende/spendenaktion/?goal=500&cfs=e
Beispiel 2: Benutzerdefiniertes Feld mit festem Wert vorausfüllen
Du kannst auch ein benutzerdefiniertes Feld vom Typ Spendenaktion vorausfüllen. Im folgenden Beispiel wird die Kategorie der Spendenaktion mit dem Wert creative vorbelegt.
https://international-action.org/de/anlassspende/spendenaktion/?fundraisingpage_custom_field_2207_fix=creative&cfs=e
Durch den Zusatz _fix wird der Wert fest übergeben und kann im Formular nicht verändert werden.
Beispiel 3: Mehrere Werte gleichzeitig übergeben
Du kannst mehrere Parameter miteinander kombinieren. Im folgenden Beispiel werden ein fester Spendenbetrag von 50 € und der öffentliche Name „Max Mustermann“ übergeben.
https://international-action.org/de/anlassspende/spendenaktion/?amount_fix=50&public_name=Max%20Mustermann&cfs=p&cfd=ttsil#cff
Mit dem Zusatz _fix kannst Du geeignete Werte fest vorgeben. Ohne diesen Zusatz bleiben vorausgefüllte Werte grundsätzlich veränderbar.
Unsichtbare Werte und Tracking-Informationen übergeben
Du kannst auch Werte an Formularfelder übergeben, die für Nutzer*innen nicht sichtbar sind. Das ist beispielsweise hilfreich, wenn Du Spenden bestimmten Kampagnen oder Kommunikationskanälen zuordnen möchtest.
Dafür kannst Du benutzerdefinierte Felder oder nicht sichtbare Posten verwenden.
Unsichtbare Felder vorbereiten
- Öffne die Einstellungen des zugehörigen Spendenaktions-Tool-Formulars. Gehe dazu auf links im Menü Spendenaktionen > Einstellungen, klicke auf den Namen des zu bearbeitenden Spendenaktions-Tools und wähle oben den Reiter Formular.
- Konfiguriere die gewünschten benutzerdefinierten Felder
- Entferne den Haken bei Sichtbar neben dem entsprechenden Feld, damit es für die Spender*innen nicht sichtbar ist im Formular.
- Ermittle den passenden Parameter und die ID des jeweiligen Feldes oder Postens. Die IDs der benutzerdefinierten Felder findest bspw. unter Konfiguration > Benurterdef. Felder.
In der Übersicht Deiner bereits angelegten benutzerdefinierten Felder befindet sich die ID des jeweiligen Feldes ganz rechts. - Ergänze den Parameter mit dem gewünschten Wert in der URL.
Für das Formular zum Erstellen einer Spendenaktion verwendest Du die entsprechenden Parameter und IDs der nicht sichtbaren Posten. Für das zugehörige Spendenformular nutzt Du die Parameter der benutzerdefinierten Felder.
Wichtig: Nicht sichtbare Posten können nur mit fest vorgegebenen Werten vorausgefüllt werden.
Beispiel für ein konkretes Spendenformular einer Spendenaktion: Spenden über Facebook erfassen
Du möchtest nachvollziehen, welche Spenden über einen Beitrag auf Facebook eingehen. Dafür hast Du im zugehörigen Spendenformular bereits ein benutzerdefiniertes Transaktionsfeld eingerichtet und als unsichtbar hinterlegt.
Jetzt ergänzt Du den passenden Parameter mit dem Wert Facebook in der URL der Spendenaktion:
https://international-action.org/get-involved.html?lang=de&cfs=p&cfd=4wavn&donation_custom_field_16993_fix=Facebook#cffDer Parameter donation_custom_field_16993_fix=Facebook übergibt den Wert Facebook an das entsprechende benutzerdefinierte Transaktionsfeld.
So nutzt Du die URL für Dein Tracking:
- Stelle sicher, dass das benutzerdefinierte Feld im Spendenformular als unsichtbar hinterlegt ist.
- Ergänze den passenden URL-Parameter mit dem gewünschten Wert, beispielsweise
Facebook. - Rufe die angepasste URL auf und prüfe die Übergabe.
- Veröffentliche die individualisierte URL anschließend auf Facebook.
Spenden, die über diese URL eingehen, können dadurch der Quelle Facebook zugeordnet werden.
Du kannst das gleiche Vorgehen für weitere Kommunikationskanäle nutzen und jeweils einen passenden Wert übergeben.
Info: Das unsichtbare Feld wird den Spender*innen im Formular nicht angezeigt. Der übergebene Wert bleibt jedoch in der Adresszeile des Browsers sichtbar.
Die Feld-ID 16993 stammt aus dem Beispiel. Verwende für Dein eigenes Formular den Parameter des tatsächlich eingerichteten benutzerdefinierten Feldes. Die IDs der benutzerdefinierten Felder findest bspw. unter Konfiguration > Benurterdef. Felder. In der Übersicht Deiner bereits angelegten benutzerdefinierten Felder befindet sich die ID des jeweiligen Feldes ganz rechts.
Werte über den Einbettungscode vorausfüllen
Wenn bestimmte Werte standardmäßig für alle Aufrufe eines Spendenaktions-Tools gelten sollen, kannst Du sie direkt im JavaScript-Einbettungscode hinterlegen.
Diese Variante hat zwei Vorteile:
- Die vorausgefüllten Werte erscheinen nicht als zusätzliche Parameter in der Seiten-URL.
- Die Werte werden bei jedem entsprechenden Formularaufruf standardmäßig übernommen.
Da das Formular zum Erstellen einer Spendenaktion und das zugehörige Spendenformular unterschiedliche Parameter verwenden, kannst Du Werte für beide Formulare im Haupteinbettungscode hinterlegen.
Spendenziel und Spendenbetrag standardmäßig vorausfüllen
Im folgenden Beispiel möchtest Du:
- Im Formular zum Erstellen einer Spendenaktion ein Spendenziel von 1.000 € vorgeben.
- In allen zugehörigen Spendenformularen einen Spendenbetrag von 20 € vorausfüllen.
Dafür verwendest Du die Parameter:
goalfür das Spendenzielamountfür den Spendenbetrag
Beide Parameter erwarten einen Zahlenwert.
So gehst Du vor:
- Öffne den Einbettungscode Deines Spendenaktions-Tools. Gehe dazu auf links im Menü Spendenaktionen > Einstellungen, klicke auf den Namen des zu bearbeitenden Spendenaktions-Tools und wähle oben den Reiter Einbettungscode.
- Ergänze die Parameter
goal=1000&amount=20&im JavaScript-Einbettungscode. - Speichere den angepassten Code auf Deiner Website.
- Öffne das Formular zum Erstellen einer Spendenaktion und prüfe das vorausgefüllte Spendenziel.
- Öffne anschließend das Spendenformular einer Aktion und kontrolliere den vorausgefüllten Spendenbetrag.
Beispiel für den angepassten Einbettungscode:
<!-- Begin FundraisingBox -->
<script type="text/javascript" src="https://secure.fundraisingbox.com/app/widgetJS?goal=1000&amount=20&cfh=XXXXX"></script>
<noscript>Bitte Javascript aktivieren</noscript>
<a target="_blank" href="https://www.fundraisingbox.com">
<img border="0" style="border:0!important" src="https://secure.fundraisingbox.com/images/FundraisingBox-Logo-Widget.png" alt="FundraisingBox Logo" />
</a>
<!-- End FundraisingBox -->Wenn Du anschließend das Formular zum Erstellen einer Spendenaktion aufrufst, ist das Spendenziel mit 1.000 € vorausgefüllt. In den Spendenformularen, die direkt über die Seiten aufgerufen werden, ist ein Spendenbetrag von 20 € vorbelegt.
Wichtig: Der gezeigte Einbettungscode ist nur ein Beispiel. Verwende immer den individuellen Einbettungscode Deines eigenen Spendenaktions-Tools.
URL-Parameter haben Vorrang vor dem Einbettungscode
Wenn Du Werte sowohl im Einbettungscode als auch über die URL übergibst, haben die URL-Parameter Vorrang.
Beispiel: Im Einbettungscode ist ein Spendenziel von 1.000 € hinterlegt. Für eine bestimmte Kampagne möchtest Du stattdessen 500 € vorausfüllen. Dafür ergänzt Du den entsprechenden URL-Parameter:
?goal=500&cfs=eBeim Aufruf dieser URL wird das Spendenziel von 500 € verwendet.
Häufige Probleme bei der Vorausfüllung
Ein Wert wird nicht übernommen
Wenn ein Wert nicht wie erwartet vorausgefüllt wird, prüfe folgende Punkte:
- Verwendest Du den richtigen Parameter für das jeweilige Formular?
- Ist der gewünschte Wert korrekt angegeben?
- Sind alle URL-Parameter mit
&voneinander getrennt? - Hast Du zusätzliche Parameter korrekt in die bestehende URL eingefügt?
- Verwendest Du bei benutzerdefinierten Feldern die passende Feld-ID?
- Rufst Du das richtige Formular beziehungsweise die gewünschte Spendenaktion auf?
Ein unsichtbarer Wert erscheint in der URL
Das ist bei der Übergabe über URL-Parameter normal. Die Einstellung als unsichtbares Feld betrifft ausschließlich die Darstellung im Formular. Der Wert bleibt in der Browser-Adresszeile sichtbar.
Best Practices für vorausgefüllte Werte
- URL-Parameter für einzelne Kampagnen nutzen: So kannst Du gezielt Werte für bestimmte Spendenaktionen oder Kommunikationskanäle übergeben.
- Einbettungscode für Standardwerte verwenden: Wenn ein Wert in allen entsprechenden Formularen vorausgefüllt sein soll, ist die Übergabe über den Einbettungscode sinnvoll.
- Tracking-Werte eindeutig benennen: Verwende nachvollziehbare Werte wie
Facebook, damit Du Spenden später zuordnen kannst. - Formularaufrufe testen: Prüfe vor der Veröffentlichung, ob die gewünschten Werte korrekt übernommen werden.
- Keine vertraulichen Daten über URL-Parameter übergeben: Die Werte sind sichtbar und können bei veränderbaren Feldern angepasst werden.
War diese Antwort hilfreich? Ja Nein