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.
Inhaltsverzeichnis
Installation
Das Plugin kann über den Shopware Store (store.shopware.com) heruntergeladen und in Shopware installiert werden. Es wird empfohlen, vor der Installation und der Einrichtung des Plugins ein Backup der Newsletter-Abonnenten in Shopware und in Evalanche anzulegen.
Nach der erfolgreichen Installation und Aktivierung bietet das Plugin zwei Konfigurationsbereiche:
Die “Konfiguration” zum Konfigurieren der Schnittstelle sowie das “Feldmatching” zum matchen der Shopware und Evalanche Datenfelder.
Konfiguration
Neben der Versionsinformation des Plugins gelangt man über das kleine Menü zur Konfiguration der Schnittstelle.
Die Konfiguration der Schnittstelle kann pro Verkaufskanal oder über alle Verkaufskanäle hinweg vorgenommen werden.
Evalanche Basiskonfiguration
Hostname
Die URL Ihrer Evalanche-Instanz. In den meisten Fällen wird Ihre Evalanche-Instanz über eine Subdomain bei SC-Networks erreichbar sein. Beispiel <meinEvalanche>.scnem.com
Benutzername
Tragen Sie hier bitte die ID eines für diese Zwecke eingerichteten 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
Geben Sie hier bitte das Passwort des API-Users ein.
Evalanche Mandanten Konfiguration
Mandanten Id
Bitte geben Sie hier die Mandatory-ID des Evalanche Mandanten ein, zu dem die Shopware-Newsletter-Abonnenten übertragen werden sollen. Die Mandatory-ID finden Sie als 'Interne ID' in den Evalanche Einstellungen im Unterpunkt Account:
Objekt-Id des Mandanten
Geben Sie hier bitte die Objekt-ID des Mandanten ein.
Bewegen Sie dazu den Mauszeiger in Evalanche in der linken Navigation auf den Mandanten-Namen. Die Objekt-ID können Sie im URL, der unter der Navigation angezeigt wird, ablesen.
Pool-Id
Hier geben Sie bitte die ID des Pools an, in den die Shopware-Newsletter-Abonnenten importiert werden sollen.
Im Evalanche Backend finden Sie in der linken Navigation unter dem Mandanten den Punkt 'Profile'. Hierunter befindet sich der Punkt 'Pool'. Wechseln Sie auf diese Seite, wird die Pool-ID rechts im Titel angegeben:
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 Sie in Evalanche eine Mail für den Double-Opt-In eingerichtet haben und den Double-Opt-In Prozess über Evalanche, statt über Shopware nutzen möchten, können Sie hier die ID dieser Mail eintragen.
Die ID finden Sie im Evalanche Backend unter eMailings:
Evalanche Tracking Konfiguration
Tracking Methode auswählen
Hier können Sie festlegen, welche Tracking Einstellung in Evalanche neue Newsletter-Abonnenten automatisch bekommen sollen. Das Tracking der Profile in Evalanche kann damit aktiviert oder deaktiviert werden.
Feldmatching
Das Plugin benötigt für den Abgleich der Daten von Shopware zu Evalanche ein Matching der Felder. Das Matching wird bei der Installation des Plugins vorausgefüllt, kann jedoch beliebig angepasst werden.
Zum Feld Matching gelangt man über folgenden Weg über die Administration:
Einstellungen → Plugins → Evalanche Konnektor
Das Matching wird pro Verkaufskanal vorgenommen und wir 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.
Folgende Datenfelder müssen gematcht werden:
Attributname | Beschreibung der enthaltenen Daten |
ADDRESS | Adresse |
E-Mail-Adresse | |
SALUTATION | Anrede |
TITLE | Titel |
FIRSTNAME | Vorname |
NAME | Nachname |
COMPANY | Firma |
ZIPCODE | Postleitzahl |
CITY | Stadt |
COUNTRY | Land |
STATE | Bundesland |
TELEPHONE | Telefon |
LANGUAGE | Sprache |
SWSOURCE | Name des Shopware Sales Channels aus dem die Anmeldung generiert wurde |
SWSTATUS | Status (Kunde und/oder Newsletter -Abonnent) |
TRACKING_DISABLED | Tracking deaktiviert |
Attribute in Evalanche
Das Plugin legt im konfigurierten Evalanche Pool folgende, neue Attribute an:
Attributname | Beschreibung | Datentyp | Datentyp-ID |
SWSOURCE | Name des Shopware Sales Channels aus dem die Anmeldung generiert wurde | Einzeilige Eingabe | 5 |
SWSTATUS | Status (Kunde und/oder Newsletter -Abonnent) | Mehrfach-Selektion | 8 |
SWDATEOFDOI | Shopware DOI-Mail-Datum | Datum mit Uhrzeit | 11 |
Log-Dateien
Das Plugin legt Log-Dateien im Standard Log Verzeichnis von Shopware an.
Diese beginnen im Namen mit “krme_evalanche_basic_dev- “ und können zu Debugzwecken dienen.
Darin enthalten sind Informationen zum Verbindungsstatus und den übertragenen Daten (neue oder upgedatete Newsletter-Profile).