Evalanche Shopware 6 Konnektor

🇬🇧 English

Der Evalanche Konnektor für Shopware 6 stellt eine Verbindung zwischen der E-Mail-Marketing Software Evalanche (sc-networks.de) und dem Shopsystem Shopware 6 (shopware.com) her. Mithilfe der App werden Newsletter-Anmeldungen aus Shopware an Evalanche übertragen. Dabei kann der Double-Opt-In Prozess von Evalanche verwendet werden. Abmeldungen vom Newsletter werden bidirektional abgeglichen.

Inhaltsverzeichnis

Installation

Die App kann über den Shopware Store (store.shopware.com) heruntergeladen und in Shopware installiert werden. Es wird empfohlen, vor der Installation und der Einrichtung der App ein Backup der Newsletter-Abonnenten in Shopware und in Evalanche anzulegen.

Nach der erfolgreichen Installation und Aktivierung bietet die App zwei Konfigurationsbereiche:
Die “Konfiguration” zum Konfigurieren der Schnittstelle sowie das “Feldmatching” zum matchen der Shopware mit den Evalanche Datenfelder.

Konfiguration

Neben der Versionsinformation der App gelangt man über das kleine Menü zur Konfiguration der Schnittstelle.

Open

Die Konfiguration der Schnittstelle kann pro Verkaufskanal oder über alle Verkaufskanäle hinweg (Vererbung) vorgenommen werden.

Open

Evalanche Basiskonfiguration

Hostname

Die URL der Evalanche-Instanz. In den meisten Fällen wird die Evalanche-Instanz über eine Subdomain bei SC-Networks erreichbar sein. Beispiel <meinEvalanche>.scnem.com

Benutzername

Benutzername des für diese Zwecke eingerichteten Evalanche API-Users ein.

Die Rechte-Rolle des API-Users in Evalanche sollte im Bereich System alle Rechte der Bereiche Profile und Mailing sowie für Schnittstellen das Recht zum Aufruf der WebServices 2.0 beinhalten. Im Bereich Objekte werden alle Rechte gesetzt.

Passwort

Passwort des Evalanche API-Users.

Evalanche Mandanten Konfiguration

Mandanten Id

Mandatory-ID des Evalanche Mandanten, zu dem die Shopware-Newsletter-Abonnenten übertragen werden sollen. Die Mandatory-ID wird als 'Interne ID' in den Evalanche Einstellungen im Unterpunkt Account angezeigt:

Objekt-Id des Mandanten

Objekt-ID des Mandanten ein. Diese wird beim Bewegen des Mauszeigers in Evalanche in der linken Navigation auf den Mandanten-Namen angezeigt. Die Objekt-ID steht dort am Ende der angezeigten URL.

Pool-Id

ID des Pools, in den die Shopware-Newsletter-Abonnenten eingetragen werden sollen. Die ID ist in Evalanche in der linken Navigation unter dem Punkt 'Profile' zu finden. Hier den gewünschten Pool auswählen und die ID wird oben nebem dem Titel des Pools angezeigt.

Evalanche Double Opt-In Konfiguration

Double-Opt-In aktivieren

Wenn der Double-Opt-in Prozess für Anmeldungen zum Newsletter genutzt werden soll, kann dieser hier aktiviert werden.

Double-Opt-In Mail Id

Wenn der Double-Opt-In Prozess über Evalanche abgebildet werden soll, kann hier die ID der Double-Opt-In Mail hinterlegt werden. Die ID ist in Evalanche unter den eMailings zu finden:

Wichtig dabei zu beachten:
Shopware versendet standardmäßig, trotz hinterlegter Evalanche Double-Opt-In Mail, zusätzlich die eigene Double-Opt-In Mail.

Um das zu verhindern, müssen in den Shopeinstellungen folgende Business-Events deaktiviert werden:

• Newsletteranmeldung wurde bestätigt (newsletter.confirm)

• Newsletter wurde registriert (newsletter.register)

Evalanche Tracking Konfiguration

Tracking Methode auswählen

Hier kann definiert werden, welche Tracking Einstellung die neuen Newsletter-Abonnenten in Evalanche automatisch bekommen sollen. Das Tracking der Profile in Evalanche kann damit aktiviert oder deaktiviert werden.

Feldmatching

Die App benötigt für den Abgleich der Daten von Shopware zu Evalanche ein Matching der Felder. Das Matching wird bei der Installation der App vorausgefüllt, kann jedoch beliebig angepasst werden.

Zum Feld Matching gelangt man über folgenden Weg über die Shopware Administration:
Einstellungen → Apps → Evalanche Konnektor

Das Matching wird pro Verkaufskanal vorgenommen und wird nicht vererbt. Daher muss zum Matching zwingend ein Verkaufskanal gewählt werden. Dabei wird der Verbindungsstatus zu Evalanche geprüft und alle Felder aus Evalanche ausgelesen und zum matchen bereitgestellt.

Folgende Datenfelder müssen gematcht werden:

Attribute in Evalanche

Die App legt im konfigurierten Evalanche Pool folgende, neue Attribute an:

Log-Dateien

Die App legt Log-Dateien im Standard Log Verzeichnis von Shopware an.
Diese beginnen im Namen mit “krme_evalanche_basic_dev- “ und können zu Debug Zwecken dienen.
Darin enthalten sind Informationen zum Verbindungsstatus und den übertragenen Daten (neue oder upgedatete Newsletter-Profile).

Scheduled Tasks

Um einen regelmäßigen Abgleich zwischen Shopware und Evalanche zu gewährleisten, müssen die Shopware Scheduled Tasks aktiv sein:

https://docs.shopware.com/de/shopware-6-de/tutorials-und-faq/scheduled-tasks-anlegen