Brevo (Sendinblue)-Integration: Einrichtung und Hilfe

1. Laden Sie das mprbrevo-ZIP unter Modul > "Module Manager" hoch und installieren Sie es.
2. Klicken Sie auf "Configure", um Brevo-Einstellungen zu öffnen.
3. Geben Sie API-Schlüssel ein. Der Feldhinweis verweist auf "Brevo > Settings > SMTP & API".
4. Geben Sie eine optionale numerische "List ID" für abonnierte Kunden ein.
5. Geben Sie "Client Key (Tracker)" ein, wenn Sie Shop-Tracking wünschen. Der Hinweis verweist auf "Brevo > Automation > Settings > Tracking Code".
6. Prüfen Sie "Auto-subscribe New Customers", aktivieren Sie "Enable Brevo" und speichern Sie.
7. Testen Sie mit einem neuen Kunden mit Newsletter-Einwilligung und einer Kunden-Browsersitzung mit Marketing-Einwilligung.

Sie können "Auto-subscribe New Customers" ausschalten und das Tracking konfiguriert lassen. Es gibt keinen separaten Tracker-Schalter; ein leerer Tracker-Schlüssel verhindert seine Ausgabe. Der Hinweis auf erforderliche Einstellungen meldet fehlende Zugangsdaten.

Die Kontaktsynchronisierung beginnt beim Erstellen eines neuen Kundenkontos. Die Kontoerstellung allein meldet niemanden an: Der Kunde muss das Newsletter-Abonnement ausdrücklich wählen. Die Einwilligung in Partnerangebote zählt nicht als Newsletter-Erlaubnis.

Das Modul sendet eine Kontaktanfrage an:

https://api.brevo.com/v3/contacts

Bei einem berechtigten Kontakt folgt die Nutzlast dieser Struktur:

{
  "email": "customer@example.com",
  "attributes": {"FIRSTNAME": "Jane", "LASTNAME": "Customer"},
  "updateEnabled": true,
  "listIds": [12]
}

Wenn "List ID" leer ist, wird keine Listenzuweisung gesendet. Die Anfrage kann einen bestehenden Kontakt aktualisieren. In Brevo bereits abgemeldete oder gesperrte Kontakte bleiben gesperrt.

Synchronisierungsaufträge verwenden die gemeinsame Warteschlange. Das Modul versucht einen neuen Auftrag sofort auszuführen und kann fällige Aufträge wiederholen, wenn derselbe Kunde den Shop später angemeldet besucht. Vor dem Senden prüft es Newsletter-Status, Identität, Ziel, Widerruf der Einwilligung, Mitarbeiterstatus und Richtlinien für ausgehende Übertragungen erneut. Es gibt keine Cron-Aufgabe, die alle Kunden importiert.

Sie erhalten keinen historischen Kundenimport, keine separate Synchronisierung von Newsletter-Block-Anmeldungen, keinen SMS-Versand und keinen vom Modul verwalteten Double-Opt-in-Ablauf. Konfigurieren Sie diese Abläufe bei Bedarf separat.

Die Tracking-Skripte werden gegen Ende der Seite geladen. Die Kundenidentität wird privat abgerufen und ist von Seiten-Caches ausgeschlossen.

Das Modul prüft Marketing-Einwilligung, Erlaubnis zum Identitätsabgleich, Mitarbeiterausschlüsse und die Versandrichtlinien des Shops, bevor es Folgendes lädt:

https://sibautomation.com/sa.js?key=YOUR_CLIENT_KEY

Es erfasst Seitenaufrufe. Die Identifizierung per Kunden-E-Mail erfordert einen authentifizierten Kunden und passende Einwilligung.

Falls Sie ein Theme-Override benötigen, behalten Sie den Laufzeit-Bootstrap unter diesem Pfad bei:

themes/your_theme/modules/mprbrevo/views/templates/hook/tracker.tpl

Diese Integration ändert nicht den SMTP-Transport von PrestaShop und leitet Bestellbestätigungs-E-Mails nicht über Brevo.

• Erstellen Sie für die Kontaktsynchronisierung ein neues Konto mit ausgewähltem Newsletter-Abonnement. Prüfen Sie E-Mail, Vorname, Nachname und optionale Liste in Brevo.
• Wiederholen Sie dies ohne Newsletter-Einwilligung. Diese Registrierung darf nicht zur Newsletter-Synchronisierung zugelassen werden.
• Fehlt die Synchronisierung, prüfen Sie "Enable Brevo", API-Schlüssel, "Auto-subscribe New Customers", die numerische "List ID" und das Newsletter-Kennzeichen des Kunden.
• Verwenden Sie für Wiederholungen aus der Warteschlange die authentifizierte Sitzung des ursprünglichen Käufers. Prüfen Sie Verfügbarkeit und Diagnosen der gemeinsamen Warteschlange. Ein geänderter Schlüssel/eine geänderte Liste oder widerrufene Erlaubnis können einen Auftrag zurückhalten oder unterdrücken.
• Verwenden Sie für das Tracking einen neuen Kundenbrowser, erteilen Sie Marketing-Einwilligung und prüfen Sie die Anfrage sa.js. Die Identifizierung erfordert zusätzlich passende Erlaubnis.
• Prüfen Sie Browserblockaden, Mitarbeitermarkierungen und Netzwerkfehler des Anbieters, wenn Anfragen fehlen.
• Öffnen Sie "Integrity" für Prüfungen der Installation und gemeinsamen Infrastruktur.

Deaktivieren Sie "Auto-subscribe New Customers", um die Kontaktsynchronisierung zu stoppen. Deaktivieren Sie "Enable Brevo", um diese Integration zu stoppen. Speichern Sie die Änderung.

Deinstallieren Sie das Modul im "Module Manager", um Menü und Modulkonfiguration zu entfernen. Gemeinsam genutzte Tracking-Tabellen bleiben nach der Deinstallation erhalten. Sie löscht keine Kontakte oder Tracking-Datensätze, die bereits bei Brevo gespeichert sind.

Erfordert PrestaShop 1.6 oder neuer und PHP 7.1 oder neuer.