--- title: Transaktions-Mails konfigurieren slug: campaign/docs/transaktions-mails-konfigurieren docTags: createdAt: 2026-08-06T15:53:50.621Z --- :::hint{type="info"} **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. 1. Die Shopware-Vorlage sendet die Variablen. 2. Die Variablen werden in die Transaktions-Empfängerliste geschrieben, jede Variable in ihr entsprechendes Empfängerlistenfeld. 3. 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. ![Bild: Senden und Empfangen von Variableninhalten](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/rU1--oZjXIda7kzvxATTE-20260720-145349.png "Bild: Senden und Empfangen von Variableninhalten") ## Konfigurationsschritte 1. Richten Sie die [Transaktions-Empfängerliste](docId\:TsY3hKcAd9quVsw6kzXqw) ein. 2. Konfigurieren Sie die [Vorlage in Optimizely Campaign](docId\:TsY3hKcAd9quVsw6kzXqw). 3. Konfigurieren Sie die [Vorlage in Shopware](docId\:TsY3hKcAd9quVsw6kzXqw). 4. Konfigurieren Sie die Transaktions-Mails [im Detail](docId\:TsY3hKcAd9quVsw6kzXqw). 5. Richten Sie individuelle Transaktions-Mails für [mehrere Shops](docId\:TsY3hKcAd9quVsw6kzXqw) ein. ### Schritt 1: Transaktions-Empfängerliste einrichten Beauftragen Sie die [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV) 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](docId\:yf47bFjaIzEvsqGSfVXdw) 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: ```html 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: 1. Wählen Sie im Optimizely Campaign [Menü](docId\:PmNPgvNucBrAG5Rw8f41f) **Kampagnen** > **Transaktions-Mails**. 2. Klicken Sie auf **Erstellen…**. ![Bild: Transaktions-Mail erstellen](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ige8qkyuA3Ks2SMDAaMWo-20260720-145349.png "Bild: Transaktions-Mail erstellen") 3. Ziehen Sie den **Empfänger**-Knoten aus dem linken Aktionsbereich in den rechten Arbeitsbereich. 4. Wählen Sie in der Drop-down-Liste **Empfängerlisten** Ihre Transaktions-Empfängerliste aus. ![Bild: Empfängerlisten-Optionen](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/l-Ge3rV1EXIFakU2-ac0M-20260720-145349.png "Bild: Empfängerlisten-Optionen") :::hint{type="info"} **Note** Die [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV) 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**. ::: 5. Ziehen Sie aus dem linken Aktionsbereich den Nachrichtenknoten des gewünschten Marketing-Kanals (E-Mail, SMS) in die Arbeitsfläche. 6. Vergeben Sie im Kontextmenü im Feld **Name** einen prägnanten Namen für Ihre Transaktions-Mail (z. B. *Bestellbestätigung*). ![Bild: E-Mail-Knoten Bestellbestätigung](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/jBFmY7jmXxhMZfSxRYKV1-20260720-145349.png "Bild: E-Mail-Knoten Bestellbestätigung") 7. Klicken Sie im Kontextmenü des Nachrichtenknotens auf **Inhalt bearbeiten…**. 8. 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. 9. 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). 10. Klicken Sie auf **Schließen**. 11. Verbinden Sie den **Empfänger**-Knoten mit dem Nachrichtenknoten. 12. Klicken Sie auf **Speichern und schließen**. 13. 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ü](docId\:PmNPgvNucBrAG5Rw8f41f) **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ü](docId\:PmNPgvNucBrAG5Rw8f41f) **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 :::hint{type="info"} **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. ::: 1. Melden Sie sich mit Administrator-Rechten im Backend von Shopware an. 2. Wählen Sie **Einstellungen** > **E-Mail-Vorlagen**. ![Bild: eMail-Vorlagen im Einstellungen-Menü](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/FwY2hb514q9-3iu7YBiJ6-20260720-145349.png "Bild: eMail-Vorlagen im Einstellungen-Menü") 3. Navigieren Sie über die Verzeichnisstruktur zur Vorlage, die Sie konfigurieren möchten. ![Bild: Vorlage auswählen](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/4s7qPSCah8_lgipX-amTd-20260720-145349.png "Bild: Vorlage auswählen") 4. 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). ![Bild: Variablen versenden](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/9te5sGuheM2ZmFTaGQTRN-20260720-145349.png "Bild: Variablen versenden") 5. Geben Sie im Feld optivo **authcode** den Autorisierungs-Code Ihrer Transaktions-Empfängerliste in Optimizely Campaign ein. ![Bild: Autorisierung-Code eingeben](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/wmLyki4XqG8K2jBHGTlzy-20260720-145349.png "Bild: Autorisierung-Code eingeben") 6. Geben Sie im Feld optivo **bmMailingId** die Mailing-ID der Vorlage in Optimizely Campaign ein. ![Bild: Mailing-ID eingeben](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/FhoJKnAHtJRRVzOsZ61HC-20260720-145349.png "Bild: Mailing-ID eingeben") 7. Wechseln Sie in den Reiter optivo broadmail. ![Bild: optivo broadmail](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/grtc_AeYo69c-H3PF6WW0-20260720-145349.png "Bild: optivo broadmail") :::hint{type="info"} **Note** Wenn der Versand über Optimizely Campaign aktiviert ist, werden die Inhalte der Felder in den Tabs **Plaintext**, **HTML-Text** und **Anhänge** ignoriert. ::: 8. 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**. ![Bild: Variablen Informationen einsehen 1](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Pt56yjiVeadfDI9r46v9a-20260720-145349.png "Bild: Variablen Informationen einsehen 1") ![Bild: Variablen Informationen einsehen 2](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/arR47cc8ZL3L9F90SzVYw-20260720-145349.png "Bild: Variablen Informationen einsehen 2") :::Paragraph{indent="1"} **Mappen (Zuweisen)** Die Shopware-Integration von Optimizely Campaign verwendet folgenden Aufbau für das Mapping: ::: ```html Name des Empfängerlistenfeldes=Name der Shopware-Variablen ``` :::Paragraph{indent="1"} Geben 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:** ::: ```html salutation={salutation};firstname={firstname};lastname={lastname};smail={sMAIL};shopname={config name=shopName}; ``` :::Paragraph{indent="1"} Mit den Beispielzeilen mappen und übertragen Sie: ::: :::Paragraph{listStyleType="disc" indent="2"} in das Transaktions-Empfängerlistenfeld **salutation** den Wert der Shopware-Variablen ::: :::Paragraph{listStyleType="disc" indent="2"} in das Transaktions-Empfängerlistenfeld **firstname** den Wert der Shopware-Variablen ::: :::Paragraph{listStyleType="disc" indent="2"} in das Transaktions-Empfängerlistenfeld **lastname** den Wert der Shopware-Variablen ::: :::Paragraph{listStyleType="disc" indent="2"} in das Transaktions-Empfängerlistenfeld **smail** den Wert der Shopware-Variablen ::: :::Paragraph{listStyleType="disc" indent="2"} in das Transaktions-Empfängerlistenfeld **shopname** den Wert der Shopware-Variablen **\{config name=shopName}** ::: :::hint{type="info" indent="2"} **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](docId\:ZWe1T3UPz3JW6_4mc76qV). Ü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. ::: 9. 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: ```html 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 1. Wählen Sie **Einstellungen** > **eMail-Vorlagen**. 2. Wählen Sie die mitgelieferten Vorlage **sORDER** im Verzeichnis **System Emails** der Shopware-Integration. 3. Wechseln Sie in den Reiter optivo broadmail. 4. 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**. :::hint{type="info"} **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. ::: 5. 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. 1. Wählen Sie im Optimizely Campaign [Menü](docId\:PmNPgvNucBrAG5Rw8f41f) **Verwaltung** > **Feldfunktionen**. :::hint{type="info"} **Tip** Wenn die Funktion **Feldfunktionen** nicht in Ihrem Mandanten verfügbar sein sollte, wenden Sie sich an die [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV), die die Funktion gerne für Sie freischaltet. ::: 2. Klicken Sie auf **Erstellen…**. ![Bild: Feldfunktion hinzufügen](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/LIFJJlYsXL_a5_2U1LrGb-20260720-145349.png "Bild: Feldfunktion hinzufügen") 3. Geben Sie unter **Allgemein** im Feld **Name** einen prägnanten Namen für die neue Feldfunktion ein, z. B. *CSVBestellObjekte*. ![Bild: Feldfunktionen Name](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/mCUlBA56OVCCuQvPV89bQ-20260720-145349.png "Bild: Feldfunktionen Name") 4. Wählen Sie in der Drop-down-Liste **Typ** die Option **Velocity** aus. 5. Geben Sie im Bereich **Inhalte** im Reiter **Standard-Ersetzung** in das Feld **Standard-Ersetzung** folgenden Code ein: ```html #set ($csvContent = $csv.readFromString($user.data.orderpositions)) #foreach($row in $csvContent) #foreach($item in $row) #end #end
Produkt-IDSKUNameAnzahl Preis
$item
``` ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/3Pej7xb0gH-K5GT1aitaZ-20260720-145349.png" size="100" caption="Bild: Standard-Ersetzungs-Code" alt="Bild: Standard-Ersetzungs-Code" isUploading="false" showCaption="true" indent="2"} 6. 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. :::hint{type="info"} **Note** Wenn Sie über HTML-Kenntnisse verfügen, können Sie das Layout der Tabelle an Ihre Anforderungen anpassen. Sehen Sie dazu auch [Feldfunktionen](docId\:yf47bFjaIzEvsqGSfVXdw). ::: ### 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](docId\:ZWe1T3UPz3JW6_4mc76qV). Führen Sie die folgenden Schritte aus: 1. Konfigurieren Sie in Optimizely Campaign eine individuelle Vorlage für Transaktions-Mails, wie im Abschnitt [Vorlage in Optimizely Campaign erstellen](docId\:TsY3hKcAd9quVsw6kzXqw) beschrieben. 2. Melden Sie sich mit Administrator-Rechten im Backend von Shopware an. 3. Wählen Sie **Einstellungen** > **E-Mail-Vorlagen**. 4. Navigieren Sie links über die Liste zu der gewünschten Vorlage. 5. Klicken Sie im Textfeld auf das Globus-Symbol. 6. Wählen Sie den Subshop oder die Sprachfassung Ihres Shops aus, für den Sie eine individuelle Transaktions-Mail-Vorlage einrichten möchten. 7. Geben Sie im Feld optivo **authcode** den Autorisierungs-Code der entsprechenden Transaktions-Empfängerliste in Optimizely Campaign ein. 8. 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. 9. Klicken Sie auf **Übersetzung speichern**.