Die Shopware 6-Erweiterung

35 min

Inhalt

1 Grundlagen und Installation

2 Anmeldung und Abmeldung einrichten

3 Transaktionsnachrichten konfigurieren

4 Fortgeschrittene Konfiguration

5 Fehlersuche

1 Grundlagen und Installation

1.1 Grundlagen

1.1.1 Allgemeines

Dieser Artikel richtet sich an Administratoren und Entwickler mit Administratorrechten in Shopware. Der Artikel liefert eine Übersicht über die Optimizely Campaign Erweiterung für Shopware 6. Mit der Shopware-Erweiterung können sich Ihre Kunden direkt in Ihrem Shop zu Ihrem Newsletter an- und abmelden. Die bei der Registrierung erhaltenen Kundendaten überträgt die Erweiterung von Shopware zu Optimizely Campaign, sodass Sie die Kontaktinformationen zur Personalisierung Ihrer Kampagnen verwenden können.

Sie erhalten die folgenden Funktionen für Shopware Professional, Professional Plus und Enterprise 6:

Newsletter-Anmeldung und -Abmeldung

Transaktions-Mails über die HTTP-API

Bis Shopware 6.3 werden Erweiterungen als Plugins bezeichnet, erst ab Shopware 6.4 heißen Sie in der Benutzeroberfläche Erweiterungen, zudem ändert sich der Navigationspfad zum Menü Erweiterungen. Diese Dokumentation orientiert sich an der neueren Version Shopware 6.4.

1.1.2 Vorbereitungen

Um die Erweiterung in Shopware einzurichten, wenden Sie sich an die Optimizely Kundenbetreuung und fordern Sie das Software-Paket der Erweiterung an. Übermitteln Sie dabei auch die Versionsnummer ihres Shopware-Systems. Die Struktur und Felder der Newsletter-Empfängerliste sind von der Shopware-Integration vorgegeben und können nicht individuell definiert werden.

Für Ihre Transaktionsnachrichten richtet Ihnen Optimizely eine gesonderte Transaktions-Empfängerliste ein, deren Struktur und Felder von Ihnen definiert werden können; bitte teilen Sie der Kundenbetreuung die gewünschte Struktur und die Namen der Felder mit.

Falls Sie mehrere Verkaufskanäle oder in mehreren Sprachen lokalisierte Shops betreiben, teilen Sie Optimizely die Anzahl der Shops mit, die Sie an Optimizely Campaign anbinden möchten (Siehe Fortgeschrittene Konfiguration).

Wenn Sie mehrere Shops integrieren, benötigen Sie in Optimizely Campaign ggf.:

getrennte Mandanten für die einzelnen Shops

einen gesonderten Mandanten für Ihre Transaktions-Mails

die Einrichtung einer empfängerlistenbasierten Newsletter-Abmeldung

1.1.3 Über Opt-In-ID und Autorisierungs-Code

Damit Shopware Empfänger und Feldwerte an Optimizely Campaign übertragen kann, müssen Sie in Shopware zwei Werte hinterlegen:

Die Opt-In-ID als Kennung des Opt-In-Vorgangs. Die Opt-In-ID finden Sie in der Optimizely Campaign Menüleiste unter Verwaltung > API-Übersicht > Opt-In-Prozesse.

Den Autorisierungs-Code Ihrer Empfängerliste in Optimizely Campaign, welche die Kundenbetreuung zur Anbindung Ihres Shops bereits in Ihrem Mandanten hinterlegt hat. Sie finden den Autorisierungs-Code in Optimizely Campaign unter Verwaltung > API-Übersicht > Empfängerlisten. Wählen Sie die Empfängerliste aus und klicken Sie auf Autorisierungs-Codes verwalten. Wenn für die gewählte Empfängerliste noch kein Autorisierungs-Code vorhanden ist, klicken Sie auf Autorisierungs-Code erstellen.

Achtung: Verwechseln Sie nicht die Empfängerliste für Ihre Newsletter-Empfänger mit der Transaktions-Empfängerliste für Ihre Transaktionsnachrichten. Die Kundenbetreuung richtet für den Versand von Newslettern und für den Versand von Transaktionsnachrichten (beispielsweise Bestellbestätigungen, Rechnungen usw.) zwei unterschiedliche Typen von Empfängerlisten für Sie ein.

1.2 Vorgehensweisen

1.2.1 Seite Meine Plugins aufrufen (bis 6.3)

Achtung: Im Folgenden wird in dieser Dokumentation immer die Rede von Meine Erweiterungen sein. Wenn Sie Shopware 6.3 oder älter verwenden, ist Meine Plugins gemeint. Details der beschriebenen Vorgehensweisen können abweichen.

Voraussetzungen: Sie sind in der Admin-Oberfläche von Shopware 6.3 oder älter eingeloggt.

Klicken Sie in der Menüleiste auf Einstellungen.

Klicken Sie im linken Bereich der Seite Einstellungen auf System.

Klicken Sie auf Plugins.

Falls erforderlich: Klicken Sie im linken Bereich der Seite auf Meine Plugins.

→ Sie sehen die Seite Meine Plugins.

1.2.2 Seite Meine Erweiterungen aufrufen (ab 6.4)

Voraussetzungen: Sie sind in der Admin-Oberfläche von Shopware 6.4 oder neuer eingeloggt.

Klicken Sie in der Menüleiste auf Erweiterungen. -> Untergeordnete Menüpunkte werden eingeblendet.

Klicken Sie auf Meine Erweiterungen.

→ Sie sehen die Seite Meine Erweiterungen.

1.2.3 Erweiterung installieren

Voraussetzungen: Sie haben von der Optimizely Kundenbetreuung die Erweiterung als .zip-Archiv erhalten. Sie sehen in Shopware die Seite Meine Erweiterungen.

Klicken Sie auf Erweiterung hochladen.

Wählen Sie das .zip-Archiv aus, das Sie von Optimizely erhalten haben. -> Wenn die Shopware-Erweiterung erfolgreich hochgeladen wurde, erscheint die Erweiterung Optimizely Campaign in der Liste Meine Erweiterungen.

Klicken Sie in der Liste der Erweiterungen in der Zeile Optimizely Campaign auf … -> Das Kontextmenü öffnet sich.

Klicken Sie auf Installieren. -> Nach erfolgreicher Installation ist die Erweiterung noch deaktiviert.

Um die Erweiterung zu aktivieren, klicken Sie auf

(Umschalter) links in der Zeile.

→ Die Erweiterung ist installiert und aktiviert.

1.2.4 Erweiterung deinstallieren

Voraussetzungen: Sie sehen in Shopware die Seite Meine Erweiterungen.

Klicken Sie in der Liste der Erweiterungen in der Zeile Optimizely Campaign auf … -> Das Kontextmenü öffnet sich.

Klicken Sie auf Deinstallieren.

Bestätigen Sie die Aktion.

→ Die Erweiterung wird deinstalliert.

1.2.5 Update installieren

Voraussetzungen: Sie haben von der Optimizely Kundenbetreuung eine aktualisierte Version der Shopware-Erweiterung erhalten.

Deinstallieren Sie die alte Version (siehe Erweiterung deinstallieren).

Installieren Sie die neue Version (siehe Erweiterung installieren).

2 Anmeldung und Abmeldung Einrichten

2.1 Grundlagen

2.1.1 Allgemeines

Um die An- und Abmeldung zu konfigurieren, sind folgende Aufgaben zu erledigen:

Konfigurieren Sie die Opt-In-Nachricht (die Anmeldebestätigung) in Optimizely Campaign und referenzieren Sie den Bestätigungs-Link mithilfe einer Feldfunktion auf Ihren Shop.

Hinterlegen Sie die Opt-In-ID und den Autorisierungs-Code in Shopware.

Aktivieren Sie in Shopware die Nutzung des Double-Opt-In-Verfahrens.

Binden Sie ein Anmeldeformular in Ihrem Shop ein.

Wie Sie mehrere Shops oder lokalisierte Sprachfassungen Ihres Shops betreiben und konfigurieren, finden Sie unter Fortgeschrittene Konfiguration.

2.2 Vorgehensweise

2.2.1 Opt-In-Nachricht in Optimizely Campaign einrichten

Kontext: Die Opt-In-Nachricht wird so eingerichtet, dass ein Klick auf den Link Daten an Shopware sendet. Shopware identifiziert anhand des Parameters hash den Kunden und anhand der Parameter shop-id und shop den Shop/Subshop.

Voraussetzungen: Sie sind in Optimizely Campaign angemeldet.

Wählen Sie in der Menüleiste Kampagnen > Opt-In-Prozesse.

Wählen Sie den Opt-In-Prozess aus, den Sie zur Anbindung Ihres Shops verwenden möchten, und klicken Sie auf Bearbeiten…

Klicken Sie am Nachrichtenknoten auf Eigenschaften.

Klicken Sie auf Inhalt bearbeiten… → Der E-Mail-Editor öffnet sich.

Klicken Sie auf den Namen des Paragraphen, der den Anmeldebestätigungs-Link enthält. → Der Inhalt des Paragraphen wird im rechten Bereich angezeigt.

Klicken Sie im Bereich Text auf Quellcode.

Ersetzen Sie den enthaltenen Link durch die folgende Code-Zeile/Feldfunktion:

{Double-Opt-In-Link}?hash={customer-id}&shop-id={shop-id}&shop={shop}

Sie finden den zu ersetzenden Link im <a>-Tag zwischen den Anführungszeichen. Beispiel: Im Quellcode ist der folgende Link im <a>-Tag enthalten:

<a href="http://srv2.de/subscribe.html">Anmeldung abschließen</a>

Ersetzen Sie den blau markierten Link zwischen den Anführungszeichen folgendermaßen:

<a href="{Double-Opt-In-Link}?hash={customer-id}&shop-id={shop-id}&shop={shop}">
Anmeldung abschließen</a>

Klicken Sie auf Übernehmen > Schließen > Speichern und schließen.

2.2.2 Opt-In-ID und Autorisierungs-Code in Shopware hinterlegen

Kontext: Siehe auch Über Opt-In-ID und Autorisierungs-Code.

Voraussetzungen: Sie sehen in Shopware die Seite Meine Erweiterungen.

Klicken Sie in der Liste der Erweiterungen in der Zeile Optimizely Campaign auf … -> Das Kontextmenü öffnet sich.

Klicken Sie auf Konfiguration.

Geben Sie im Bereich Allgemeine Einstellungen im Feld Opt-In Id die Opt-In-ID ein.

Geben Sie im Feld Autorisierungs-Code den Autorisierungs-Code Ihrer Empfängerliste ein.

Klicken Sie auf Speichern.

2.2.3 Double-Opt-In-Verfahren aktivieren

Voraussetzungen: Sie sind in der Admin-Oberfläche von Shopware eingeloggt.

Wählen Sie in der Menüleiste Einstellungen > Business-Events.

Finden Sie in der Liste das Event Newsletteranmeldung wurde registriert.

Klicken Sie in der Zeile des Events auf … → Das Kontextmenü öffnet sich.

Klicken Sie im Kontextmenü auf Bearbeiten.

Klicken Sie auf

(Umschalter) mit der Beschriftung Aktiv. → Der Umschalter ist im Zustand an (

).

Klicken Sie auf Speichern.

Tipp: Um angemeldete Newsletter-Empfänger anzuzeigen, wählen Sie Marketing > Newsletter-Empfänger.

2.2.4 Anmeldeformular einbinden

Kontext: Die Shopware-Erweiterung nutzt Shopwares Standardformulare für die Registrierung von Newsletter-Anmeldungen. Sie können das Anmeldeformular in eine beliebige Shop-Seite einbinden.

Voraussetzungen: Sie sind in der Admin-Oberfläche von Shopware eingeloggt.

Wählen Sie in der Menüleiste Kataloge > Kategorien.

Wählen Sie die Shop-Seite aus, der Sie ein Anmeldeformular hinzufügen möchten.

Wechseln Sie zum Reiter Layout.

Klicken Sie unter Layout-Zuweisung auf Layout ändern. → Das Fenster Layout auswählen wird angezeigt.

Wählen Sie das Layout Standard Shopseiten-Layout mit mit Newsletterformular aus und klicken Sie auf Layout übernehmen.

Klicken Sie auf Speichern.

3 Transaktionsnachrichten konfigurieren

3.1 Grundlagen

3.1.1 Funktionsweise

Beim Versand von Transaktionsnachrichten arbeiten Shopware und Optimizely Campaign zusammen:

Ein E-Mail-Template in Shopware sendet die Variablenwerte der Transaktion über die HTTP-API an Optimizely Campaign. Die Variablen enthalten beispielsweise den Kundenamen, die bestellten Produkte, die Preise usw.

Die Werte werden in der Transaktions-Empfängerliste in Optimizely Campaign zwischengespeichert.

Eine Transaktionskampagne in Optimizely Campaign fügt über Feldfunktionen die gesendeten Variablen in einen Nachrichtenentwurf ein. So entsteht die fertige Nachricht, die an den Empfänger versendet wird.

3.1.2 Beispiel zu Feldfunktionen und Shopware

Um eine Transaktionsnachricht einzurichten, die Kunden mit Ihrem Nachnamen begrüßt und das Bestelldatum nennt, benötigen Sie die Variablen salutation (Anrede), lastname (Nachname) und orderdate (Bestelldatum).

Diese drei Variablenwerte werden von Shopware an Optimizely Campaign gesendet und in die zugeordneten Felder Ihrer Transaktions-Empfängerliste geschrieben. Um auf diese Werte in den Feldern zuzugreifen, fügen Sie Feldfunktionen in den Nachrichtenentwurf in der Transaktionskampagne ein.

Um eine Feldfunkton zu nutzen, setzen Sie im Nachrichtentext den Namen des Empfängerlistenfeldes in geschweifte Klammern. Der Text im Nachrichtenentwurf könnte so aussehen:

Hallo {salutation} {lastname}, vielen Dank für Ihre Bestellung vom {orderdate}!

Dies wird später in der versendeten Nachricht so angezeigt:

"Hallo Herr Müller, vielen Dank für Ihre Bestellung vom 3. August!"

3.1.3 Über die Felder-Zuordnung in Shopware

Um das E-Mail-Template in Shopware zu nutzen (Siehe Vorgehensweise) müssen Sie Datenfelder zwischen Shopware und Optimizely Campaign zuordnen. Die Shopware-Integration von Optimizely Campaign verwendet folgenden Aufbau für das Mapping:

Name des Empfängerlistenfeldes={{ Name der Shopware-Variablen }};

Geben Sie die Mapping-Anweisung in einer Zeile pro Variable ein und beenden Sie jede Zeile mit einem Semikolon.

Beispiel:

salutation={{ customer.salutation.translated.letterName }};
firstname={{ customer.firstname }};
lastname={{ customer.lastname }};
s-mail={{ customer.email }};
shopname={{ salesChannel.name }};

Hinweis: Achten Sie darauf, dass Sie die zu übertragenden Shopware-Variablen stets auf existierende Empfängerlistenfelder mappen. Wenden Sie sich für die Einrichtung von Empfängerlistenfeldern an die Kundenbetreuung. Überprüfen Sie im Vorfeld, welche Daten/Inhalte Sie an Optimizely Campaign übertragen müssen und welche Inhalte Sie als statischen Text in der Transaktionskampagne realisieren können.

3.1.4 Die Feldzuordnung für bestellte Produkte

Das vordefinierte E-Mail-Template Bestellbestätigung in Shopware enthält neben einigen einfachen Feldzuordnungen auch eine komplexere Zuordnung: Alle Produkte in einer Bestellung werden in das Empfängerlistenfeld orderPositions der Transaktions-Empfängerliste geschrieben. Dazu dient im Template die Zeile (Zeilenumbrüche hier zur Lesbarkeit eingefügt):

orderPositions={% for lineItem in order.lineItems %}"
{% if lineItem.pay-load.productNumber is defined %}
{{ lineItem.payload.productNumber|u.wordwrap(80) }}{% endif %}"; "
{{ lineItem.quantity }}"; "{{ lineItem.unitPrice|currency(currencyIsoCode) }}"; 
"{{ lineItem.totalPrice|currency(currencyIsoCode) }}"; "{{ lineItem.label|u.wordwrap(80) }}
{% if lineItem.payload.options is defined and lineItem.payload.options|length >= 1 %}, 
{% for option in lineItem.pay-load.options %}{{ option.group }}: {{ option.option }}
{% if lineItem.pay-load.options|last != option %}{{ " | " }}{% endif %}{% endfor %}
{% endif %}";{% endfor %};

Der Wert der Variablen orderPositions wird mit einer foreach-Schleife definiert, welche die bestellten Produkte in einer Zeichenfolge zusammenfasst. Die einzelnen Spalten (Bestellnummer, Anzahl, Preis, Gesamtpreis, Artikelname) werden mit einem Semikolon getrennt, angelehnt an das Dateiformat .csv. Die Trennung der einzelnen Produkte wird über ein Zeichen für einen Zeilenumbruch realisiert.

Sie können diese Zeile im E-Mail-Template anpassen, dies ist jedoch normalerweise nicht nötig. Die Darstellung der bestellten Produkte in Transaktionsnachrichten kann auch über die Feldfunktion in Optimizely Campaign verändert werden (siehe Feldfunktion für Produkte in Optimizely Campaign erstellen). Bei Fragen wenden Sie sich an die Optimizely Kundenbetreuung.

3.1.5 Übersicht über die Konfigurationsschritte

Um Transaktionsnachrichten zu konfigurieren, sind folgende Aufgaben zu erledigen:

Lassen Sie von der Kundenbetreuung die Transaktions-Empfängerliste einrichten.

Erstellen Sie die Transaktionskampagne in Optimizely Campaign.

Konfigurieren Sie das E-Mail-Template in Shopware.

Konfigurieren Sie den oder die Nachrichtenentwürfe in der Transaktionskampagne im Detail.

Falls erforderlich: Richten Sie individuelle Transaktions-Mails für mehrere Shops ein.

3.2 Vorgehensweise

3.2.1 Transaktions-Empfängerliste anfordern

Kontext: Die Optimizely Kundenbetreuung benötigt genaue Informationen zur Einrichtung der Transaktions-Empfängerliste.

Planen Sie, welche Variablenwerte Sie aus Ihrem Shopware-System für die Transaktionsnachrichten in Optimizely Campaign benötigen

Erstellen Sie eine Liste mit allen Shopware-Variablen, für die Sie in Ihrer Transaktions-Empfängerliste ein entsprechendes Feld benötigen. Geben Sie den Feldern in der Empfängerliste passende Namen.

Beauftragen Sie die Optimizely Kundenbetreuung mit der Einrichtung einer Transaktions-Empfängerliste und fügen Sie die zuvor erstellte Liste bei.

3.2.2 Transaktionskampagne in Optimizely Campaign erstellen

Voraussetzungen: Die Transaktions-Empfängerliste zur Verwendung mit der Shopware-Erweiterung wurde von der Kundenbetreuung eingerichtet.

Erstellen Sie eine Transaktionskampagne.

Verwenden Sie die Transaktions-Empfängerliste, die von der Optimizely Kundenbetreuung für die Nutzung mit der Shopware-Erweiterung eingerichtet wurde.

Fügen Sie im Nachrichtenentwurf die gewünschten statischen Texte hinzu.

Fügen Sie dort, wo die Inhalte der Shopware-Variablen stehen sollen, Feldfunktionen ein.

3.2.3 E-Mail-Template in Shopware konfigurieren

Kontext: Das E-Mail-Template definiert, welche Variablenwerte von Shopware an Optimizely Campaign gesendet werden. Die Shopware-Erweiterung enthält zu Demonstrationszwecken zwei funktionsfähige Vorlagen für Transaktionsnachrichten: Kunden-Registrierung und Bestellbestätigung.

Voraussetzungen: Sie sind in der Admin-Oberfläche von Shopware eingeloggt. Sie kennen den Autorisierungs-Code der Transaktions-Empfängerliste (siehe Über Opt-In-ID und Autorisierungs-Code) und die Mailing-ID der Transaktionskampagne (Spalte ID auf der Seite Transaktions-Mails).

Klicken Sie in der Menüleiste auf Einstellungen.

Klicken Sie auf der Seite Einstellungen auf E-Mail-Templates.

Klicken Sie im Kontextmenü der E-Mail-Vorlage auf Bearbeiten.

Um die Variablen der Vorlage über die HTTP-API an Optimizely Campaign zu senden, setzen sie ein Häkchen im Feld Optimizely.

Geben Sie im Feld Optimizely authcode den Autorisierungs-Code Ihrer Transaktions-Empfängerliste in Optimizely Campaign ein.

Geben Sie im Feld Optimizely bmMailingId die Mailing-ID der Transaktionskampagne in Optimizely Campaign ein.

Mappen Sie im Bereich Mail-Text im Feld Optimizely die zu übertragenden Shopware-Variablen mit den entsprechenden Empfängerlistenfeldern Ihrer Transaktions-Empfängerliste in Optimizely Campaign (siehe Über die Felder-Zuordnung in Shopware).

Klicken Sie auf Speichern.

3.2.4 Feldfunktion für Produkte in Optimizely Campaign erstellen

Kontext: Um die Informationen über bestellte Produkte in einer Transaktionsnachricht übersichtlich darzustellen, müssen Sie eine spezielle Feldfunktion in Optimizely Campaign erstellen. Diese macht aus der Zeichenfolge aus Shopware eine HTML-Tabelle.

Voraussetzungen: Die Funktion Feldfunktionen ist in Ihrem Mandanten verfügbar (falls nicht, wenden Sie sich an die Kundenbetreuung).

Wählen Sie in der Optimizely Campaign Menüleiste Verwaltung > Feldfunktionen.

Klicken Sie auf Erstellen….

Geben Sie unter Allgemein im Feld Name einen prägnanten Namen für die neue Feldfunktion ein (beispielsweise CSVBestellObjekte).

Wählen Sie in der Drop-down-Liste Typ die Option Velocity

Geben Sie im Bereich Inhalte im Reiter Standard-Ersetzung in das Feld Standard-Ersetzung folgenden Code ein:

<table> <tr> <td>Produkt-ID</td><td>SKU</td><td>Name</td><td>Anzahl</td>
<td>Preis</td> </tr> #set ($csvContent = $csv.readFromString($user.data.orderpositions))
#foreach($row in $csvContent) <tr> #foreach($item in $row) <td> $item </td>
#end </tr> #end </table>

Klicken Sie auf Speichern.

Hinweis: Wenn Sie über HTML-Kenntnisse verfügen, können Sie das Layout der Tabelle an Ihre Anforderungen anpassen (siehe Feldfunktionen).

3.2.5 Über Transaktionsnachrichten für mehrsprachige Shops

Wenn Sie in Ihrem Shopware-System neben Ihrem Haupt-Verkaufskanal weitere Verkaufskanäle oder Ihren Shop in unterschiedlichen Sprachen konfiguriert haben, können Sie für jeden Shop individuelle Vorlagen in mehreren Sprachen zum Versand von Transaktionsnachrichten einrichten. Sie benötigen eventuell separate Transaktions-Empfängerlisten. Wenden Sie sich dafür an die Kundenbetreuung.

Sie möchten beispielsweise die Registrierungsbestätigung zu Ihrem Newsletter für nicht-deutschsprachige Empfänger auf Englisch anbieten. Fügen Sie die englische Übersetzung in die Transaktionskampagne ein und verwenden Sie dort, wo die Inhalte aus den von Shopware gelieferten Variablen stehen sollen, die entsprechenden englischen Feldfunktionen. Falls Sie noch keine Feldfunktionen für internationale Parameter in Ihrem Mandanten haben, wenden Sie sich an die Kundenbetreuung.

3.2.6 Transaktionsnachrichten für mehrsprachige Shops einrichten

Voraussetzungen: Sie sind in der Admin-Oberfläche von Shopware eingeloggt. Sie kennen den Autorisierungs-Code der Transaktions-Empfängerliste (siehe Über Opt-In-ID und Autorisierungs-Code) und die Mailing-ID der Transaktionskampagne (Spalte ID auf der Seite Transaktions-Mails). Sie haben in Optimizely Campaign eine Vorlage für Transaktionsnachrichten in einer zusätzlichen Sprache eingerichtet.

Wählen Sie in der Shopware Menüleiste Einstellungen > E-Mail-Templates.

Klicken Sie im Kontextmenü der E-Mail-Vorlage, die Sie bearbeiten möchten, auf Bearbeiten.

Wählen Sie in der oberen Drop-down-Liste eine Sprache aus.

Um die Variablen der Vorlage über die HTTP-API an Optimizely Campaign zu senden, aktivieren Sie das Kontrollkästchen neben Optimizely.

Geben Sie im Feld Optimizely authcode den Autorisierungs-Code Ihrer Transaktions-Empfängerliste in Optimizely Campaign ein.

Geben Sie im Feld Optimizely bmMailingId die Mailing-ID der Transaktionskampagne in Optimizely Campaign ein.

Klicken Sie auf Speichern.

4 Fortgeschrittene Konfiguration

4.1 Grundlagen

Dieses Kapitel beschreibt, wie Sie mit der Optimizely Campaign Shopware-Erweiterung individuelle Opt-In-Nachrichten und Katalog-Exporte konfigurieren und Frontend-Mitteilungen der Integration anpassen. Wenn Sie mehrere Shops mit getrennten Mandanten für Transaktions-Mails oder eine empfängerlistenbasierte Newsletter-Abmeldung einrichten möchten, wenden Sie sich an die Kundenbetreuung.

4.2 Individuelle Opt-In-Nachrichten und Katalogexporte

4.2.1 Über individuelle Katalogexporte

Wenn Sie für einen Sub-Shop oder eine Sprachversion Ihres Shop einen individuellen Katalog-Export konfigurieren möchten, müssen Sie in Shopware einen gesonderten Feed für den entsprechenden Shop anlegen, vgl. Abschnitt Katalog-Export konfigurieren. Vergeben Sie stets einen neuen, abweichenden Dateinamen für den Katalog-Export eines Sub-Shops oder einer Sprachversion Ihres Haupt-Shops (z. B. products_en.csv für Englisch). Wenn Sie einen Dateinamen mehrfach verwenden, überschreiben sich die einzelnen Dateien der unterschiedlichen Katalog-Exporte gegenseitig.

4.2.2 Individuellen Katalogexport konfigurieren

Voraussetzungen: Sie sind in der Admin-Oberfläche von Shopware eingeloggt.

Wählen Sie in der Menüleiste Erweiterungen > Meine Erweiterungen.

Klicken Sie im Kontextmenü des Plugins Optimizely Campaign auf Konfiguration.

Wählen Sie in der Drop-down-Liste Verkaufskanal den Shop aus, den Sie konfigurieren möchten.

Nehmen Sie die gewünschten Einstellungen vor und klicken Sie auf Speichern.

4.3 Frontend-Mitteilungen ändern

Wenn Sie die Frontend-Mitteilungen, die einem Besucher oder einem Kunden Ihres Shops, beispielsweise bei An- oder Abmeldung, angezeigt werden, ändern möchten, können Sie die Textdateien der Integration bearbeiten. Die Shopware-Erweiterung unterstützt die in Shopware integrierten Funktionen zur Lokalisierung und liefert bereits mehrere Standardtexte in deutscher und englischer Sprache (britisches Englisch) mit.

Voraussetzungen: Sie sind in der Admin-Oberfläche von Shopware eingeloggt.

Wählen Sie Einstellungen > Textbausteine.

Klicken Sie auf BASE de-DE, um die deutschen Texte zu bearbeiten, oder auf BASE en-GB, um die englischen Texte zu bearbeiten.

Öffnen Sie das Kontextmenü für einen Textbaustein und klicken Sie auf Bearbeiten.

Nehmen Sie Ihre Änderungen vor und klicken Sie auf Speichern.

4.4 Anrede ändern und lokalisieren

Kontext: Sie können die Anrede, die in das Optimizely Campaign Empfängerlistenfeld salutation geschrieben wird, für einzelne Sub-Shops oder Sprachversionen Ihres Shops anpassen. In der Standardeinstellung lauten die Anreden Frau und Herr.

Voraussetzungen: Sie sind in der Admin-Oberfläche von Shopware eingeloggt.

Wählen Sie Einstellungen > Anreden.

Öffnen Sie das Kontextmenü für eine Anrede, und klicken Sie auf Bearbeiten.

Nehmen Sie Ihre Änderungen vor und klicken Sie auf Speichern.

5 Fehlersuche

5.1 Grundlagen

Diesesr Abschnitt beschreibt häufige Fehlerquellen, die bei der Konfiguration und im Betrieb der Shopware-Erweiterung auftreten können. Sie erfahren auch wie Sie auf die Ereignis-Logs für die Fehlersuche zugreifen können.

Wenn ihnen dieser Abschnitt nicht weiterhilft, wenden Sie sich an die Kundenbetreuung.

5.2 Häufige Fehlerquellen

Fehler	Mögliche Ursache	Lösung
Kunden können sich nicht zum Newsletter anmelden.	Die Firewall des Shop-Systems blockiert den Verbindungsaufbau zu Optimizely Campaign.	Überprüfen Sie die Netzwerkkonfiguration des Shop-Systems.
	Der Autorisierungs-Code der Empfängerliste ist ungültig.	Überprüfen Sie den Autorisierungs-Code der Empfängerliste und erstellen Sie ggf. einen neuen Autorisierungs-Code.
	Die Opt-In-ID ist ungültig.	Überprüfen und korrigieren Sie die Opt-In-ID.
Der Katalog-Export schlägt fehl.	Die Firewall des Shop-Systems blockiert den Verbindungsaufbau zu Optimizely Campaign.	Überprüfen Sie die Netz-werkkonfiguration des Shop-Systems.
	Der private SSH-Schlüssel wurde unvollständig oder fehlerhaft hinterlegt.	Geben Sie den SSH-Schlüssel erneut ein.
	Das Passwort des privaten SSH-Schlüssels wurde unvollständig oder fehlerhaft hinterlegt.	Geben Sie das Passwort des privaten SSH-Schlüssels erneut ein.

5.3 Ereignis-Logs aufrufen

Kontext: Die Shopware-Integration protokolliert Ereignisse und ausgeführte Aufgaben, wie beispielsweise den Katalog-Export. Mithilfe der Ereignis-Logs können Sie bei Problemen die entsprechenden Fehlerquellen finden.

Voraussetzungen: Sie sind in der Admin-Oberfläche von Shopware eingeloggt.

Wählen Sie in der Menüleiste Einstellungen > System > Ereignis-Logs.

Optional: Klicken Sie im Kontextmenü eines Eintrags auf Details anzeigen….