🇬🇧 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 des Plugins 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.
...
Table of Contents | ||
---|---|---|
|
Installation
Das Plugin 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 des Plugins der App ein Backup der Newsletter-Abonnenten in Shopware und in Evalanche anzulegen.
Nach der erfolgreichen Installation und Aktivierung bietet das Plugin die App zwei Konfigurationsbereiche:
Die “Konfiguration” zum Konfigurieren der Schnittstelle sowie das “Feldmatching” zum matchen der Shopware mit den Evalanche Datenfelder.
...
Neben der Versionsinformation des Plugins der App gelangt man über das kleine Menü zur Konfiguration der Schnittstelle.
...
Evalanche Basiskonfiguration
Hostname
Die URL Ihrer der Evalanche-Instanz. In den meisten Fällen wird Ihre die Evalanche-Instanz über eine Subdomain bei SC-Networks erreichbar sein. Beispiel <meinEvalanche>.scnem.com
Benutzername
Tragen Sie hier bitte die ID eines 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
Geben Sie hier bitte das Passwort des Evalanche 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 wird als 'Interne ID' in den Evalanche Einstellungen im Unterpunkt Account angezeigt:
...
Objekt-Id des Mandanten
Geben Sie hier bitte die Objekt-ID des Mandanten ein. Bewegen Sie dazu den Mauszeiger Diese wird beim Bewegen des Mauszeigers in Evalanche in der linken Navigation auf den Mandanten-Namen angezeigt. Die Objekt-ID können Sie im URL, der unter der Navigation angezeigt wird, ablesensteht dort am Ende der angezeigten URL.
...
Pool-Id
Hier geben Sie bitte die ID des Pools an, in den die Shopware-Newsletter-Abonnenten importiert eingetragen werden sollen. Im Evalanche Backend finden Sie Die ID ist in Evalanche 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: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 Sie in Evalanche eine Mail für den Double-Opt-In eingerichtet haben und den der Double-Opt-In Prozess über Evalanche , statt über Shopware nutzen möchten, können Sie abgebildet werden soll, kann hier die ID dieser Mail eintragen.
Die ID finden Sie im Evalanche Backend unter eMailings:
...
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 können Sie festlegenkann definiert werden, welche Tracking Einstellung in Evalanche neue die neuen Newsletter-Abonnenten in Evalanche automatisch bekommen sollen. Das Tracking der Profile in Evalanche kann damit aktiviert oder deaktiviert werden.
Feldmatching
Das Plugin Die App benötigt für den Abgleich der Daten von Shopware zu Evalanche ein Matching der Felder. Das Matching wird bei der Installation des Plugins der App vorausgefüllt, kann jedoch beliebig angepasst werden.
Zum Feld Matching gelangt man über folgenden Weg über die Shopware Administration:
Einstellungen → Plugins Apps → Evalanche Konnektor
Das Matching wird pro Verkaufskanal vorgenommen und wir 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:
Attributname | Beschreibung der enthaltenen Daten |
ADDRESS | Adresse des Newsletter-Empfängers |
E-Mail-Adresse des Newsletter-Empfängers | |
SALUTATION | Anrede des Newsletter-Empfängers |
TITLE | Titel des Newsletter-Empfängers |
FIRSTNAME | Vorname des Newsletter-Empfängers |
NAME | Nachname des Newsletter-Empfängers |
COMPANY | Firma des Newsletter-Empfängers |
ZIPCODE | Postleitzahl des Newsletter-Empfängers |
CITY | Stadt des Newsletter-Empfängers |
COUNTRY | Land |
STATE
des Newsletter-Empfängers |
TELEPHONE |
Telefonnummer des Newsletter-Empfängers | |
LANGUAGE | Sprache |
SWSOURCE
des |
SWSTATUS
Newsletter- |
Empfängers | |
TRACKING_DISABLED | Tracking deaktiviert |
Attribute in Evalanche
Das Plugin Die App 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
SWDATEFIRSTREGSTR | Kundenregistrierungsdatum | ||
SWDATELASTLOGIN | Letzter Login | ||
SWDATELASTORDER | Letztes Bestelldatum | ||
SWCURCARTDATE | Datum letzter offener Warenkorb | ||
SWCURCARTVALUE | Wert letzter offener Warenkorb | ||
SWDATEOFBIRTH | Geburtsdatum | ||
SWCUSTOMERNUMBER | Kundennummer | ||
SWSALESNET | Umsatz Netto | ||
SWSALESGROSS | Umsatz Brutto | ||
SWORDERS | Anzahl Bestellung | ||
SWCUSTOMERGROUP | Kundengruppe |
Log-Dateien
Das Plugin 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 Debugzwecken 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