Werte im Spendenaktions-Tool vorausfüllen

INHALTSVERZEICHNIS

• Gut zu wissen
• Unterschied Anmeldeformular und Spendenformular
• Parameter-Übergabe: URL
• Parameter-Übergabe: Nicht sichtbare Werte
• Parameter-Übergabe: Einbettungscode
  
  

In diesem Artikel erfahren Sie, wie Sie anhand von bestimmten Parametern verschiedene Werte an die Spendenaktionen-Formularen übergeben können, sowie einige Beispiele.

Gut zu wissen

• Es gibt bei den Spendenaktionen zwei Formulare (ein Anmeldeformular für Aktionsstarter und ein Spendenformular für deren Unterstützer), die anhand von Parametern vorausgefüllt werden können. 
• Grundsätzlich lassen sich alle abgefragte Informationen (inkl. unsichtbare Werte) in den Formularen entweder über die URL oder den Einbettungscode vorausfüllen.
• Eine genaue Liste der verfügbaren Parameter finden Sie unten anhand des entsprechenden Formulars.

Unterschied Anmeldeformular und Spendenformular

Da die Spendenaktionen unterschiedliche Formulare haben, sind die Unterschiede der Formularen und deren Parametern für evtl. Übergaben wichtig.

Anmeldeformular

• In diesem Formular werden die Daten der Aktionsstarter abgefragt.
• Dieses Formular hat grundsätzlich immer die gleiche URL (solange das Spendenaktion-Tool nicht auf eine andere Seite umgezogen wird). 
• Somit lässt sich über dieses Formular bestimmte Werte besser via URL übergeben, z. B. in dem einen eigenen Button mit Verlinkung auf die Anmeldeseite inkl. Parameterübergabe verwendet wird. 
• Eine Übersicht zu der Parameter für das Anmeldeformular finden Sie hier in unserem Developer-Zone.

Spendenformular

• In diesem Formular werden die Daten der Unterstützer/Spender abgefragt. 
• Dieses Formular hat pro Spendenaktion eine eigene URL. 
• D. h. die Übergabe via URL ist nur empfohlen, wenn man für eine bestimmte Aktion eine Kampagne oder Mailing macht. 
• Falls es gewünscht ist, dass bei allen Spendenformularen des Tools einen Wert, wie z. B. Betrag immer vorausgefüllt werden sollte, ist die Verwendung der Übergabe in den Einbettungscode empfohlen. 
• Eine Übersicht zu der Parameter für dieses Formular finden Sie hier sowie in unserem Developer-Zone.

Parameter-Übergabe: URL

• Die Vorauswahl direkt im URL hat den Vorteil, dass diese schnell und einfach auf eine bestimmte URL (z. B. für eine große Aktion) beschränkt werden kann.
• Da die Werte im URL jedoch sichtbar sind, können diese evtl. manuell vom Spender geändert werden.

1. Grundsätzlich müssen nur die Parameter inkl. gewünschten Wert an die entsprechenden URL (Anmeldeseite oder Spendenformular) angehängt werden. 
2. Im Gegensatz zu normalen Spendenformularen, haben die Formulare der Spendenaktionen bereits einige Parameter, die auf die jeweilige "Unterseite" des  iFrames verweisen (z. B. "?cfs=e" oder "?cfd=abcd#cff").
3. Damit die Werte problemlos übergeben werden können, empfehlen wir die Parameter   vor  diese Standard-Parameter von dem Formular zu platzieren. 
4. Unten finden Sie einige Beispiele, bei Aufruf der URLs können Sie die entsprechenden vorausgefüllten Werten sehen:

• Wert übergeben = https://international-action.org/de/anlassspende/spendenaktion/?goal=500&cfs=e
• Wert fix übergeben (im Formular nicht veränderbar) = https://international-action.org/de/anlassspende/spendenaktion/?fundraisingpage_custom_field_2207_fix=creative&cfs=e
• Mehrere Werte übergeben (wahlweise fix) = https://international-action.org/de/anlassspende/spendenaktion/?amount_fix=50&public_name=Max%20Mustermann&cfs=p&cfd=ttsil#cff

Parameter-Übergabe: Nicht sichtbare Werte

Sie können auch unsichtbare Werte in den Formularen, wie beispielsweise benutzerdefinierte Felder für das eigene Tracking oder Posten, vorausfüllen. 

1. Konfigurieren Sie erst einmal die Einstellungen Ihres Spendenaktions-Tools, dass die gewünschte Informationen (wahlweise unsichtbar) abgefragt werden.
2. Anhand des entsprechenden Parameters und die IDs der unsichtbaren Posten (für das Anmeldeformular) bzw. benutzerdefinierte Felder (für das Spendenformular) können diese nun im URL übergeben werden.

Parameter-Übergabe: Einbettungscode

• Die Vorauswahl in dem JavaScript-Einbettungscode hat den Vorteil, dass die Werte nicht im URL stehen.
• Diese bleiben ebenfalls standardmäßig vorausgefüllt, sodass bestimmte Werte stets vorbefüllt werden.
• Da Anmeldeformulare und Spendenformulare eindeutige Parameter haben, können beide Arten von Parametern in den Haupteinbettungscode hinterlegt werden.

1. Angenommen Sie möchten ein "Beispielziel" von 1000 € in das Anmeldeformular setzen und einen standardmäßigen Betrag von 20 € bei allen Spendenformularen anzeigen, können Sie diese anhand des Einbettungscodes standardmäßig vorausfüllen.
2. Hierfür müssen lediglich die Parameter mit den gewünschten Werten (Format: parameter=wert&) an der richtigen Stelle ergänzt werden. 
3. Die Parameter für Spendenziel ist "goal", die Parameter für Betrag ist "amount" und beide nehmen Zahlen als Werte.
4. "goal=1000&amount=20&" muss entsprechend in den Einbettungscode wie folgt eingefügt werden: 

<!-- 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 -->