Mailchimp-Integration: Einrichtung und Hilfe

1. Laden Sie das mprmailchimp-ZIP unter Module > "Module Manager" hoch und installieren Sie es.
2. Klicken Sie auf "Configure", um Mailchimp-Einstellungen zu öffnen.
3. Geben Sie API-Schlüssel und Audience-/Listen-ID für die gewünschte Zielgruppe ein.
4. Wählen Sie "Opt-in Mode" und aktivieren Sie "Sync Opted-in New Customers", wenn Sie bei Kontoerstellung synchronisieren möchten.
5. Konfigurieren Sie das Connected-Site-Skript separat, wenn Sie Shop-Tracking wünschen.
6. Aktivieren Sie "Enable Mailchimp" und speichern Sie.
7. Erstellen Sie einen Testkunden, der ausdrücklich das Newsletter-Abonnement auswählt. Prüfen Sie das Mitglied in Mailchimp.

Das Suffix des API-Schlüssels wählt das Mailchimp-Rechenzentrum, zum Beispiel -us1. Kopieren Sie die Zielgruppenkennung aus den Einstellungen der betreffenden Zielgruppe. Fügen Sie keinen Zielgruppennamen in Audience-/Listen-ID ein.

Kundensynchronisierung und Connected-Site-Skript sind separate Funktionen. Für eine Synchronisierung ohne Shop-Tracking aktivieren Sie "Sync Opted-in New Customers" und deaktivieren Sie "Enable Connected Site Script".

Das Modul lauscht auf actionCustomerAccountAdd. Es prüft das Newsletter-Kennzeichen des Kunden, Mitarbeitermarkierungen und die Richtlinien für ausgehende Übertragungen, bevor es einen Synchronisierungsauftrag zulässt. Der Synchronisierungsschalter erteilt keine Einwilligung.

Die Anfrage verwendet einen stabilen Mitgliedsendpunkt:

PUT https://us1.api.mailchimp.com/3.0/lists/YOUR_LIST_ID/members/MD5_OF_LOWERCASE_EMAIL

Sie sendet email_address, FNAME und LNAME. Für ein neues Mitglied ist status_if_new im Single-Opt-in-Modus subscribed oder im Double-Opt-in-Modus pending. Das PUT erzwingt kein erneutes Abonnement eines bestehenden abgemeldeten Mitglieds.

Das Modul stellt die Kontaktsynchronisierung in die Warteschlange und versucht den neuen Auftrag sofort. Vor dem Senden prüft es erneut den aktuellen Kundenstatus, die Newsletter-Einwilligung, die Identität, das konfigurierte Ziel und den gespeicherten Opt-in-Modus. Fehlt der Opt-in-Datensatz oder hat sich das Ziel geändert, wird der Auftrag zurückgehalten.

Für Wiederholungen deklariert das Modul die optionale gemeinsame Cron-Aufgabe mailchimp_member_sync mit der Bezeichnung "Retry opted-in Mailchimp audience sync" und dem Zeitplan every:60. Sie ist standardmäßig deaktiviert und erfordert den bestehenden MPR-Cron-Runner des Shops. Dieses Modul enthält diesen Runner nicht. Aktivieren Sie die Aufgabe dort, wenn Sie geplante Wiederholungen benötigen. Es gibt keine modulspezifische öffentliche Wiederholungs-URL.

Es importiert keine alten Kunden gesammelt, abonniert keine separaten Newsletter-Block-Anmeldungen und verwaltet keine Mailchimp-Kampagnen, Tags, Segmente oder Journeys.

Kopieren Sie die Skript-URL aus Ihrem Mailchimp-Connected-Site-Snippet in "Connected Site Script URL". Fügen Sie nur die URL ein. Aktivieren Sie "Enable Connected Site Script" und speichern Sie. Das frühere generische Snippet .../users/mc.js ist nicht die aktuelle Konfiguration.

Das Modul startet über displayBeforeBodyClosingTag. Es verwendet Live-Prüfungen für Marketing-Einwilligung, Mitarbeiter und ausgehende Übertragungen mit einem privaten Konfigurationsendpunkt. Öffentliches Seiten-Markup enthält keine Kundennamen oder E-Mail-Adressen.

Testen Sie in einem neuen Kundenbrowser mit Marketing-Einwilligung. Prüfen Sie die Netzwerkanfragen auf Ihre genaue Connected-Site-URL. Das Modul selbst sendet keine Produkt-, Warenkorb- oder Kaufereignis-Nutzlasten.

Wenn Sie das Template überschreiben, behalten Sie seine öffentliche Konfiguration und Laufzeitskripte bei:

themes/your-theme/modules/mprmailchimp/views/templates/hook/tracking.tpl

• Neues Mitglied fehlt: Prüfen Sie "Enable Mailchimp", Zugangsdaten, "Sync Opted-in New Customers" und eine ausdrückliche Newsletter-Auswahl bei der Registrierung.
• Double-Opt-in-Test: Prüfen Sie auf ein ausstehendes Mitglied und den Mailchimp-Bestätigungsablauf, statt ein sofortiges Abonnement zu erwarten.
• Bestehender abgemeldeter Kontakt: Das Modul erzwingt kein erneutes Abonnement.
• Wiederholung zurückgehalten: Prüfen Sie Integrationsdiagnosen, aktuellen Newsletter-Status, Ziel und Opt-in-Modus. Stellen Sie sicher, dass der gemeinsame Warteschlangenspeicher verfügbar ist.
• Skript fehlt: Prüfen Sie die genaue Site-URL, den Skriptschalter, die Marketing-Einwilligung, Browserblockaden und Mitarbeitermarkierungen.
• Installationswarnung: Verwenden Sie die Modulseite "Integrity" für erforderliche Zugangsdaten und Prüfungen gemeinsamer Tabellen.

Hier ist keine Seite zur individuellen Zielgruppenverwaltung je Kunde implementiert. Verwalten Sie Kontaktstatus und Kampagnen in Mailchimp.

Deaktivieren Sie den Synchronisierungsschalter, um neue Kontaktsynchronisierungen zu stoppen. Deaktivieren Sie den Skriptschalter, um das Laden von Connected Site im Shop zu stoppen. Deaktivieren Sie "Enable Mailchimp" für beides.

Deinstallieren Sie das Modul im "Module Manager", um Menü und gespeicherte Modulkonfiguration zu entfernen. Gemeinsame Warteschlangen- und Einwilligungswiderrufsdaten bleiben nach der Deinstallation erhalten. Sie löscht keine bereits bei Mailchimp gespeicherten Kontakte.

Erfordert PrestaShop 1.6 oder neuer und PHP 7.1 oder neuer.