📖 Shopwerk Integrations-Handbuch DE

Diese Anleitung erklärt, wie Sie Ihr Shopwerk-System mit uptain verbinden und Newsletter-Anmeldungen sowie Abmeldungen automatisch zwischen Shopwerk und uptain synchronisieren.

🔗 Was die Integration macht

• Überträgt neue Newsletter-Abonnenten aus uptain automatisch an Shopwerk.

• Synchronisiert Abmeldungen aus uptain mit dem Shopwerk-System.

• Prüft, ob eine E-Mail-Adresse in Shopwerk oder uptain blockiert bzw. auf einer Blacklist hinterlegt ist und respektiert somit beide Blacklists.

• Verhindert doppelte Newsletter-Anmeldungen und erneute Gutschein- oder Newsletter-E-Mails an bereits registrierte oder abgemeldete End-User.

• Unterstützt die Übertragung zusätzlicher Felder wie Vorname, Nachname und Geschlecht.

• Prüft vor relevanten E-Mail-Versänden den aktuellen Blacklist-Status in Shopwerk.

• Unterstützt jeweils die Standart Newsletter-Liste con Shopwerk.

🛠️ Schritt 1: Anmeldung im Kunden-Frontend

1. Öffnen Sie Ihr Kunden-Frontend hier: uptain | Leading Cart Abandonment Software for E-Commerce

2. Navigieren Sie im Hauptmenü zu Integrationen.

🛠️ Schritt 2: Shopwerk-Integration hinzufügen

1. Scrollen Sie zu Neue Integration hinzufügen.

2. Klicken Sie auf die Shopwerk-Kachel.

3. Geben Sie die erforderlichen Shopwerk-Zugangsdaten ein:

   1. Ihren Shopwerk SYS_HASHNL Key.

   2. Die zugehörige Shopwerk Newsletter-URL.

4. Klicken Sie auf Verbinden bzw. Speichern.

5. uptain prüft anschließend automatisch die Verbindung zu Shopwerk.

Eine Shopwerk Newsletter-URL kann beispielsweise folgendermaßen aussehen:

https://ampv2.shopwerk.de/shop/system/?plugin=newsletter&action=formdo

👉 Bei erfolgreicher Verbindung wird die Shopwerk-Integration gespeichert und unter Meine Integrationen angezeigt.

👉 Falls die Verbindung nicht hergestellt werden kann, wird eine entsprechende Fehlermeldung angezeigt und die Zugangsdaten können korrigiert werden.

👉 Alle neuen, erfolgreich über Double Opt-in bestätigten Newsletter-Abonnenten werden automatisch an diese Shopwerk-Liste übertragen.

👉 Es gibt nur eine Liste bei Shopwerk, darum gibt es keine Möglichkeit eine Liste auszuwählen

🛠️ Schritt 3: Prüfung bestehender oder blockierter Abonnenten

Bevor einem End-User ein Newsletter-Formular angezeigt wird, prüft uptain automatisch den aktuellen Status der E-Mail-Adresse.

Dabei wird geprüft:

• ob die E-Mail-Adresse bereits in der ausgewählten Shopwerk Newsletter-Liste vorhanden ist,

• ob die E-Mail-Adresse in Shopwerk blockiert ist,

• ob für die E-Mail-Adresse bereits ein Newsletter-Abonnement oder Blacklist-Eintrag in uptain vorhanden ist.

👉 Sobald eine dieser Prüfungen ergibt, dass die E-Mail-Adresse bereits existiert oder blockiert ist, wird kein Newsletter-Formular angezeigt.

Vor dem Versand einer Double Opt-in E-Mail werden dieselben Prüfungen erneut durchgeführt.

👉 Ist der Kontakt bereits registriert, erhält der End-User die entsprechende Information für bereits vorhandene Abonnenten.

👉 Ist der Kontakt weder vorhanden noch blockiert, wird die Double Opt-in E-Mail versendet.

👉 Kann der Status aufgrund eines Shopwerk-API-Fehlers nicht zuverlässig geprüft werden, wird aus Sicherheitsgründen kein Newsletter-Popup beziehungsweise keine Double Opt-in E-Mail ausgespielt.

🛠️ Schritt 4: Newsletter-Abonnenten an Shopwerk übertragen

Nach erfolgreicher Bestätigung des Double Opt-ins überträgt uptain den neuen Abonnenten automatisch an Shopwerk.

Vor der Erstellung wird erneut geprüft, ob die E-Mail-Adresse bereits vorhanden ist.

👉 Es werden keine doppelten Newsletter-Kontakte angelegt.

👉 Blockierte E-Mail-Adressen werden nicht übertragen.

👉 Die E-Mail-Adresse ist für die Übertragung erforderlich.

Zusätzlich können folgende Informationen an Shopwerk übertragen werden:

👉 Falls für Ihren Account bereits ein uptain Webhook zur Übertragung von Newsletter-Abonnenten aktiv ist, wird die zusätzliche Shopwerk-Übertragung nicht ausgeführt.

🛠️ Schritt 5: Abmeldungen zwischen uptain und Shopwerk synchronisieren

Wenn eine E-Mail-Adresse in uptain abgemeldet oder auf die Blacklist gesetzt wird, sendet uptain automatisch ein entsprechendes Abmelde-Event an die Shopwerk API.

Dadurch wird die E-Mail-Adresse auch in Shopwerk als abgemeldet beziehungsweise blockiert behandelt.

👉 Die E-Mail-Adresse bleibt unabhängig vom Ergebnis der Shopwerk-Anfrage auch in uptain auf der Blacklist.

Zusätzlich prüft uptain vor relevanten E-Mail-Versänden den aktuellen Blacklist-Status in Shopwerk.

Dies betrifft unter anderem:

• Abandonment Mails (AM)

• Browse Abandonment Mails (BAM)

• Comeback Mails (CBM)

👉 Ist die E-Mail-Adresse in Shopwerk blockiert, wird keine entsprechende E-Mail versendet.

👉 Kann der Shopwerk-Status aufgrund eines API-Fehlers nicht geprüft werden, wird ebenfalls keine E-Mail versendet.

🛠️ Schritt 6: Integration entfernen

Falls Sie die Shopwerk-Integration nicht mehr verwenden möchten:

1. Öffnen Sie Integrationen → Meine Integrationen.

2. Suchen Sie Ihre Shopwerk-Integration.

3. Klicken Sie auf das Papierkorb-Symbol.

4. Bestätigen Sie die Löschung im angezeigten Dialog.

Nach der Bestätigung werden die gespeicherten Zugangsdaten entfernt und Shopwerk steht wieder unter Neue Integration hinzufügen zur Verfügung.

🎯 Zusammenfassung

• Aktivieren Sie Shopwerk über Integrationen → Shopwerk.

• Hinterlegen Sie Ihren Shopwerk SYS_HASHNL Key und die entsprechende Newsletter-URL.

• Wählen Sie die gewünschte Shopwerk Newsletter-Liste aus.

• uptain prüft automatisch, ob Newsletter-Kontakte bereits vorhanden oder blockiert sind.

• Neue Abonnenten werden nach erfolgreichem Double Opt-in automatisch an Shopwerk übertragen.

• Optional werden Vorname, Nachname und Geschlecht übertragen.

• Abmeldungen in uptain werden automatisch an Shopwerk weitergegeben.

• Der Shopwerk Blacklist-Status wird vor relevanten E-Mail-Versänden geprüft.

• Fertig! Der Newsletter- und Abmeldestatus bleibt automatisch zwischen uptain und Shopwerk synchronisiert.