Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

🇬🇧 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
indent15px

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.

...

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

...

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

EMAIL

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

Bundesland

des Newsletter-Empfängers

TELEPHONE

Telefon

Telefonnummer des Newsletter-Empfängers

LANGUAGE

Sprache

SWSOURCE

Name

des

Shopware Sales Channels aus dem die Anmeldung generiert wurde

SWSTATUS

Status (Kunde und/oder

Newsletter-

Abonnent)

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

11

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