Verbinden Sie Charitable mit Brevo (ehemals Sendinblue), damit Spender, die sich auf Ihren Spendenformularen anmelden, automatisch zu Ihrer Brevo-Kontaktliste hinzugefügt werden und ihre Daten den Brevo-Kontaktattributen zugeordnet werden. Verfügbar in der Charitable Newsletter Connect-Erweiterung, Version 2.4.0 und höher.
Beta: Die Brevo-Unterstützung befindet sich derzeit in der Beta-Phase. Sie kann sicher in der Produktion verwendet werden, und wir sammeln aktiv Feedback. Wenn etwas nicht wie erwartet funktioniert, werden die Details in Ihrem Charitable-Aktivitätsprotokoll (siehe Überwachung unten) erfasst.
Hauptmerkmale
- Fügen Sie Spender automatisch zu einer ausgewählten Brevo-Liste hinzu, wenn sie sich auf einem Spendenformular anmelden.
- Ordnen Sie Charitable-Spenderfelder Brevo-Kontaktattributen zu (Vorname, Nachname und Ihre eigenen benutzerdefinierten Attribute).
- Optionale Double-Opt-in-Funktion, damit ein Spender die Anmeldung per E-Mail bestätigt, bevor er abonniert wird.
- Legen Sie eine Standardliste für alle Kampagnen fest oder wählen Sie für jede Kampagne eine andere Liste.
- Vollständige DSGVO-Unterstützung: Spenderdatenexport und dauerhafte Löschung über die WordPress-Datenschutztools.
- Jeder Anmeldeversuch und jeder Fehler wird im Charitable-Aktivitätsprotokoll aufgezeichnet, um die Fehlerbehebung zu erleichtern.
Warum Brevo nutzen?
Jede Spende ist eine Chance, eine dauerhafte Beziehung aufzubauen, aber das geschieht nur, wenn Sie in Kontakt bleiben können. Brevo ist eine der beliebtesten E-Mail-Marketing- und CRM-Plattformen, insbesondere für gemeinnützige Organisationen in Europa. Mit dieser Integration fließen Spender, die sich anmelden, im Moment ihrer Spende direkt in Ihre Brevo-Zielgruppe ein, sodass Sie Dankessequenzen, Kampagnenaktualisierungen und Spendenaufrufe senden können, ohne eine einzige CSV-Datei exportieren oder importieren zu müssen.
Sehen Sie es in Aktion
Voraussetzungen
- Charitable Pro mit der Newsletter Connect-Erweiterung, Version 2.4.0 oder höher
- Ein Brevo-Konto
- Ein Brevo API v3-Schlüssel (nicht der SMTP-Schlüssel)
Erste Schritte
Finden Sie Ihren Brevo API-Schlüssel
- Melden Sie sich bei Ihrem Brevo-Konto an.
- Gehen Sie zu SMTP & API und öffnen Sie dann den Tab API-Schlüssel.
- Kopieren Sie Ihren API v3-Schlüssel. Dies ist der Schlüssel, der mit
xkeysib-beginnt. Verwenden Sie nicht den SMTP-Schlüssel.
Wenn Ihr Brevo-Konto über die Sicherheitsfunktion Autorisierte IP-Adressen verfügt, fügen Sie die Server-IP Ihrer Website in Brevo unter Sicherheit > Autorisierte IPs zur Zulassungsliste hinzu. Andernfalls lehnt Brevo API-Aufrufe von Ihrer Website mit einem 401-Fehler ab.
Brevo in Charitable verbinden
- Gehen Sie in Ihrem WordPress-Adminbereich zu Charitable > Einstellungen > Marketing > Newsletter.
- Suchen Sie Brevo in der Liste der Anbieter und klicken Sie auf Konfigurieren.
- Fügen Sie Ihren API v3-Schlüssel in das Feld API-Schlüssel ein und klicken Sie auf Änderungen speichern.
- Wenn der Schlüssel akzeptiert wird, erscheinen Ihre Brevo-Kontaktattribute in der Abonnentenfelder -Tabelle.
Nutzung
Ordnen Sie Ihre Abonnentenfelder zu
Die Abonnentenfelder -Tabelle listet die Attribute auf, die in Ihrem Brevo-Konto verfügbar sind. Wählen Sie für jedes Feld das Feld für Spenden, das es befüllen soll. Standardmäßig ordnet Charitable zu:
- E-Mail der E-Mail-Adresse des Spenders
- VORNAME dem Vornamen des Spenders
- NACHNAME dem Nachnamen des Spenders
Lassen Sie jedes Attribut auf den Bindestrich ( – ) gesetzt, wenn Sie keinen Wert dafür senden möchten.
Telefonnummerattribute: Brevo erfordert, dass SMS-, WhatsApp- und Festnetzattribute im internationalen Telefonformat vorliegen, z. B.
+14155550123. Brevo lehnt den gesamten Kontakt ab, wenn eine Telefonnummer ungültig ist. Lassen Sie diese daher nicht zugeordnet, es sei denn, Ihr Spendenformular erfasst Telefonnummern in diesem Format.
Wählen Sie eine Liste
Verwenden Sie auf dem Hauptbildschirm der Newsletter -Einstellungen die Option Standardliste , um die Brevo-Liste auszuwählen, der Spender standardmäßig beitreten. Sie können dies pro Kampagne in den Newsletter-Einstellungen der Kampagne überschreiben.
Wählen Sie, wie Spender sich anmelden
Verwenden Sie den Standard-Opt-in-Modus , um die Newsletter-Anmeldung auf Ihren Spendenformularen zu steuern:
- Opt-in-Kontrollkästchen, standardmäßig nicht aktiviert: Der Spender muss das Feld ankreuzen, um beizutreten.
- Opt-in-Kontrollkästchen, standardmäßig aktiviert: Das Feld ist vorausgewählt; der Spender kann es abwählen.
- Automatisches Opt-in: Jeder Spender wird abonniert, ohne dass ein Kontrollkästchen angezeigt wird.
Sie können auch die Beschriftung des Kontrollkästchens mit Standard-Opt-in-Beschriftung anpassen.
Double Opt-in aktivieren (optional)
Schalten Sie Double Opt-in ein, damit Brevo eine Bestätigungs-E-Mail sendet, bevor ein Spender zu Ihrer Liste hinzugefügt wird. Der Spender wird erst abonniert, nachdem er auf den Bestätigungslink geklickt hat. Wenn Double Opt-in aktiviert ist, wählen Sie die Brevo Double Opt-in-Vorlage und geben Sie eine Bestätigungs-Weiterleitungs-URL (wo der Spender nach der Bestätigung landet) ein.
Um dies zu verwenden, erstellen Sie zuerst eine Double Opt-in-Vorlage in Brevo. Wenn Charitable keine Vorlagen in Ihrem Konto findet, wird das Vorlagenfeld zu einem Textfeld, in das Sie die numerische Vorlagen-ID eingeben können.
Konfigurationsoptionen
Verbindung
| Einstellung | Typ | Standard | Beschreibung |
|---|---|---|---|
| API-Schlüssel | Text | leer | Ihr Brevo API v3 Schlüssel, von Brevo > SMTP & API > API-Schlüssel. |
Abonnentenfelder
| Einstellung | Typ | Standard | Beschreibung |
|---|---|---|---|
| Feldzuordnung | auswählen (pro Attribut) | E-Mail, VORNAME, NACHNAME vordefiniert zugeordnet | Ordnet jedes Brevo-Kontaktattribut einem Spendenfeld zu. |
Double Opt-in
| Einstellung | Typ | Standard | Beschreibung |
|---|---|---|---|
| Double Opt-in | Kontrollkästchen | aus | Sendet eine Brevo-Bestätigungs-E-Mail, bevor der Spender abonniert wird. |
| Double-Opt-in-Vorlage | Auswählen oder Text | leer | Die Brevo-Vorlage, die für die Bestätigungs-E-Mail verwendet wird. Fällt auf ein numerisches Vorlagen-ID-Feld zurück, wenn keine Vorlagen gefunden werden. |
| Bestätigungs-Weiterleitungs-URL | Text | leer | Wohin der Spender nach Bestätigung seines Abonnements weitergeleitet wird. |
Newsletter-Verhalten (Bildschirmeinstellungen für Newsletter)
| Einstellung | Typ | Standard | Beschreibung |
|---|---|---|---|
| Standardliste | auswählen | Wählen Sie eine Liste | Die Brevo-Liste, der Spender standardmäßig über alle Kampagnen hinweg beitreten. |
| Standard-Opt-in-Modus | auswählen | Opt-in-Kontrollkästchen, nicht aktiviert | Wie das Opt-in auf Spendenformularen erscheint. |
| Standard-Opt-in-Beschriftung | Text | Abonnieren Sie unseren Newsletter | Die Beschriftung neben dem Opt-in-Kontrollkästchen. |
DSGVO und Datenschutz
Brevo-Unterstützung integriert sich in die WordPress-Tools für personenbezogene Daten unter Tools > Persönliche Daten exportieren und Tools > Persönliche Daten löschen:
- Exportieren gibt die Brevo-Kontaktattribute des Spenders zurück.
- Löschen löscht den Kontakt des Spenders dauerhaft aus Brevo (ein Hard Delete, nicht nur eine Abmeldung).
Überwachung und Fehlerbehebung
Jeder Abonnementversuch wird im Charitable-Aktivitätsprotokoll unter Charitable > Tools > Protokolle aufgezeichnet. Filtern Sie nach der Quelle Brevo, um Erfolge und Fehler anzuzeigen, einschließlich der genauen Meldung, die Brevo zurückgegeben hat.
Der API-Schlüssel wird nicht akzeptiert (401-Fehler)
Stellen Sie sicher, dass Sie den API v3-Schlüssel (beginnt mit xkeysib-) und nicht den SMTP-Schlüssel verwendet haben. Wenn Ihr Brevo-Konto den API-Zugriff nach IP einschränkt, fügen Sie die Server-IP Ihrer Website zur Zulassungsliste der autorisierten IPs in Brevo hinzu. Der Protokolleintrag zeigt die genaue Meldung von Brevo an, einschließlich des Hinweises „unbekannte IP-Adresse“, wenn die IP die Ursache ist.
Ein Spender wurde nicht abonniert
Überprüfen Sie Charitable > Tools > Protokolle , gefiltert nach Brevo. Eine häufige Ursache ist eine Telefonnummer, die nicht im internationalen Format vorliegt und an das SMS-, WhatsApp- oder Festnetzattribut gesendet wird, was dazu führt, dass Brevo den gesamten Kontakt ablehnt. Entkoppeln Sie diese Attribute oder stellen Sie sicher, dass Ihr Formular Telefonnummern im +Ländercode-Format erfasst.
Double-Opt-in-E-Mails kommen nicht an
Stellen Sie sicher, dass Double Opt-in aktiviert ist, dass eine gültige Brevo-Vorlage und eine Bestätigungs-Weiterleitungs-URL festgelegt sind und dass die Vorlage in Ihrem Brevo-Konto vorhanden und aktiv ist. Denken Sie daran, dass ein Spender, der niemals auf den Bestätigungslink klickt, niemals zur Liste hinzugefügt wird, was das beabsichtigte Verhalten ist.
Listen sind veraltet
Charitable speichert Ihre Brevo-Listen im Cache. Verwenden Sie die Schaltfläche Listen synchronisieren neben Brevo auf dem Bildschirm Newsletter, um sie zu aktualisieren.
Entwicklerressourcen
Filter
charitable_newsletter_connect_brevo_subscriber_data— Filtern Sie die Daten, die beim Abonnieren eines Spenders an Brevo gesendet werden. Empfängt das Payload-Array, die Benutzerdaten und die Listen-ID.charitable_newsletter_connect_brevo_export_custom_field— Filtern Sie, ob ein bestimmtes Brevo-Attribut in einen DSGVO-Export personenbezogener Daten einbezogen wird.charitable_settings_fields_providers_provider_brevo— Filtern Sie die Brevo-Einstellungenfelder.charitable_newsletter_connect_providers— Registrieren oder ändern Sie die verfügbaren Newsletter-Anbieter.charitable_newsletter_connect_log_success— Geben Sie false zurück, um die Erfolgsmeldungen pro Spende zu unterdrücken, während Fehler weiterhin protokolliert werden.
Konstanten
CHARITABLE_DEBUG_NEWSLETTER— Definieren Sie dies als true, um detaillierte Anforderungs- und Antwortdetails in das Charitable-Protokoll zu schreiben. Der API-Schlüssel wird niemals protokolliert. Verwenden Sie dies nur zur kontrollierten Fehlersuche, da Debugging-Einträge Brevo-Antwortdaten enthalten können.
