Werte im Formular vorausfüllen

INHALTSVERZEICHNIS

• So funktioniert das Vorausfüllen von Formularen
• Übersicht aller verfügbaren Parameter
• Werte über die URL vorausfüllen
  • Regeln
  • Beispiel: Betrag vorausfüllen
  • Beispiel: Betrag fix vorausfüllen
  • Beispiel: Mehrere Werte gleichzeitig vorausfüllen
• Nicht sichtbare Werte vorausfüllen
  • Beispiel: Unsichtbaren Posten vorausfüllen
• Werte über den JavaScript-Einbettungscode vorausfüllen
  • Beispiel: Österreich als Land vorausfüllen
  • Beispiel: Österreich fix vorausfüllen
  • Beispiel: Geschenkspende vorab aktivieren
• Häufige Probleme
  • Der vorausgefüllte Wert kann geändert werden
  • Ein nicht sichtbarer Posten wird nicht übernommen
  • Der gewünschte Parameter ist nicht bekannt
• Best Practices für vorausgefüllte Werte

In diesem Artikel erfährst Du, wie Du bestimmte Werte in einem klassischen Spendenformular auf Deiner Website vorausfüllen lässt. Du erfährst außerdem, welche Parameter verfügbar sind und welche Variante sich für Deinen Anwendungsfall eignet.

So funktioniert das Vorausfüllen von Formularen

Grundsätzlich kannst Du alle Informationen vorausfüllen, die Dein Formular abfragt. Dafür stehen Dir zwei Möglichkeiten zur Verfügung:

• Übergabe über die URL: Du ergänzt die gewünschten Parameter an der URL der Seite, auf der Dein Formular eingebettet ist. Damit erzeugst Du eine erweiterte URL, die Du dann kommunizieren bzw. an einer gewünschten Stelle einfügen kannst.
• Übergabe über den JavaScript-Einbettungscode: Du ergänzt die Parameter direkt im Einbettungscode des Formulars.

Welche Variante sinnvoll ist, hängt von Deinem Anwendungsfall ab:

• Übergabe über die URL: URL-Parameter lassen sich schnell für unterschiedliche Kampagnen, Mailings oder Verlinkungen einsetzen.
  • Die übergebenen Werte sind in der URL sichtbar und können gegebenenfalls von Spender*innen verändert werden.
• Parameter im Einbettungscode sind nicht in der Adresszeile sichtbar.
  • Werte aus dem Einbettungscode werden bei jedem Aufruf des Formulars standardmäßig vorausgefüllt. Verwende diese Variante deshalb nur, wenn das für Deinen Anwendungsfall gewünscht ist.

Übersicht aller verfügbaren Parameter

Eine vollständige Übersicht der Parameter, die Du zum Vorausfüllen verwenden kannst, findest Du in unserer Developer-Zone:

https://developer.fundraisingbox.com/reference/form-prepopulation-api

Werte über die URL vorausfüllen

Für eine Vorauswahl über die URL ergänzt Du den gewünschten Parameter als Query-Parameter an der Seite, auf der Dein Spendenformular eingebettet ist.

In den folgenden Beispielen ist das Formular unter der fiktiven URL https://meine-demo-organisation.org/de/spenden eingebettet.

Regeln

1. Der erste Parameter wird durch ? von dem regulären URL Teil getrennt (prüfe, ob Deine Standard-URL schon ein ? beinhaltet, dann startest Du direkt mit &)
2. Alle weiteren Parameter werden mit & voneinander getrennt

Beispiel: Betrag vorausfüllen

Um beispielsweise einen Betrag von 50 vorauszufüllen (der Betrag kann im Formular dann noch verändert werden), ergänzt Du den Parameter amount:

https://meine-demo-organisation.org/de/spenden/?amount=50

Spender*innen können den vorausgefüllten Wert im Formular anschließend noch ändern.

Beispiel: Betrag fix vorausfüllen

Soll ein vorausgefüllter Wert im Formular nicht mehr verändert werden können, verwendest Du die entsprechende _fix-Variante des Parameters.

Für einen fix vorgegebenen Betrag von 100 lautet die URL Ergänzung beispielsweise:

https://meine-demo-organisation.org/spenden?amount_fix=100

Beispiel: Mehrere Werte gleichzeitig vorausfüllen

Du kannst problemlos mehrere Parameter miteinander kombinieren. Trenne sie dafür in der URL mit &.

Das folgende Beispiel übergibt mehrere Werte gleichzeitig und fixiert einen Teil davon:

https://meine-demo-organisation.org/de/spenden/?amount_fix=25&fb_item_id=20723&interval_fix=1&is_gift_donation=1

Nicht sichtbare Werte vorausfüllen

Du kannst auch Informationen übergeben, die im Formular selbst nicht sichtbar sind. Das eignet sich beispielsweise für benutzerdefinierte Felder, eigenes Tracking oder einen Posten, der ausschließlich über einen bestimmten Deep-Link aufgerufen werden soll.

So richtest Du einen nicht sichtbaren Wert ein:

1. Öffne in der FundraisingBox Formulare > Klassische Formulare.
   
2. Wähle das gewünschte Formular aus.
3. Konfiguriere das Formular so, dass die Information abgefragt wird, die Du später übergeben möchtest. Weitere Informationen findest Du im Artikel zum Konfigurieren und Einbetten von Formularen.
4. Deaktiviere bei dem entsprechenden benutzerdefinierten Feld oder Posten die Option sichtbar.
   Beispiel eines benutzerdef. Feldes:
   
5. Ermittle den benötigten Parameter und die ID des benutzerdefinierten Felds bzw. des Postens.
   • Die IDs von Posten findest Du unter anderem im Posten-Dropdown des Button-Generators.
   • Die IDs von benutzerdef. Feldern findest Du unter Konfiguration > benutzerdef. Felder (Spalte "ID" ganz rechts)
   • Die IDs von Projekten findest Du unter Konfiguration > Projekte (Spalte "ID" ganz rechts)
6. Übergib den Wert anschließend über die URL.

Beispiel: Unsichtbaren Posten vorausfüllen

Ein nicht sichtbarer Posten namens "Weihnachtsaktion" hat beispielsweise die ausgedachte ID 20720. Du kannst diesen Posten mit fb_item_id_fix fest vorauswählen:

https://meine-demo-organisation.org/de/spenden/?fb_item_id_fix=20720

Werte über den JavaScript-Einbettungscode vorausfüllen

Du kannst Parameter auch direkt im JavaScript-Einbettungscode des Formulars ergänzen. Die Werte erscheinen dann nicht in der Adresszeile und werden standardmäßig bei jedem Aufruf dieses eingebetteten Formulars vorausgewählt.

Füge den jeweiligen Parameter mit seinem Wert im Format parameter=wert& an der passenden Stelle im Einbettungscode Deiner Website ein.

Beispiel: Österreich als Land vorausfüllen

Wenn beispielsweise ein Großteil Deiner Spender*innen aus Österreich kommt, kannst Du Österreich standardmäßig als Land vorauswählen.

Dafür benötigst Du:

• den Parameter country
• den Länderwert AT für Österreich
  • Erklärung: Ländercodes müssen im Format ISO 3166-1 Alpha-2 angegeben werden.

Ergänze den Parameter country=AT& im Einbettungscode:

<script type="text/javascript" src="https://secure.fundraisingbox.com/app/paymentJS?country=AT&hash=XXXX"></script>

Sieht dann so im Formular aus (Beispiel):

Beispiel: Österreich fix vorausfüllen

Soll das vorausgewählte Land nicht geändert werden können, verwendest Du den Parameter country_fix:

<script type="text/javascript" src="https://secure.fundraisingbox.com/app/paymentJS?country_fix=AT&hash=XXXX"></script>

Sieht dann so im Formular aus (Beispiel):

Beispiel: Geschenkspende vorab aktivieren

Du kannst auch die Geschenkspende vorab aktivieren (es kann im Formular noch deaktiviert werden), beispielsweise für eine Weihnachtskampagne.

Verwende dafür den Parameter is_gift_donation=1:

<script type="text/javascript" src="https://secure.fundraisingbox.com/app/paymentJS?is_gift_donation=1&hash=XXXX"></script>

Sieht dann so im Formular aus (Beispiel):

Häufige Probleme

Der vorausgefüllte Wert kann geändert werden

Prüfe, ob Du die normale Variante eines Parameters verwendest. Wenn ein Wert nicht veränderbar sein soll, benötigst Du – sofern für diesen Parameter vorgesehen – die Variante mit _fix.

Ein nicht sichtbarer Posten wird nicht übernommen

Nicht sichtbare Posten müssen fix vorausgewählt werden. Verwende dafür den entsprechenden _fix-Parameter.

Der gewünschte Parameter ist nicht bekannt

Prüfe die Übersicht der vorausfüllbaren Parameter in der Developer-Zone. Dort findest Du die verfügbaren Parameter für die Formular-Vorausfüllung.

Best Practices für vorausgefüllte Werte

• Nutze URL-Parameter, wenn Du unterschiedliche Werte für Kampagnen, Links oder Zielgruppen übergeben möchtest.
• Verwende Parameter im Einbettungscode nur für Werte, die bei diesem Formular standardmäßig vorausgewählt sein sollen.
• Fixiere einen Wert nur, wenn Spender*innen ihn nicht selbst ändern sollen.
• Prüfe nach Änderungen immer, ob das Formular die gewünschten Werte korrekt übernimmt.