FundraisingBox-Kontaktdaten in einen Brevo-Account übertragen

INHALTSVERZEICHNIS

• Gut zu wissen
• Voraussetzungen für die Nutzung der FundraisingBox-Schnittstelle zu Ihrem Brevo-Account
• Funktionsumfang der FundraisingBox-Brevo-Schnittstelle
• Double-Opt-In-Abfrage via FundraisingBox und Brevo
• Anpassungen der FundraisingBox-Brevo-Schnittstelle

In diesem Artikel erfahren Sie, wie die Kontaktdaten automatisiert in Ihren Brevo-Account übertragen werden können, die in Ihrer FundraisingBox-Instanz angelegt werden, wenn über eines Ihrer FundraisingBox-Spendenformulare von Spender*innen eine Transaktion getätigt wird.

Hinweis: Bei konkrekten Fragen, die sich ausschließlich auf Brevo selbst beziehen, sind das Brevo-Lösungsportal und das Brevo-Support-Team Ihre primären Informationsquellen.

Gut zu wissen

• Die FundraisingBox-Schnittstelle zu Ihrem Brevo-Account ist vollständing automatisiert; es ist nicht nötig und auch nicht möglich, den Prozess für die Datenübertragung manuell anzustoßen, anders als bei unserer CleverReach-Schnittstelle.
• Die FundraisingBox-Schnittstelle zu Ihrem Brevo-Account wird von uns einmalig für Sie eingerichtet und arbeitet von da an automatisch, sofern es von Ihrer Seite aus keine Änderungsanforderungen gibt; wenn Sie Interesse an der Nutzung der Schnittstelle haben, dann wenden Sie sich bitte über den "Jetzt mehr erfahren"-Knopf unter FundraisingBox > Store > Integrations > Marketing-Automation via Brevo an uns.
• Die FundraisingBox-Schnittstelle zu Ihrem Brevo-Account arbeitet unidirektional; es werden nur Daten von Ihrer FundraisingBox-Instanz an Ihren Brevo-Account übermittelt, aber es können keine Daten von Brevo in Ihre FundraisingBox-Instanz übertragen werden.
• Die FundraisingBox-Schnittstelle überträgt ab dem Zeitpunkt ihrer Aktivierung Daten an Ihren Brevo-Account; falls Sie historische Daten aus Ihrer FundraisingBox-Instanz oder einem anderen externen System in Ihren Brevo-Account importieren möchten, dann müssen Sie diese Daten zuerst im Quell-System exportieren.

Voraussetzungen für die Nutzung der FundraisingBox-Schnittstelle zu Ihrem Brevo-Account

• Brevo-Account erfolgreich registriert (kostenlose Brevo-Variante reicht gemäß des Stands von 09/2024 aus)
• Mindestens eine Kontakt-Liste in Brevo angelegt
• API-Key in Brevo erzeugt
• Listen-ID und API-Key sicher an uns übermittelt (bitte beides in einer Plain-Text-Datei speichern und diese Datei unter FundraisingBox > Account > Dateien abgesichert hochladen)
• Im Brevo-Account müssen bei den Einstellungen zu den Kontakten folgende Kontaktattribute als Attributfelder angelegt werden:

  Attributname	Attributart
  VORNAME	Text
  NACHNAME	Text
  ANREDE	Text
  TITEL	Text
  GEBURTSTAG	Datum
  SPENDENBETRAG	Zahl
  RHYTHMUS	Text
  SPENDENDATUM	Datum
  QUELLE	Text
  PROJEKT	Text
  EINZELSPENDE	Wahr/Falsch
  ANZAHL_SPENDEN	Zahl

• Einrichtung der Schnittstelle wurde von uns bestätigt.

Funktionsumfang der FundraisingBox-Brevo-Schnittstelle

• Eine Transaktion wird über eines Ihrer FundraisingBox-Spendenformulare ausgelöst.
• Diese Transaktion hat gewisse Datenpunkte, die Sie auch in den Transaktions-Details sehen können, wenn Sie diese im Transaktionen-Bereich öffnen.
• Wenn die spendende Person in Ihrem FundraisingBox-Spendenformular den Haken für den Informationswunsch setzt, dann werden die Daten der Transaktion an Ihren Brevo-Account übermittelt.
• In Brevo wird entweder ein neuer Kontakt mit den Datenpunkten der Transaktion angelegt oder ein bereits bestehender Kontakt entsprechend aktualisiert
• Konkret übertragen werden pro Transaktion die Datenpunkte aus der Liste oben und die E-Mail-Adresse der spendenden Person.
• Wichtig: Die Datenpunkte Spendenbetrag, Rhythmus, Spendendatum, Quelle, Projekt und Einzelspende beziehen sich immer auf die zuletzt von dieser Person getätigte FundraisingBox-Transaktion! Diese Datenpunkte werden also bei einer neuen Transaktion beim Brevo-Kontakt immer wieder überschrieben. Der Datenpunkt Anzahl_Spenden ist jedoch kumulativ und gibt beim Brevo-Kontakt die Spenden-Transaktionsanzahl wieder, die Sie entsprechend so auch in Ihrer FundraisingBox-Instanz finden würden.
• Die Datenpunkte für Anrede und Rhythmus werden als numerische FundraisingBox-ID übermittelt:
  • Anrede: 1 == "Herr", 2 == "Frau", 3 == "Divers", 4 == "Ehepaar" und 5 == "Familie"
  • Rhythmus: 0 == "einmalig", 1 == "monatlich", 3 == "vierteljährlich", 6 == "halbjährlich" und 12 == "jährlich"

Double-Opt-In-Abfrage via FundraisingBox und Brevo

• Standardmäßig wird über Brevo auch mit der FundraisingBox-Schnittstelle kein Double-Opt-In von Kontakten abgefragt.
• Auch wenn Sie bereits mit Ihrer FundraisingBox-Instanz über Ihre FundraisingBox-Spendenformulare mit Double-Opt-In-E-Mails die Zustimmung Ihrer Kontakte abfragen, wird dieser Datenpunkt nicht an Ihren Brevo-Account übermittelt! Der Grund dafür ist, dass der Datenpunkt für Double-Opt-In immer an einer einzelnen E-Mail-Adresse hängt, aber nicht an einem Kontakt oder einer Transaktion.
• Wenn Sie Double-Opt-In-Abfragen über Brevo für Kontakte auslösen wollen, die in Ihrem Brevo-Account aus Ihrer FundraisingBox-Instanz heraus angelegt wurden, dann müssen Sie uns dies entsprechend mitteilen, da wir dies dann im Hintergrund für Sie entsprechend konfigurieren müssen!

Anpassungen der FundraisingBox-Brevo-Schnittstelle

• Geringfügige Anpassungen der übermittelten Datenfelder können wir unter Umständen je nach Ressourcenlage auf Anfrage für Sie umsetzen.
• Bei umfangreichen Anpassungen bieten wir an, Sie mit unserem Partner Qmart in Verbindung zu setzen, der Sie hier unterstützen kann; erstellen Sie dafür bitte ein Support-Ticket.
• Bei strategischen Fragen zur Verwendung von Brevo wäre ebenfalls Qmart der Ansprechpartner, denen wir Ihnen empfehlen würden.