Transaktions-Mails konfigurieren
Note
Dieses Kapitel richtet sich an Administratoren und Entwickler mit Administratorrechten in Shopware.
Dieses Kapitel beschreibt, wie Sie den Versand von Transaktions-Mails konfigurieren, wenn Sie Shopware als E-Commerce-Plattform mit Anbindung an Optimizely Campaign nutzen.
Funktionsweise
Der Versand von Transaktions-Mails erfolgt über zwei Vorlagen:
- eine Sender-Vorlage in Shopware, die allein die Variablen der Transaktion (zum Beispiel den Kundenamen, die bestellten Produkte, die Preise und so weiter) über die HTTP-API sendet
- einer Empfänger-Vorlage in Optimizely Campaign, die mithilfe von Feldfunktionen die gesendeten Variablen an die entsprechenden Stellen einfügt und so die fertige, gestaltete Transaktions-Mail erstellt und an den Empfänger versendet.
Das Senden und der Empfang der Variableninhalte erfolgt über die Transaktions-Empfängerliste als Zwischenspeicher.
- Die Shopware-Vorlage sendet die Variablen.
- Die Variablen werden in die Transaktions-Empfängerliste geschrieben, jede Variable in ihr entsprechendes Empfängerlistenfeld.
- Mithilfe von Feldfunktionen übernimmt die Optimizely Campaign Vorlage die einzelnen Variablen aus der Transaktions-Empfängerliste und platziert sie an die gewünschte Stelle in der Transaktions-Mail.
Konfigurationsschritte
- Richten Sie die Transaktions-Empfängerliste ein.
- Konfigurieren Sie die Vorlage in Optimizely Campaign.
- Konfigurieren Sie die Vorlage in Shopware.
- Konfigurieren Sie die Transaktions-Mails im Detail.
- Richten Sie individuelle Transaktions-Mails für mehrere Shops ein.
Schritt 1: Transaktions-Empfängerliste einrichten
Beauftragen Sie die Kundenbetreuung mit der Einrichtung einer Transaktions-Empfängerliste. Planen Sie im Vorfeld, welche Variablen Sie aus Ihrem Shopware-System für Ihre Transaktions-Mails zu Optimizely Campaign übertragen möchten.
Listen Sie alle Shopware-Variablen auf, für die Sie in Ihrer Transaktions-Empfängerliste ein entsprechendes Empfängerlistenfeld benötigen. Teilen Sie Optimizely zudem mit, wie die Empfängerlistenfelder benannt werden sollen.
Schritt 2: Vorlage in Optimizely Campaign erstellen
Erstellen Sie die Vorlage, fügen Sie die gewünschten Transaktions-Mail-Texte hinzu (die unveränderlichen, statischen Texte, die alle Empfänger gleichermaßen erhalten sollen) und an den Stellen, an denen die Inhalte der Shopware-Variablen stehen sollen, fügen Sie Feldfunktionen ein.
Feldfunktionen
Feldfunktionen sind Platzhalter, die auf ein bestimmtes Empfängerlistenfeld in Ihrer Transaktions-Empfängerliste verweisen. Die von Shopware gesendeten Variablen beziehungsweise die Inhalte der Variablen werden zunächst in die jeweiligen Empfängerlistenfelder Ihrer Transaktions-Empfängerliste geschrieben. Die von Ihnen platzierten Feldfunktion laden im nächsten Schritt den jeweiligen Inhalt aus dem referenzierten Empfängerlistenfeld.
Beispiel
Um einen Transaktions-Mail-Text einzurichten, der Kunden mit Ihrem Nachnamen begrüßt und das Bestelldatum nennt, benötigen Sie die Variablen salutation (Anrede), lastname (Nachname) und orderdate (Bestelldatum).
Diese drei Variableninhalte werden zunächst in ein entsprechendes Empfängerlistenfeld Ihrer Transaktions-Empfängerliste geschrieben (von Shopware über die HTTP-API). Um auf diese Empfängerlistenfelder zuzugreifen, fügen Sie die einzelnen Feldfunktionen in die Optimizely Campaign Vorlage ein und setzen Sie den Namen des jeweiligen Empfängerlistenfeldes in geschweifte Klammern. Um die Variableninhalte aus dem jeweiligen Empfängerlistenfeld der Transaktions-Empfängerliste zu importieren, könnte der statische Text und die Feldfunktionen in Ihrer Optimizely Campaign Vorlage folgendermaßen aussehen:
Hallo, {salutation} {lastname}!Vielen Dank für Ihre Bestellung vom {orderdate}.Das Beispiel wird später in der versendeten Transaktions-Mail folgendermaßen angezeigt:
Hallo, Herr Müller! Vielen Dank für Ihre Bestellung vom 3. August.
Um eine Vorlage zu erstellen, gehen Sie wie folgt vor:
- Wählen Sie im Optimizely Campaign Menü Kampagnen > Transaktions-Mails.
- Klicken Sie auf Erstellen….
- Ziehen Sie den Empfänger-Knoten aus dem linken Aktionsbereich in den rechten Arbeitsbereich.
- Wählen Sie in der Drop-down-Liste Empfängerlisten Ihre Transaktions-Empfängerliste aus.
Note
Die Kundenbetreuung hat eine gesonderte Transaktions-Empfängerliste für Sie eingerichtet. Verwenden Sie ausschließlich diese Transaktions-Empfängerliste und keine reguläre Empfängerliste. Ob eine Empfängerliste eine Transaktions-Empfängerliste ist, sehen Sie in der Spalte Transaction API.
- Ziehen Sie aus dem linken Aktionsbereich den Nachrichtenknoten des gewünschten Marketing-Kanals (E-Mail, SMS) in die Arbeitsfläche.
- Vergeben Sie im Kontextmenü im Feld Name einen prägnanten Namen für Ihre Transaktions-Mail (z. B. Bestellbestätigung).
- Klicken Sie im Kontextmenü des Nachrichtenknotens auf Inhalt bearbeiten….
- Wählen Sie in der Drop-down-Liste Vorlage die gewünschte Vorlage aus und bestätigen Sie Ihre Auswahl, indem Sie auf Weiter klicken.
- Konfigurieren und gestalten Sie die Vorlage für die Transaktions-Mail nach Ihren Anforderungen. Geben Sie einen Betreff ein und fügen Sie in die Inhaltsparagraphen die statischen Texte ein, die alle Empfänger gleichermaßen erhalten sollen. Fügen Sie wiederum an den Stellen, an denen die aus der Shopware-Vorlage gelieferten Variablen erscheinen sollen, die entsprechende Feldfunktion für das Empfängerlistenfeld der Transaktions-Empfängerliste ein (siehe Beispiel oben).
- Klicken Sie auf Schließen.
- Verbinden Sie den Empfänger-Knoten mit dem Nachrichtenknoten.
- Klicken Sie auf Speichern und schließen.
- Um Ihre Transaktions-Mail zu aktivieren und den Versand zu starten, wählen Sie die Transaktions-Mail in der Übersicht aus und klicken Sie auf Starten.
Schritt 3: Vorlage in Shopware konfigurieren
Konfigurieren Sie in Shopware die Vorlage, die die Variablen über die HTTP-API an Optimizely Campaign sendet.
Voraussetzungen
Sie benötigen für die Konfiguration folgende Daten:
- Autorisierungs-Code. Für Ihre Transaktions-Empfängerliste in Optimizely Campaign. Wählen Sie im Optimizely Campaign Menü Verwaltung > API-Übersicht > Empfängerlisten und wählen Sie die Transaktions-Empfängerliste aus. Klicken Sie auf Autorisierungs-Codes verwalten und kopieren Sie den Autorisierungs-Code aus der Liste. Wenn für die gewählte Empfängerliste noch kein Autorisierungs-Code vorhanden ist, klicken Sie auf Autorisierungs-Code erstellen.
- Mailing-ID. Für die Vorlage in Optimizely Campaign. Wählen Sie im Optimizely Campaign Menü Kampagnen > Transaktions-Mails. Kopieren Sie die entsprechende Mailing-ID der Vorlage aus der Spalte ID.
Die Shopware-Integration von Optimizely Campaign enthält zu Demonstrationszwecken zwei funktionsfähige Vorlagen für Transaktions-Mails:
- sREGISTERCONFIRMATION
- sORDER
Note
Wenn Sie die Newsletter-Anmeldung mit der Shopware-Integration über Optimizely Campaign einrichten, verwenden und konfigurieren Sie nicht die System-Vorlage sOPTINNEWSLETTER, die im Shopware-Standard enthalten ist. Andernfalls schlägt die Newsletter-Anmeldung über Optimizely Campaign fehl.
- Melden Sie sich mit Administrator-Rechten im Backend von Shopware an.
- Wählen Sie Einstellungen > E-Mail-Vorlagen.
- Navigieren Sie über die Verzeichnisstruktur zur Vorlage, die Sie konfigurieren möchten.
- Um die Variablen der Vorlage über die HTTP-API an Optimizely Campaign zu senden, aktivieren Sie das Kontrollkästchen neben optivo broadmail (mit optivobroadmail versenden).
- Geben Sie im Feld optivo authcode den Autorisierungs-Code Ihrer Transaktions-Empfängerliste in Optimizely Campaign ein.
- Geben Sie im Feld optivo bmMailingId die Mailing-ID der Vorlage in Optimizely Campaign ein.
- Wechseln Sie in den Reiter optivo broadmail.
Note
Wenn der Versand über Optimizely Campaign aktiviert ist, werden die Inhalte der Felder in den Tabs Plaintext, HTML-Text und Anhänge ignoriert.
- Mappen Sie im Feld des Reiters optivo broadmail die zu übertragenden Shopware-Variablen mit den entsprechenden Empfängerlistenfeldern Ihrer Transaktions-Empfängerliste in Optimizely Campaign. Um die für die jeweilige Vorlage zur Verfügung stehenden Variablen einzusehen, klicken Sie auf Variablen Informationen.
Mappen (Zuweisen) Die Shopware-Integration von Optimizely Campaign verwendet folgenden Aufbau für das Mapping:
Name des Empfängerlistenfeldes=Name der Shopware-VariablenGeben Sie die Mapping-Anweisung für jede Variable zeilenweise ein und beenden Sie jede Zeile mit einem Semikolon. Trennen Sie die einzelnen Variablen/Mapping-Anweisungen mit einem Zeilenumbruch. Beispiel:
salutation={salutation};firstname={firstname};lastname={lastname};smail={sMAIL};shopname={config name=shopName};Mit den Beispielzeilen mappen und übertragen Sie:
- in das Transaktions-Empfängerlistenfeld salutation den Wert der Shopware-Variablen
- in das Transaktions-Empfängerlistenfeld firstname den Wert der Shopware-Variablen
- in das Transaktions-Empfängerlistenfeld lastname den Wert der Shopware-Variablen
- in das Transaktions-Empfängerlistenfeld smail den Wert der Shopware-Variablen
- in das Transaktions-Empfängerlistenfeld shopname den Wert der Shopware-Variablen {config name=shopName}
Note
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 Optimizely Campaign Vorlage realisieren können.
- Klicken Sie auf Vorlage speichern.
Schritt 4: Transaktions-Mails konfigurieren
Die Template-Sprache von Shopware schreibt die bestellten Produkte als Zeichenfolge in das Empfängerlistenfeld orderPositions der Transaktions-Empfängerliste. Sie finden in der Vorlage sORDER, die die Shopware-Integration standardmäßig enthält, neben den Standard-Kundendaten die Zeile:
orderPositions={foreach item=details key=position from=$sOrderDetails}"{$details.ordernumber}"{literal};{/literal} "{$details.quantity}"{literal};{/literal} "{$details.price} EUR"{literal};{/literal} "{$details.amount} EUR"{literal};{/literal} "{$details.articlename}"{literal};{/literal}{/foreach};Die foreach-Schleife fasst die bestellten Produkte in einer Zeichenfolge zusammen, die sich am CSV-Format orientiert. Die einzelnen Spalten (Bestellnummer, Anzahl, Preis, Gesamtpreis, Artikelname) werden mit einem Semikolon getrennt. Die Trennung der einzelnen Produkte wird über ein Zeichen für einen Zeilenumbruch realisiert.
foreach-Schleife anpassen
- Wählen Sie Einstellungen > eMail-Vorlagen.
- Wählen Sie die mitgelieferten Vorlage sORDER im Verzeichnis System Emails der Shopware-Integration.
- Wechseln Sie in den Reiter optivo broadmail.
- Nehmen Sie in der Zeile der Mapping-Anweisung für das Empfängerlistenfeld orderPositions die gewünschten Änderungen vor. Um z. B. die Währung zu ändern, ersetzen Sie EUR durch eine andere Währung, zum Beispiel durch USD.
Note
Wenn Sie über fundierte Kenntnisse der Template-Funktionen von Shopware verfügen, können Sie diese Funktionen auch zur Konfiguration der zu übertragenden Daten verwenden. Achten Sie auf die korrekte Maskierung von Sonderzeichen, wenn Sie Anpassungen vornehmen. Zudem muss die Maskierung des Trennzeichens (des Semikolons) mit innerhalb der Schleife erhalten bleiben.
- Klicken Sie auf Vorlage speichern.
Feldfunktion für bestellte Produkte erstellen
Wenn Sie die als Zeichenfolge übergebenen bestellten Produkte in einer Transaktions-Mail verwenden möchten, müssen Sie eine neue, spezielle Feldfunktion in Ihrem Mandanten erstellen. Diese muss die Template-Engine von Optimizely Campaign nutzen, um die Zeichenfolge in HTML zu überführen und die bestellten Produkte in der Transaktions-Mail in einer Tabelle darzustellen.
- Wählen Sie im Optimizely Campaign Menü Verwaltung > Feldfunktionen.
Tip
Wenn die Funktion Feldfunktionen nicht in Ihrem Mandanten verfügbar sein sollte, wenden Sie sich an die Kundenbetreuung, die die Funktion gerne für Sie freischaltet.
- Klicken Sie auf Erstellen….
- Geben Sie unter Allgemein im Feld Name einen prägnanten Namen für die neue Feldfunktion ein, z. B. CSVBestellObjekte.
- Wählen Sie in der Drop-down-Liste Typ die Option Velocity aus.
- 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.
Sie haben erfolgreich eine Feldfunktion für die als Zeichenfolge übertragenen bestellten Produkte erstellt. Fügen Sie die Feldfunktion an der gewünschten Stelle in der Optimizely Campaign Vorlage für Transaktions-Mails ein. Wenn die Transaktions-Mail versendet wird und das Empfängerlistenfeld orderpositions ein CSV-Kontextobjekt enthält, wird in der versendeten Transaktions-Mail eine einfache HTML-Tabelle angezeigt.
Note
Wenn Sie über HTML-Kenntnisse verfügen, können Sie das Layout der Tabelle an Ihre Anforderungen anpassen. Sehen Sie dazu auch Feldfunktionen.
Schritt 5: Individuelle Transaktions-Mails für mehrere Shops
Wenn Sie in Ihrem Shopware-System neben Ihrem Hauptshop weitere Subshops oder Ihren Shop in unterschiedlichen Sprachen konfiguriert haben, können Sie für jeden Shop individuelle Vorlagen in mehreren Sprachen zum Versand von Transaktions-Mails einrichten.
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 Vorlage ein und verwenden Sie an den Stellen, an denen die Inhalte aus den von Shopware gelieferten Variablen stehen sollen, die entsprechenden für englische Kunden angelegten Feldfunktionen. Wenn Sie noch keine Feldfunktionen für internationale Parameter in Ihrem Mandanten haben, wenden Sie sich an die Kundenbetreuung.
Führen Sie die folgenden Schritte aus:
- Konfigurieren Sie in Optimizely Campaign eine individuelle Vorlage für Transaktions-Mails, wie im Abschnitt Vorlage in Optimizely Campaign erstellen beschrieben.
- Melden Sie sich mit Administrator-Rechten im Backend von Shopware an.
- Wählen Sie Einstellungen > E-Mail-Vorlagen.
- Navigieren Sie links über die Liste zu der gewünschten Vorlage.
- Klicken Sie im Textfeld auf das Globus-Symbol.
- Wählen Sie den Subshop oder die Sprachfassung Ihres Shops aus, für den Sie eine individuelle Transaktions-Mail-Vorlage einrichten möchten.
- Geben Sie im Feld optivo authcode den Autorisierungs-Code der entsprechenden Transaktions-Empfängerliste in Optimizely Campaign ein.
- Geben Sie im Feld optivo bmMailingId die Mailing-ID der individuellen Vorlage in Optimizely Campaign ein, die Sie für den Subshop oder die Sprachfassung Ihres Shops verwenden möchten.
- Klicken Sie auf Übersetzung speichern.