Fehlerbehebung

Die meisten Probleme lassen sich auf eine Handvoll Ursachen zurückführen. Sie sind hier danach geordnet, wie oft Händler darauf stoßen, und für jede gibt es eine Lösung.

„Ich habe alles verbunden, aber nichts synchronisiert sich“

Fast immer liegt es an einer von zwei Ursachen, und beide lassen sich schnell prüfen.

1. Der Cron läuft nicht. Die Synchronisierung erfolgt über eine Hintergrund-Warteschlange, ohne Cron wird also nichts gesendet und auf dem Bildschirm erscheint keine Fehlermeldung. Öffnen Sie im Admin die Registerkarte Queue Monitor (Marketing → Intuit Mailchimp → Dashboard): Wenn Pending immer weiter steigt und sich nie leert, ist der Cron die Ursache. Bitten Sie Ihren Hoster zu bestätigen, dass der Cron von Magento eingeplant ist; sobald er läuft, zeigt die Registerkarte Cron Monitor jeden Job in Grün.

2. Ihre Datenbank liegt unter der Mindestanforderung. Die Extension benötigt für die Hintergrund-Synchronisierung MySQL 8.0+ oder MariaDB 10.6+. Wenn der Cron läuft und sich Pending trotzdem nicht leert, prüfen Sie Ihre Datenbankversion und aktualisieren Sie sie, falls sie unter der Mindestanforderung liegt.

Installation oder Upgrade schlägt fehl (Fehler bei setup:upgrade oder di:compile)

Bei einer Installation mit Composer erzwingt Composer die Anforderungen für Sie (Magento 2.4.6+, PHP 8.1 bis 8.4, MySQL 8.0+ oder MariaDB 10.6+), eine klare Ablehnung bedeutet also, dass die Umgebung diese Mindestwerte erfüllen muss. Wenn Sie stattdessen aus einer ZIP-Datei installieren, installieren Sie zuerst das mitgelieferte PulseCore-Paket in app/code, sonst bricht di:compile mit einem Class-not-found-Fehler ab. setup:upgrade fügt einigen Kern-Tabellen Spalten hinzu, große Stores sollten es daher innerhalb eines Wartungsfensters ausführen. Wenn ein Compile nach einem Update fehlschlägt, wechseln Sie auf den neuesten Patch-Release und führen Sie setup:upgrade, di:compile und cache:flush erneut aus. Installation enthält die vollständige Anleitung.

Was die Statusbezeichnungen bedeuten

Jede Bestellung, jeder Kunde und jedes Produkt hat einen Status:

Status	Bedeutung	Müssen Sie handeln?
Synced	An Mailchimp gesendet	Nein
Up to date	Nichts hat sich geändert, es wurde also übersprungen	Nein
Pending	Wartet auf den nächsten Cron-Lauf	Stellen Sie nur sicher, dass der Cron läuft
Error	Ein kürzlicher Sendevorgang ist fehlgeschlagen; kann sich von selbst beheben	Schauen Sie in ein paar Minuten wieder nach
Action needed	Nach mehreren Versuchen endgültig fehlgeschlagen	Korrigieren Sie die Daten und klicken Sie dann in der Entity Queue auf Retry
Not supported	Einem Produkt mit benutzerdefiniertem Typ fehlt die SKU oder der Name; es wurde nichts gesendet	Ergänzen Sie SKU oder Name und synchronisieren Sie dann neu (siehe unten)
Not in Mailchimp	Nie gesendet; außerhalb des Synchronisierungsbereichs	Nur wenn Sie es erwartet haben (siehe unten)

Warum „Not in Mailchimp“? Das ist kein Fehler: Der Datensatz lag außerhalb des Synchronisierungsbereichs. Seine Store View ist nicht verbunden, er ist älter als Ihr Synchronisierungsfenster, oder es handelt sich um eine historische Bestellung außerhalb Ihrer Auswahl für bestätigten Umsatz. Standardmäßig bedeutet bestätigter Umsatz die Status processing, complete und closed: Diese Auswahl entscheidet, welche historischen Bestellungen importiert werden und welche Bestellungen zum Umsatz und zum Customer Lifetime Value zählen. Neue Bestellungen synchronisieren sich, sobald sie eingehen, und bleiben über jeden Statuswechsel hinweg aktuell.

Fehler „Invalid email“, aber ich finde diesen Kunden nicht

Mailchimp weist Adressen ab, die gefälscht oder fehlerhaft aussehen. Echte Gast-E-Mail-Adressen synchronisieren sich problemlos; nur ungültige werden bewusst ausgeschlossen. Um eine zu korrigieren, öffnen Sie die Bestellung, berichtigen Sie die Rechnungs-E-Mail-Adresse und speichern Sie (sie wird von selbst erneut in die Warteschlange gestellt). Auf Test-Stores tragen Beispieldaten oft Platzhalter-E-Mail-Adressen, die Mailchimp ablehnt; das ist zu erwarten und kein Fehler.

Verbindungsprobleme

• Ein Banner meldet „Mailchimp is disconnected“: Die Lösung liegt direkt in der Meldung. Das Banner trägt seine eigene Schaltfläche Reconnect to Mailchimp, und ein Klick stellt die Verbindung wieder her. Falls Sie einmal den tieferen Weg benötigen, öffnen Sie die Seite Mailchimp accounts (das Überlauf-Menü ⋯ in der Ops-Registerkartenleiste), wählen Sie dort Reconnect und bestätigen Sie anschließend, dass Ihre Store View noch auf die richtige Zielgruppe verweist.
• Der Header meldet „Not Connected“, nachdem ein Konto hinzugefügt wurde: Ein Konto hinzuzufügen und eine Store View zu verbinden sind zwei getrennte Schritte. Wechseln Sie den Scope auf eine Store View und wählen Sie dann Connect store.
• „Connect store“ zeigt keine Stores an: Entweder ist noch kein Konto verbunden, oder jeder Mailchimp-Store ist bereits mit einer anderen Store View verknüpft. Fügen Sie ein Konto hinzu oder erstellen Sie einen neuen Store in Mailchimp.
• Das Login-Popup wird nicht abgeschlossen: Lassen Sie Popups für Ihre Admin-Domain zu und stellen Sie sicher, dass Ihr Server Mailchimp über HTTPS erreichen kann.

„Es heißt, mein API-Schlüssel sei ungültig, aber der Schlüssel ist brandneu“

Prüfen Sie zuerst das Format: Ein Mailchimp-Schlüssel endet mit seinem Rechenzentrums-Suffix (zum Beispiel -us21), generieren Sie also einen frischen Schlüssel und fügen Sie ihn vollständig ein. Wenn der Schlüssel definitiv gültig ist, zeichnet das Log unter var/log jeden Validierungsaufruf mit maskiertem Schlüssel auf: Eine Zeile mit HTTP 401 bedeutet, dass Mailchimp den Schlüssel selbst abgelehnt hat, während ein Transportfehler ohne Status bedeutet, dass Ihr Server Mailchimp nicht erreichen konnte, bitten Sie Ihren Hoster also, ausgehendes HTTPS zu <dc>.api.mailchimp.com zuzulassen. Ein Schlüssel, der später ungültig wird, zeigt sich auf der Seite Mailchimp accounts: Die Statusanzeige des Kontos ändert sich innerhalb einer Stunde, und Update key behebt es direkt dort, ohne den Store zu trennen. Mailchimp-Konto verbinden beschreibt jeden Schritt.

Tags erscheinen nicht bei Kontakten

Kategorie-Tags werden ab dem Moment, in dem Sie sie aktivieren, auf jede synchronisierte Bestellung angewendet, und eine erneute Synchronisierung taggt auch Ihre Bestellhistorie: Tags werden nie dupliziert, ein erneutes Synchronisieren ist also immer sicher. Sie gehen an Käufer mit einem Kundenkonto; Gastkäufe reichern stattdessen die Zielgruppenfelder zu den Käufen an. Tags, Datenfelder und Segmentierung beschreibt, wie jedes Tag aufgebaut ist.

Kauffelder bei älteren Kontakten leer

Die Zielgruppenfelder zu den Käufen werden bei der ersten Synchronisierung eines Kontakts automatisch erstellt. Wenn sie bei Kontakten, die bereits in Ihrer Zielgruppe waren, leer sind, füllt Rebuild merge fields (oder eine erneute Synchronisierung) sie auf. Tags, Datenfelder und Segmentierung erklärt, was jedes Feld erfasst.

„Der Kampagnenumsatz von Mailchimp stimmt nicht mit meinem Store überein“

Ein plötzlicher Abfall auf 0 $ über alle Kampagnen hinweg bedeutet, dass keine Bestellungen mehr bei Mailchimp ankommen: Prüfen Sie zuerst den Queue Monitor und den Cron Monitor. Welche Bestellungen zählen, ist eine Einstellung: Order Statuses to Sync (Configuration → Ecommerce Sync) entscheidet, was zum Umsatz zählt, und Stornierungen werden mit auf null gesetzten Summen übertragen, sie blähen den Umsatz also nie auf. Dass eine Gutschrift der falschen Kampagne zugeordnet wird, ist bewusst ausgeschlossen: Die Extension weist einer Bestellung nie eine Kampagne zu; die Zuordnung erfolgt über das eigene Klick-Tracking von Mailchimp. Wenn die Zahlen trotzdem nicht übereinstimmen, misst jede Oberfläche einen anderen Ausschnitt, und Warum Ihre Zahlen von Mailchimp abweichen enthält die vollständige Aufschlüsselung.

Produkte sehen in Mailchimp falsch aus: fehlende Bilder, seltsame Preise, veraltete Angaben

Korrigieren Sie zuerst die Katalogdaten: Ein Produkt ohne Bild in der Base-Rolle synchronisiert sich ohne Bild, und der Preis stammt aus dem Store-View-Scope, den Sie bearbeiten. Übertragen Sie es dann erneut: Push Now auf der Mailchimp-Registerkarte des Produkts stellt es mit Echtzeit-Priorität erneut in die Warteschlange, und die Massenaktion Push to Mailchimp oder bin/magento mailchimp:resync senden immer, selbst wenn sich in Magento nichts geändert hat. Das Detail der Zeile in der Entity Queue zeigt genau die Payload, die gesendet wurde, prüfen Sie es also kurz nach dem Übertragen. Preise synchronisieren sich als Katalog-Endpreis ohne aufgeschlagene Steuern, und Mailchimp zeigt einen aktuellen Verkaufspreis pro Produkt, was zu erwarten ist. Geschenkkarten von Adobe Commerce tragen einen repräsentativen Preis (den kleinsten konfigurierten Betrag oder das Minimum des offenen Betrags), und ein Produkt mit benutzerdefiniertem Typ und Preis null greift auf 0.00 zurück. Bestellsummen und Positionspreise stammen immer aus den tatsächlich gezahlten Beträgen, eine Geschenkkarte mit offenem Betrag wird also mit genau dem Betrag ausgewiesen, den der Käufer gewählt hat. So funktioniert die Synchronisierung erklärt, was wann gesendet wird.

Zugeordnete Datenfelder kommen leer an oder werden nicht mehr aktualisiert

Benutzerdefinierte Zuordnungen befinden sich im Raster Data fields (Configuration → Contact Sync) und werden im Store-View-Scope bearbeitet, weil jede Store View auf ihre eigene Zielgruppe abbildet. Erstellen Sie das Zielgruppenfeld zuerst in Mailchimp: Das Dropdown listet nur Tags auf, die in dieser Zielgruppe existieren, ein Tippfehler kann also nie gespeichert werden. Das Speichern einer echten Änderung stellt jeden betroffenen Kontakt erneut in die Warteschlange, und Rebuild merge fields erzwingt dieselbe Aktualisierung, die auch Felder auffüllt, die bei Kontakten von vor der Zuordnung leer sind. Wenn ein Feld unbemerkt aufhört, sich zu aktualisieren, ist die übliche Ursache, dass sein Tag in Mailchimp gelöscht wurde: Erstellen Sie es dort neu oder leeren Sie die Zeile. Tags, Datenfelder und Segmentierung behandelt jedes Feld.

Gäste erscheinen nach dem Abbrechen von Warenkörben nicht

Mailchimp benötigt eine E-Mail-Adresse, um eine Erinnerung zu senden, und die Extension erfasst eine in dem Moment, in dem ein Gast sie irgendwo eingibt: im Checkout, in einem Newsletter-Feld oder beim Ankommen über einen Kampagnen-Link. Wenn Gast-Warenkörbe nicht auftauchen, bestätigen Sie, dass die Store View verbunden ist; ein Gast, der nirgendwo eine E-Mail-Adresse angegeben hat, kann nicht erinnert werden, und jeder andere Warenkorb läuft von selbst durch. Abgebrochene Warenkörbe zurückgewinnen zeigt den gesamten Weg.

„Meine Automatisierung für abgebrochene Warenkörbe versendet nie eine E-Mail“

Rückgewinnungs-E-Mails werden von Ihrer Mailchimp-Automatisierung versendet, nicht von der Extension, beginnen Sie also im Abandoned-Carts-Panel des Dashboards: Wenn Warenkörbe gezählt werden, aber nichts versendet wird, folgen Sie dem Link Set up automation des Panels, um die Automatisierung in Mailchimp fertigzustellen. Wenn Total Carts bei 0 bleibt, öffnen Sie den Cron Monitor (Warenkörbe laufen über die Boost-Lane) und den Queue Monitor und bestätigen Sie, dass diese Store View verbunden ist. Eine abgeschlossene Bestellung entfernt ihren Warenkorb sofort aus Mailchimp, Käufer erhalten also nie eine Erinnerung für etwas, das sie bereits gekauft haben, und Rückgewinnungs-Links für registrierte Kunden landen konzeptbedingt auf der Login-Seite. Abgebrochene Warenkörbe zurückgewinnen führt durch den gesamten Weg.

Der Pixel-Schalter lässt sich nicht einschalten

Der Schalter springt erst um, nachdem Mailchimp die Aktivierung bestätigt hat, wenn er also ausgeschaltet bleibt, sagt Ihnen das eigene Popup der Extension, warum, und nennt die betroffene Store View. Der häufige Fall sind zwei Store Views, die sich eine Webadresse teilen: Jedes Pixel lebt auf seiner eigenen Domain, eine der Views trägt es also. Verhaltensereignisse fließen für jede Store View unabhängig davon serverseitig weiter, Segmente und Customer Journeys funktionieren also weiterhin. Das Mailchimp-Pixel und Verhaltensereignisse enthält die Details.

Das Pixel ist aktiv, aber auf der Storefront wird nichts ausgelöst

Öffnen Sie die Storefront mit den Entwicklertools Ihres Browsers, und die Seite sagt Ihnen, welche von drei bekannten Verhaltensweisen Sie sehen. Wenn Ihr Cookie-Consent-Banner noch nicht akzeptiert wurde, wird das Pixel bewusst zurückgehalten: Akzeptieren Sie es, und das Skript wird innerhalb von etwa einer Sekunde eingefügt. Wenn die Konsole einen Content-Security-Policy-Verstoß mit chimpstatic.com oder mcjs.prd.a.intuit.com anzeigt, stammt die Blockade von einer CSP, die außerhalb von Magento gesetzt ist: Fügen Sie beide Hosts dort zu script-src und connect-src hinzu. Wenn es eine Inline-Script-Hash-Abweichung im Checkout ist, aktualisieren Sie die Extension: Jede Version liefert den aktuellen freigegebenen Hash mit. Serverseitige Ereignisse fließen unabhängig davon weiter, auf der Registerkarte Events Tracking. Das Mailchimp-Pixel und Verhaltensereignisse erklärt beide Hälften.

Die Abonnieren-Checkbox wird nicht angezeigt

Drei schnelle Prüfungen: Leeren Sie den Magento-Cache; sehen Sie nach, ob das Pixel auf dieser Store View aktiv ist (die Checkbox im Checkout tritt bewusst zur Seite, damit die Bestätigungsseite keine sich überschneidenden Aufforderungen trägt); und bestätigen Sie, dass Sync Newsletter Subscribers in den Contact-Sync-Einstellungen aktiviert ist, denn das ist es, was die Opt-in-Oberflächen verfügbar macht. Zielgruppe vergrößern behandelt beide Checkboxen.

In Mailchimp vorgenommene Abbestellungen erreichen Magento nicht

Webhooks registrieren sich während Go Live selbst, beginnen Sie also an der Prüfoberfläche: Öffnen Sie Webhooks aus dem Ops-Menü, klicken Sie auf Check Webhooks und wählen Sie die Store View. Ein gesunder Store zeigt „Webhooks are active“; bietet er stattdessen Register an, klicken Sie darauf (oder Re-register, falls sich Ihre Store-URL geändert hat). Wenn die Registrierung fehlschlägt, erklärt das Fenster warum, und der häufige Fall ist, dass Mailchimp Ihre Store-URL nicht erreichen kann (Firewall, Wartungsmodus oder eine passwortgeschützte Staging-Seite): Machen Sie sie öffentlich erreichbar und registrieren Sie erneut. Abbestellungen greifen in dem Moment, in dem sie eintreffen; Profiländerungen benötigen zusätzlich Sync Newsletter Subscribers aktiviert. Abbestellungen und Einwilligung behandelt den beidseitigen Ablauf.

Bestätigungs-E-Mails kommen doppelt an, oder Abonnenten bleiben auf „pending“

Behandeln Sie den Schalter Double Opt-In der Extension (Configuration → Contact Sync) als den einzigen Regler für die Bestätigung: Ist er aktiviert, sendet Mailchimp die eine Bestätigungs-E-Mail und übernimmt den Bestätigungsschritt. Lassen Sie die Einstellung „Need to Confirm“ des Magento-eigenen Newsletters deaktiviert, sofern Sie nicht bewusst eine zweite Bestätigungs-E-Mail möchten: Sind beide aktiviert, erhalten Abonnenten zwei E-Mails und bleiben auf „pending“, bis sie den Link von Mailchimp anklicken. Wenn ein Kunde erneut abonniert, aber nie wieder auftaucht, zeigt das API Log den compliance-gesperrten Eintrag: Mailchimp schützt Kontakte, die über einen Kampagnen-Link abbestellt haben, und diese treten über ein von Mailchimp gehostetes Registrierungsformular wieder bei. Abbestellungen und Einwilligung erklärt die Einwilligung in beide Richtungen.

Wir haben die Domain gewechselt und die Synchronisierung pausierte

Sie pausierte bewusst: Das ist der Schutz, der verhindert, dass ein umgezogener oder geklonter Store an die falsche Stelle schreibt. Wenn sich die Adresse Ihres Stores ändert, nach einem Domainwechsel, einem Serverumzug oder einer kopierten Umgebung, pausiert die Extension diese Store View, und ein Admin-Banner erklärt, was passiert ist. Trennen Sie die Store View und verbinden Sie sie neu, dann wird die Synchronisierung fortgesetzt; Mailchimp-Konto verbinden führt durch die Verbindungsschritte.

Ein Banner meldet, unser verknüpfter Mailchimp-Store sei in Mailchimp gelöscht worden

Es geht nichts verloren: Die Synchronisierung schreibt nie gegen einen fehlenden Store, und in die Warteschlange gestellte Änderungen warten sicher auf Pending. Stellen Sie entweder den Store auf der Mailchimp-Seite wieder her (eine stündliche Zustandsprüfung hebt die Pause von selbst auf), oder wechseln Sie unter Configuration auf die betroffene Store View, trennen Sie im Verbindungs-Popup und verbinden Sie über den Setup Wizard neu; die Daten synchronisieren sich automatisch neu. Wenn beim erneuten Verbinden bereits ein Mailchimp-Store auf derselben Domain existiert, bietet der Wizard an, ihn zu archivieren und einen frischen zu erstellen, wobei Ihre Zielgruppe unberührt bleibt. Ist alles verbunden und synchron? zeigt jedes Verbindungssignal an einem Ort.

Neue Aktivität synchronisiert sich, aber die Historie stockt (oder umgekehrt)

Boost und Backfill laufen jeweils in ihrer eigenen Cron-Gruppe, ein Hoster, der nur die Standardgruppe von Magento ausführt, startet also nur die Hälfte der Engine. Bitten Sie Ihren Hoster zu bestätigen, dass der Cron von Magento alle Gruppen ausführt; der Cron Monitor zeigt den Zustand jeder Gruppe, Sie sehen also genau, welche wartet. So arbeitet die Sync-Engine erklärt die beiden Lanes.

„Meine Zielgruppe ist viel größer als meine Abonnentenliste“ (Kontaktzahl und Abrechnung)

Das Kontaktvolumen ist konzeptbedingt begrenzt und wird vorab angezeigt, bevor irgendetwas synchronisiert wird: Der Setup Wizard zeigt eine Schätzung für das gewählte Verlaufsfenster (3, 12, 24, 36 oder 48 Monate oder alles), ein kürzeres Fenster begrenzt die Zahl also. Sync Customers synchronisiert immer nur Kunden, die eine Bestellung aufgegeben haben, nie Ihre gesamte Kundendatenbank, und Default Subscription Status for Synced Customers entscheidet, ob sie als abonniert oder nicht abonniert ankommen. Wenn die Zielgruppe bereits größer ist, als Sie möchten, archivieren Sie Kontakte in Mailchimp: Archivierte Kontakte werden nicht abgerechnet und kehren von selbst zurück, wenn der Käufer erneut kauft. So funktioniert die Synchronisierung erklärt genau, wer wann synchronisiert wird.

Eine Aktionsregel hängt auf „Action needed“

Bestätigen Sie zuerst, dass Sync Promo Rules & Codes und Enable Ecommerce Sync beide auf Yes stehen (Configuration → Ecommerce Sync). Wenn Mailchimp eine Regel ablehnt (ein Rabatt von null, fehlende Daten, ein fehlender Name), wartet nur diese Regel: Öffnen Sie die Registerkarte Entity Queue, filtern Sie Status nach „Action needed“ und lesen Sie die Status Message für den genauen Grund. Korrigieren Sie die Cart Price Rule in Magento und klicken Sie dann auf den Link Retry der Zeile: Die Regel allein erneut zu speichern belebt die Zeile nicht wieder. Alles andere synchronisiert sich weiter, während sie wartet. Die Synchronisierung im Blick behalten zeigt, wie Sie die Warteschlange lesen.

Ein Produkt zeigt „Not supported“ in der Entity Queue

Dieser gelbe Status erscheint nur für ein Produkt mit benutzerdefiniertem Typ (eine Geschenkkarte von Adobe Commerce oder ein Typ aus einer Drittanbieter-Extension), dem seine SKU oder sein Name fehlt: Es wurde nichts gesendet, und die Status Message nennt den Produkttyp. Produkte mit benutzerdefiniertem Typ, die eine SKU und einen Namen haben, synchronisieren sich automatisch mit einer bestmöglichen Payload, aufgezeichnet im API Log als generic_type_fallback. Ergänzen Sie die fehlende SKU oder den Namen und verwenden Sie dann Retry der Zeile in der Entity Queue (oder führen Sie Resync All Data über Manage Connection auf der Registerkarte Manage aus); erneutes Speichern allein leert die Zeile nicht. Eine Bestellung, die das Produkt enthält, parkt auf „Action needed“ und nennt ihre SKUs; sobald das reparierte Produkt synchronisiert wurde, verwenden Sie Retry in der Zeile der Bestellung. Neu synchronisieren und Kommandozeilen-Tools enthält die Details.

your-store.com/admin

Immer noch nicht weiter?

Öffnen Sie den Queue Monitor, finden Sie den Datensatz, der sich nicht synchronisiert, und lesen Sie den vollständigen Mailchimp-Fehler; er nennt meist die Lösung. Wenn Sie weiterhin blockiert sind, ist der ebizmarts-Support nur eine E-Mail entfernt: Fügen Sie Ihre Magento-Version, Datenbankversion, Extension-Version und einen Screenshot des Fehlers bei.