Ihr Wechsel vom alten zum neuen Shopware 6 Plugin

Mit der neuen Version unseres Shopware 6 Plugins bieten wir Ihnen eine noch bessere Performance und erweiterte Funktionen. Der Migrationsprozess läuft teilautomatisiert über ein Modal ab und dauert nur wenige Minuten.
In dieser Anleitung zeigen wir Ihnen Schritt für Schritt, wie Sie von Ihrer bisherigen Integration auf das neue Plugin wechseln.

• Voraussetzungen & Vorbereitung
• Neues Plugin installieren
• Migrationsmodal öffnen & Datenübernahme starten
• Abschluss & Funktionsprüfung
• Known Issues (Bekannte Einschränkungen)
• Häufig gestellte Fragen

Wichtiger Hinweis: 
Die alte Verbindung wird automatisch getrennt, sobald Sie im Migrationsmodal bei der automatischen Übernahme auf Einstellungen übernehmen klicken. Wenn Sie die manuelle Konfiguration Manuell einrichten wählen, passiert keine automatische Deaktivierung.

Voraussetzungen & Vorbereitung

Damit die Migration und die spätere Synchronisation reibungslos funktionieren, stellen Sie bitte vorab folgende Punkte sicher:

Neues Plugin installieren

1. Loggen Sie sich in Ihren Shopware Account ein und navigieren Sie zu Erweiterungen > Store.
2. Suchen Sie nach dem neuen CleverReach Plugin und klicken Sie auf Erweiterung installieren.
   
   

Migrationsmodal öffnen & Datenübernahme starten

1. Klicken Sie auf den Menüpunkt Meine Erweiterungen. Hier ist jetzt sowohl das alte als auch das neue CleverReach Plugin gelistet. Aktivieren Sie das neue Plugin über den Schieberegler.
   
   
2. Klicken Sie im Menü auf Marketing und wählen Sie das neue CleverReach Plugin aus.

3. Sobald Sie das neue Plugin zum ersten Mal öffnen, erkennt das System automatisch die bestehende Verbindung. Es erscheint ein Fenster (Modal) mit zwei Optionen:
   
   

   Automatische Übernahme (Empfohlen): Das Plugin übernimmt die bereits verknüpfte Empfängerliste direkt aus der altem Plugin.

   Wichtiger technischer Hinweis: Zudem wird in diesem Schritt die Verbindung des alten Plugins zu CleverReach automatisch getrennt und das Plugin in den Shopware Erweiterungen automatisch deaktiviert. Dies ist ein Sicherheitsmechanismus, um:

   • Doppelte Synchronisationen zu vermeiden.

   • Die Performance Ihres Shops zu schonen.

   • Im nächsten Schritt können die Sie dann unsere neue App mit Ihrem CleverReach Account verbinden.

   Manuelle Verbindung: Wählen Sie diese Option, falls Sie die Integration mit einem anderen CleverReach-Account verbinden möchten. Achtung: Hierbei wird die alte App nicht deaktiviert. Beachten Sie dabei bitte, dass dies zu Inkonsistenten Daten führen kann.

4. Wählen Sie im nächsten Schritt aus, welche Empfängerlisten Sie importieren möchten und klicken Sie auf Weiter.
   
   

5. Bei Schritt 3 der Migration gibt es eine große Auswahl an Importeinstellungen. 
   Wählen Sie aus, welche Kundengruppen importiert werden sollen, ob eine Bestellhistorie übertragen wird, ob ein Tag-Import stattfinden soll und ob Datenfelder zugeordnet werden sollen. 
   Klicken Sie abschließend auf Import starten.

   

   Hinweis: Der Import läuft im Hintergrund. Sie können den Tab wechseln oder in anderen Menüs weiterarbeiten. Bitte lassen Sie den Browser-Tab geöffnet, bis der Vorgang abgeschlossen ist.

Abschluss & Funktionsprüfung

Sobald die Migration abgeschlossen ist, erhalten Sie eine Bestätigung im Modal. Ihr neues Dashboard ist steht bereit und Sie können Ihre Integration zu CleverReach wieder vollumfänglich nutzen.

Hinweis: Das alte Plugin wurde automatisch deaktiviert. Sie können die alte Plugin-Version nun sicher aus Ihrem Shopware-Backend deinstallieren und löschen.

Verwendung von Tags
Das Format der Tags entspricht exakt der bisherigen Schnittstelle. Ihre bestehenden Segmente und Automationen funktionieren somit nahtlos weiter und erfordern keine Anpassungen.

Verwendung von Formularen
Die neue Integration nutzt unser aktuelles Formularmodul; alte Formulare werden nicht mehr unterstützt. Bitte erstellen Sie Ihr gewünschtes Formular direkt in CleverReach, um es anschließend über die Schnittstelle einzubinden.

Erstellung von Segmenten
Die Erstellung neuer Segmente direkt über die Integration ist vorerst nicht vorgesehen. Sie können Ihre bestehenden Segmente jedoch uneingeschränkt weiter nutzen: Da das Tag-Format unverändert bleibt, funktionieren alle Segmentierungen sowie die Filterung nach Datenfeldern wie gewohnt.

Verwendung von Automationen
Haben Sie bereits Automationen auf Tag-Basis eingerichtet? Diese laufen ohne manuelles Eingreifen weiter. Wir empfehlen lediglich eine kurze Überprüfung, um sicherzustellen, dass alle Trigger wie gewünscht auslösen.

• Problem/Thema	Ursache/Lösung
  Der CleverReach-Import hängt bei Passwortschutz (.htaccess)	Ursache: Auf passwortgeschützten Umgebungen (Basic Auth / Staging) lädt der Import unendlich (Infinite Spinner), da Hintergrundprozesse blockiert werden (401-Fehler). Lösung: Deaktivieren Sie den Passwortschutz temporär für den Import oder schalten Sie folgende API-Routen in Ihrer Serverkonfiguration frei: /api/crsw-on-prem-cleverreach/webhook/receiver  /api/crsw-on-prem-cleverreach/webhook/abandonedCart
  Die Synchronisierung startet nicht	Prüfen Sie: 1. Laufen die Message-Queue- Worker bzw. Admin-Worker? 2. Ist die CleverReach-Authentifizierung gültig? 3. Enthalten die Plugin-Logfiles Fehler?
  Die Synchronisierung bricht vor dem Abschluss ab	Prüfen Sie: 1. Die Warteschlange in der Message-Queue. 2. Die Plugin-Logdateien. 3. Die Gültigkeit der OAuth-Verbindung.
  Probleme bei großen Synchronisationen (ab ca. 50k Einträgen)	Ursache: Der Standardwert für das Query-Timeout liegt bei 3600 Sekunden (1 Stunde). Bei längerer Dauer greift ein Worker die Nachricht erneut auf. Lösung: Stellen Sie den Timeout des DSN-Transports redeliver_timeout auf einen höheren Wert ein (empfohlen: 8 Stunden): MESSENGER_TRANSPORT_DSN=doctrine://default?auto_setup=0&redeliver_timeout=28800
  E-Mails zu abgebrochenen Warenkörben werden nicht versendet.	Prüfen Sie: 1. Ist die CleverReach-Automation für „Abgebrochene Warenkörbe“ aktiviert? 2. Laufen die Worker für geplante Aufgaben (Scheduled Tasks)? 3. Weisen die Logs Webhook- oder Automationsfehler auf?
  E-Mails zu abgebrochenen Warenkörben werden leicht zeitversetzt versendet	Erklärung: Im Plugin läuft alle 15 Minuten ein geplanter Prüflauf (Scheduled Run) für neue abgebrochene Warenkörbe. Je nach Zeitintervall kann der Versand daher leicht verzögert erfolgen.
  Verknüpfte Gruppe darf in CleverReach nicht gelöscht werden	Erklärung: Der „Offline Mode“ zur automatischen Erkennung gelöschter Gruppen ist derzeit noch nicht integriert. Lösung: Löschen Sie die verknüpfte Empfängerliste nicht manuell in CleverReach.
  Alte Formulare funktionieren nach Plugin-Wechsel nicht mehr	Lösung: Beim Wechsel auf das neue Plugin müssen bisher eingebundene Formulare in den Shopware-Erlebniswelten manuell durch die neuen Formulare ersetzt werden.
  Bidirektionaler Sync von CleverReach Flow Forms zu Shopware	Lösung: Um die Synchronisation in beide Richtungen zu gewährleisten, muss das Flow Formular in CleverReach mit derselben Empfängerliste wie das Plugin konfiguriert werden.

• Frage	Antwort
  Kann ich einfach von der alten auf die neue Schnittstelle wechseln, ohne Daten zu verlieren?	Ja. Die Migration läuft über ein Modal teilautomatisiert ab und dauert nur wenige Minuten. Ihre bestehende Empfängerliste wird automatisch übernommen. In diesem Prozess wird auch automatisch, dass alte CleverReach Plugin deaktiviert. Nach der Auswahl der Empfängerliste können Sie weitere Daten für den Import individuell konfigurieren.
  Muss ich das alte Plugin vorher deinstallieren?	Nein. Lassen Sie das alte Plugin zunächst aktiv. Sobald der erste Schritt (Migrationsmodal) im neuen Plugin erfolgreich abgeschlossen ist, wird die alte Verbindung automatisch getrennt und das alte Plugin deaktiviert. Nach Sie den Import in der neuen Schnittstelle abgeschlossen haben, können Sie das alte Plugin deinstallieren.
  Welche Shopware-Version benötige ich für das neue Plugin?	Das Plugin unterstützt Shopware 6.6 und 6.7 sowie PHP 8.2 oder höher.
  Welche Daten werden bei der Migration übernommen?	Über das Migrationsmodal im neuen Plugin können Sie wählen, ob wir die Daten automatisch laden oder es manuell konfiguriert werden soll. Wenn Sie automatisch wählen, lesen wir die bisherige verbundene CleverReach Empfängerliste aus und hinterlegen diese im neuen Plugin. Sie können die Einstellung trotzdem noch ändern. Weiterhin können Sie in den weiteren Konfigurationsschritte weitere, neue Importoptionen (Bestelldaten, Tags, Datenfelder) individuell auswählen.
  Muss ich meine Newsletter-Anmeldeformulare neu einbinden?	Ja. Die neue Schnittstelle nutzt unser neues Formularmodul. Alte Formulare in Ihren Erlebniswelten funktionieren mit der neuen Schnittstelle nicht mehr und müssen durch neue Formulare ersetzt werden.
  Was passiert mit der Double-Opt-In-Bestätigung, wenn ich CleverReach nutze?	Wenn Sie die CleverReach Double-Opt-In-Funktion aktivieren, versendet CleverReach die Bestätigungsmail und die native Shopware-DOI-Mail wird unterdrückt. Der gesamte Bestätigungsprozess läuft dann über Ihr CleverReach Formular.
  Werden meine bestehenden Segmente und Automationen weiter funktionieren?	Ja. Das Tag-Format bleibt identisch zur alten Schnittstelle, daher funktionieren bestehende Segmente und tag-basierte Automationen ohne manuellen Eingriff weiter. Ein kurzer Funktionscheck nach der Migration wird empfohlen.
  Können mehrere Mitarbeiter mit unterschiedlichen Rechten auf die Integration zugreifen?	Ja. Über die Shopware-Rechteverwaltung lassen sich unterschiedliche Rollen vergeben: von reinem Lesezugriff (nur Ansicht von Dashboard/Logs) über Bearbeitungsrechte (Einstellungen ändern, Sync/Import auslösen) bis hin zu vollem Admin-Zugriff.
  Die Warenkorbabbrecher-E-Mail kommt nicht exakt zur eingestellten Zeit. Ist das normal?	Ja, das Plugin prüft alle 15 Minuten auf neue abgebrochene Warenkörbe, daher kann der Versand um bis zu diesem Zeitraum verzögert sein.
  Mein Shop ist passwortgeschützt (z. B. Staging-Umgebung) -> der Import hängt. Was tun?	Auf passwortgeschützten Umgebungen (Basic Auth) blockiert der Passwortschutz die Hintergrundprozesse des Imports (401-Fehler), wodurch dieser unendlich lädt. Geben Sie folgende zwei API-Routen in Ihrer .htaccess-Konfiguration frei (Whitelisting), oder deaktivieren Sie den Passwortschutz temporär für den Import: /api/crsw-on-prem-cleverreach/webhook/receiver /api/crsw-on-prem-cleverreach/webhook/abandonedCart

Hilfe & Support

Sollten Sie Fragen haben oder Hilfe benötigen, können Sie jederzeit gerne unser Service Team kontaktieren.