Individuelle Erfolgsseite nach einer Transaktion nutzen (z.B. für personalisiertes Danke und/oder Tracking)

INHALTSVERZEICHNIS

• Gut zu wissen
• Individuelle Erfolgsseite hinterlegen
• Platzhalter-Übersicht
• Parameter mit Platzhaltern in eigener Erfolgsseiten-URL übergeben
• Wichtige Hinweise

In diesem Artikel erfahren Sie, wie Sie eine individuelle Erfolgsseite verwenden sowie diese ggf. mit Parametern aus dem Formular ergänzen können, um Spendende auch auf Ihrer eigenen Dankes-Seite individuell ansprechen zu können. 

Gut zu wissen

• Standardmäßig werden Spender*innen nach einer Transaktion auf die URL des Spendenformulars zurückgeleitet und statt des Formulars erscheint an dieser Stelle die in den Einstellungen hinterlegte automatische Erfolgsnachricht.
• Die FundraisingBox bietet aber auch die Möglichkeit, dass Sie auf Ihrer Homepage eine komplett individuelle Dankesseite als Landingpage erstellen und das Formular auf diese weiterleiten lassen.
• Falls Sie gewisse Informationen von der Transaktion an die eigene Erfolgsseite übergeben möchten, um z. B. Spendende dort individuell anzusprechen und Tracking-Möglichkeiten zu realisieren, können Parameter mit Platzhaltern (Zusatzinformationen in der URL) ergänzt werden. Diese Informationen können bei Bedarf auf Ihrer Landingpage auch mit einem separaten Skript ausgewertet oder weiterverarbeitet werden.

Individuelle Erfolgsseite hinterlegen

1. Wählen Sie unter Formulare  Ihr gewünschtes Formular aus.
2. Klicken Sie rechts auf Erfolgsseite bzw. scrollen Sie nach unten zu diesem Bereich.
3. Wählen Sie individuelle Erfolgsseite aus.
4. Tragen in das Feld die URL zu Ihrer eigenen Dankesseite ein, z.B. https://www.musterorganisation.de/danke.html
5. Klicken Sie auf speichern.

Platzhalter-Übersicht

Ein Platzhalter ist ein internes Symbol, das später ersetzt wird. Beispiel: %amount% => Bedeutung: steht für einen Wert (z. B. 50). Platzhalter werden nach der Transaktion automatisch mit dem für die Transaktion passenden Wert ersetzt.

Damit Sie Ihre Spender*innen z.B. auch persönlich ansprechen und sich für die Transaktion bedanken können oder Tracking implementieren können, ist es möglich einige Platzhalter der FundraisingBox an die URL Ihrer Erfolgsseite anzuhängen.

Diese Platzhalter sind verfügbar:

• %salutation% (Anrede, nur bei Privat-Personen gefüllt)
• %title% (Titel, nur bei Privat-Personen gefüllt)
• %first_name% (Vorname, nur bei Privat-Personen gefüllt)
• %last_name% (Nachname, nur bei Privat-Personen gefüllt)
• %company_name% (Unternehmens-Name, nur bei Unternehmen gefüllt)
• %country% (Land als Länder-Code, z.B. DE)
• %email% (E-Mail-Adresse)
• %amount% (Betrag)
• %interval% (Rhythmus, Werte siehe Export-Beschreibung)
• %fb_transaction_id% (FB-T-ID = Transaktions-ID)
• %token% (Token der Transaktion, wird von der FundraisingBox vergeben, ist eindeutig)
• %is_gift_donation% (Angabe, ob eine Geschenkspende im Formular ausgewählt wurde, Werte sind 0 (= nein) und 1 (= ja)) 
  • Hinweis: Dieser Platzhalter setzt die Verwendung der Geschenkspende-Funktion im Formular voraus.
• %covered_fee_amount% (Betrag der Gebührenübernahme-Funktion, um welche die Spende erhöht wurde)
• %fb_project_id% (Projekt-ID, siehe Konfiguration > Projekte, letzte Spalte "ID")
• %fb_project_name% (Projekt-Name, siehe Konfiguration > Projekte)
• %fb_item_id% (Posten-ID, siehe auch Formular-Einstellung, Maus über das "i" halten in der Posten-Zeile oder Export von Transaktionen)
  
• %fb_item_name% (Posten-Name, siehe Formular-Einstellung "Beschreibung" unter Posten)
  
• %fb_type_id% (Zahlungsweisen-ID, siehe Payment > Zahlungsweisen, letzte Spalte "ID")
• %wants_newsletter% (das Kontakt-Feld "Möchte Newsletter", welches automatisch positiv belegt ist, wenn bei der Transaktion das Feld "Informationswunsch" ausgewählt wurde)
• %donation_custom_field_[ID]% (benutzerdef. Feld vom Typ "Transaktion")
• %person_custom_field_[ID]% (benutzerdef. Feld vom Typ "Kontakt")
• %project_promotion_code% (ID-Code für Projekt unter Konfiguration > ID-Codes)
• %type_promotion_code% (ID-Code für Zahlungsweisen)
• %source_promotion_code% (ID-Code für Quellen)
• nur speziell für für die Zahlungsweise Micropayment Vorkasse:
  • %prepay_pay_text% (der Verwendungszweck der bei der Vorkasse-Überweisung angegeben werden muss)
  • %prepay_due_date% (das Datum bis zu welchem die Vorkasse-Überweisung spätestens erfolgen muss)
  • %prepay_bank_name% (Name der Bank, auf welche überwiesen werden soll)
  • %prepay_iban% (die IBAN, auf welche überwiesen werden soll)
  • %prepay_bic% (der dazugehörige BIC)
• nur speziell für die Schweizer Zahlungsweise QR-Rechnung:
  • %qr_code_id%
  • %qr_code_signature%

Parameter mit Platzhaltern in eigener Erfolgsseiten-URL übergeben

Parameter sind zusätzliche Informationen, die an eine Webadresse (URL) angehängt werden. Sie können selbst festlegen, wie diese Informationen heißen (z. B. amount=). Die passenden Werte werden dann automatisch von der FundraisingBox eingesetzt - mithilfe von Platzhaltern (in diesem Beispiel passend wäre es %amount%).

Funktionsweise kurz erklärt (die Platzhalter werden ersetzt und in den Parameter als Wert eingefügt):

Vorher:

https://ihre-organisation.de/spenden/danke.html?betrag=%amount%

Nachher (echte Werte):

https://ihre-organisation.de/spenden/danke.html?betrag=50

Beispiele/Inspiration für Parameter-Benennungen:

https://www.musterorganisation.de/danke.html?betrag=%amount%&anrede=%salutation%&vorname=%first_name%&nachname=%last_name%

https://www.musterorganisation.de/danke.html?euro=%amount%&name=%first_name%%20%last_name%&posten=%fb_item_id%

https://www.musterorganisation.de/danke.html?amount=%amount%&tracking=%donation_custom_field_123%

Transaktion via REST-API für die Dankesseite:
https://www.musterorganisation.de/danke.html?token=%token%
Beispiel für QR-Rechnung:
https://www.musterorganisation.de/danke.html?qr_code_id=%qr_code_id%&qr_code_signature=%qr_code_signature%

Wichtige Hinweise

• Bei einer Unternehmenstransaktion ist nur %company_name% gesetzt, aber nicht %salutation%, %first_name% und %last_name%. 
• Die Projekt-IDs finden Sie unter Konfiguration > Projekte.
• Die IDs der Zahlungsweisen (fb_type_id) mit der die Transaktion bezahlt wurde:
  z.B.
  3 = PayPal
  8 = Manuelle SEPA-Lastschrift
  11 = EPS-Überweisung - nur in Österreich
  13 = Stripe Kreditkarte
  15 = Wikando Lastschrift
  16 = Apple Pay (via Stripe)
  17 = Google Pay (via Stripe)
  19 = PayPal Kreditkarte
  20 = TWINT (via Stripe) - nur in der Schweiz
  21 = QR-Rechnung - nur in der Schweiz
  Eine vollständige Type-ID-Übersicht finden Sie in unserer DeveloperZone unter "fb_type_id".
• Die Posten-IDs (fb_item_id) finden Sie im Button-Generator des gewünschten Formulars.
• Mögliche Interval-Werte: 0,1,3,6,12
• %country% beinhaltet den Ländercode der Hauptadresse der Person, z.B. "DE" für Deutschland.
• Die IDs Ihrer benutzerdefinierten Felder finden Sie unter Konfiguration > Benutzerdefinierte Felder.
• Diese Einstellung steht bei den Spendenaktionen nicht zur Verfügung.