---
title: Transaktions-Mails über HTTP-API konfigurieren
slug: campaign/docs/transaktions-mails-percentc3percentbcber-http-api-konfigurieren
createdAt: 2026-08-06T15:53:47.341Z
---
:::hint{type="info"}
**Note**
Dieses Kapitel richtet sich an Administratoren und Entwickler mit Administratorrechten in Magento 2.
:::
Dieses Kapitel beschreibt, wie Sie den Versand von Transaktions-Mails über die HTTP-API für Magento 2 konfigurieren. Informationen darüber, wie Sie Ihre Transaktions-Mails über die SMTP-API versenden, finden Sie unter [Transaktions-Mails über SMTP-API](https://support.optimizely.com/hc/de/articles/4413192183053).
## Funktionsweise
Der Versand von Transaktions-Mails über die HTTP-API erfolgt über zwei Vorlagen:
- eine *Sender*-Vorlage in Magento 2, die allein die Variablen der Transaktion (z. B. den Kundenamen, die bestellten Produkte und so weiter) über die HTTP-API sendet
- eine *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
Das Senden und der Empfang der Variablen erfolgt über die Transaktions-Empfängerliste als *Zwischenspeicher*.
1. Die Magento-2-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.
## Konfigurationsschritte
1. Richten Sie eine [Transaktions-Empfängerliste](docId\:mp8k3Cs-GGQCkUHg6hAZu) ein.
2. Konfigurieren Sie die [Vorlage in Optimizely Campaign](docId\:mp8k3Cs-GGQCkUHg6hAZu).
3. Erstellen und aktivieren Sie die [Vorlage in Magento 2](docId\:mp8k3Cs-GGQCkUHg6hAZu).
4. Konfigurieren Sie [Transaktions-Mails und übertragen Sie Magento-2-Variablen](docId\:mp8k3Cs-GGQCkUHg6hAZu).
### Schritt 1: Transaktions-Empfängerliste einrichten
Beauftragen Sie die [Kundenbetreuung](https://support.optimizely.com/hc/de/articles/4413200618253) mit der Einrichtung einer Transaktions-Empfängerliste. Planen Sie im Vorfeld, welche Variablen Sie aus Magento 2 für Ihre Transaktions-Mails zu Optimizely Campaign übertragen möchten.
Listen Sie alle Magento-2-Variablen auf, für die Sie in Ihrer Transaktions-Empfängerliste ein entsprechendes Empfängerlistenfeld benötigen. Teilen Sie Optimizely zudem die gewünschten Namen der Empfängerlistenfelder mit.
:::hint{type="info"}
**Note**
Der Umfang der Transaktions-Empfängerliste ist eingeschränkt. Sie sollten daher generische Namen für die Empfängerlistenfelder beauftragen, z. B. custom\_string\_1, custom\_string\_2, custom\_date\_1 und so weiter).
:::
### Schritt 2: Vorlage in Optimizely Campaign erstellen
Erstellen Sie die Vorlage in Optimizely Campaign, fügen Sie die gewünschten Transaktions-Mail-Texte ein (die unveränderlichen, statischen Texte, die alle Empfänger gleichermaßen erhalten sollen) und fügen Sie Feldfunktionen an den Stellen ein, an denen die Inhalte der Magento-2-Variablen stehen sollen,
### Feldfunktionen
[Feldfunktionen](https://support.optimizely.com/hc/de/articles/4413192205325) sind Platzhalter, die auf ein bestimmtes Empfängerlistenfeld in Ihrer Transaktions-Empfängerliste verweisen. Die von Magento 2 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 einrichten, der später jeden Kunden mit seinem Nachnamen begrüßt und das Bestelldatum nennt, benötigen Sie die Variablen **salutation** (Anrede), **lastname** (Nachname) und **orderdate** (Bestelldatum).
Diese drei Variablen-Inhalte werden zunächst in ein entsprechendes Empfängerlistenfeld Ihrer Transaktions-Empfängerliste geschrieben (von Ihrem Magento-2-System ü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.*
### Statische Texte und Feldfunktionen in eine Vorlage einfügen
1. Wählen Sie im Optimizely Campaign [Menü](https://support.optimizely.com/hc/de/articles/4413200452237#heading-3) **Kampagnen** > **Transaktions-Mails**.
2. Klicken Sie auf **Erstellen**.
3. Ziehen Sie aus dem linken Aktionsbereich den **Empfänger**-Knoten in die Arbeitsfläche.
4. Wählen Sie in der Drop-down-Liste **Empfängerlisten** Ihre Transaktions-Empfängerliste aus.
:::hint{type="info"}
**Note**
Die [Kundenbetreuung](https://support.optimizely.com/hc/de/articles/4413200618253) hat für Sie eine gesonderte Transaktions-Empfängerliste 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 der linken Seitenleiste 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*).
7. Klicken Sie im Kontextmenü des Nachrichtenknotens auf **Inhalt bearbeiten**.
8. Wählen Sie aus der 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 Magento-2-Vorlage gelieferten Variablen erscheinen sollen, die entsprechende Feldfunktion für das Empfängerlistenfeld der Transaktions-Empfängerliste ein (siehe [Beispiel](docId\:mp8k3Cs-GGQCkUHg6hAZu) 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 damit den Versand zu starten, wählen Sie sie in der Übersicht aus und klicken Sie auf **Starten**.
### Schritt 3: Vorlage in Magento 2 erstellen
Erstellen Sie in Magento 2 die Vorlage, die die Variablen über die HTTP-API an Optimizely Campaign sendet.
### Voraussetzungen
- **Autorisierungs-Code**. Für Ihre Transaktions-Empfängerliste in Optimizely Campaign.
Wählen Sie im Optimizely Campaign [Menü](https://support.optimizely.com/hc/de/articles/4413200452237#heading-3) **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**.
### Konfigurationsmöglichkeiten
Sie haben zwei Möglichkeiten, in Ihrem Magento-2-System eine Vorlage zur Variablen-Übergabe zu konfigurieren:
1. Verwenden Sie eine in der Standard-Installation von Magento 2 enthaltene Vorlage und passen diese an Ihre Anforderungen an. Wenn Sie sich für diese Option entscheiden, wird der HTML-Code der Vorlage in das Feld **Template Content** geladen. Der Code enthält die zur Verfügung stehenden Variablen, wie beispielsweise `{{trans "%name," name=$customer.name}}` (zur Anrede des Kunden mit seinem Namen). Bereinigen Sie die Vorlage vollständig um den HTML-Code und reduzieren Sie die Vorlage auf die Variablen. Mappen Sie im nächsten Schritt die entsprechenden Empfängerlistenfelder Ihrer Transaktions-Empfängerliste in Optimizely Campaign. Weitere Informationen finden Sie unter **Mappen ("Zuweisen"): So gehen Sie vor** (siehe Schritt 7 unten).
2. Erstellen Sie eine neue, leere Vorlage und fügen die Variablen manuell ein, die an Optimizely Campaign über die HTTP-API gesendet werden sollen.
Folgen Sie den nachfolgenden Schritten, um eine neue, leere Vorlage zu erstellen, die Variablen manuell einzufügen und mit den Empfängerlistenfeldern Ihrer Transaktions-Empfängerliste zu mappen.
1. Melden Sie sich in Magento-2 mit Administrator-Rechten an.
2. Wählen Sie **Marketing** > **Email Templates**.
:::hint{type="info"}
**Note**
Wenn Sie Vorlagen erstellen beziehungsweise bereits erstellt haben, die an Optimizely Campaign versendet werden, werden diese als Vorlagentyp **Episerver** angezeigt.
:::
3\. Klicken Sie auf **Add New Template**.
4\. Geben Sie im Bereich **Template Information** die folgenden Daten ein:
- **Template Name**. Geben Sie einen Namen für die neue Vorlage ein.
- **Template Subject**. Lassen Sie das Feld frei. Der Betreff wird später automatisch ausgefüllt – mit dem Betreff der Vorlage, die Sie in Optimizely Campaign erstellt haben.
- **Episerver Campaign**. Wählen Sie **Enabled** aus.
- **Authorisation Code**. Geben Sie den Autorisierungs-Code der Transaktions-Empfängerliste in Optimizely Campaign ein.
- **bmMailingId**. Geben Sie die Mailing-ID der Vorlage in Optimizely Campaign ein.
5\. Geben Sie im Feld **Template Information** ein, welche Variablen aus dem Magento-2-System an welches Empfängerlistenfeld der Transaktions-Empfängerliste in Optimizely Campaign übertragen werden sollen. Um eine Variable hinzuzufügen, klicken Sie auf **Insert Variable...**
6\. Klicken Sie auf die gewünschte Variable.
7\. Mappen Sie die eingefügte Variable mit dem entsprechenden Empfängerlistenfeld in Optimizely Campaign und fügen Sie bei Bedarf weitere Variablen hinzu, indem Sie auf **Insert Variable...** klicken.
**Mappen: So gehen Sie vor**
Die Magento-2-Integration von Optimizely Campaign verwendet folgenden Aufbau für das Mapping:
```html
Name des Empfängerlistenfeldes=Name der Magento-2-Variablen
```
Geben Sie die Mapping-Anweisung für jede Variable zeilenweise ein und trennen Sie die einzelnen Variablen/Mapping-Anweisungen mit einem Zeilenumbruch.
**Beispiel:**
```html
lastname={{config path="trans_email/ident_custom1/name"}}
url={{config path="web/secure/base_url"}}
```
Mit den beiden Beispielzeilen mappen und übertragen Sie:
- in das Transaktions-Empfängerlistenfeld **lastname** den Wert der Magento-2-Variablen `{{config path="trans_email/ident_custom1/name"}}`
- in das Transaktions-Empfängerlistenfeld **url** den Wert der Magento-2-Variablen `{{config path="web/secure/base_url"}}`
8\. Klicken Sie auf **Save Template**.
9\. Wenn Sie die Vorlage in Ihrem Magento-2-System erstellt haben, müssen Sie diese aktivieren und einem Ereignis (zum Beispiel einem Bestell-Vorgang, einer Newsletter-Anmeldung und so weiter) zuweisen. An welcher Stelle in der Admin-Oberfläche Sie die Vorlage einem Ereignis zuweisen und aktivieren, ist vom Typ des Ereignisses abhängig.
**Beispiel**: Um die Vorlage dem Ereignis-Typ **Bestellung** zuzuweisen und zu aktivieren, führen Sie die folgenden Schritte aus:
1. Wechseln Sie zu **Stores** > **Configuration**.
2. Klicken Sie im linken Bildschirmbereich auf **Sales** > **Sales Emails**.
3. Aktivieren Sie die Vorlage, indem Sie diese im Bereich **Order** in der Drop-down-Liste **New Order Confirmation Template** auswählen.
4. Speichern Sie Ihre Änderungen.
### Schritt 4: Transaktions-Mails konfigurieren und Magento-2-Variablen übertragen
Um die Rechnungsanschrift, die Lieferanschrift und die Bestellungen eines Kunden mit der Vorlage in Magento 2 zur Vorlage in Optimizely Campaign zu übertragen, müssen Sie weitere Konfigurationen vornehmen und u. a. eine [spezielle Feldfunktion](docId\:mp8k3Cs-GGQCkUHg6hAZu) (für den Zugriff auf Bestellungen) in Ihrem Optimizely Campaign Mandanten erstellen.
:::hint{type="info"}
**Note**
Magento 2 stellt die Rechnungsanschrift, die Lieferanschrift und die Bestellungen eines Kunden nicht als einfachen Text in einzelnen Variablen zur Verfügung, sondern als HTML-Code. Der HTML-Code muss in einfachen Text umgewandelt werden, damit Optimizely Campaign die Informationen verarbeiten kann.
:::
## HTML-Codes in einfachen Text umwandeln
Zur Umwandlung des HTML-Codes in einfachen Text stellt die Magento-2-Integration drei Funktionen zur Verfügung:
### getOptivoBillingData( )
Mit der Funktion `getOptivoBillingData( )` erhalten Sie Zugriff auf die einzelnen Parameter der Rechnungsanschrift. Die Funktion steht Ihnen über die folgende Anweisung zur Verfügung, hier beispielhaft für die Anrede des Kunden:
```html
{{var order.getOptivoBillingData('salutation')}}
```
Mit dem Mapping folgenden übertragen Sie in das Empfängerlistenfeld **salutation** den Rückgabewert des Funktionsaufrufs (Parameter **salutation**) als einfachen Text:
```html
salutation={{var order.getOptivoBillingData('salutation')}}
```
### Parameter für getOptivoBillingData( )
| Nr. | Parameter | Beschreibung |
| --- | ---------- | ----------------- |
| 1 | salutation | Anrede |
| 2 | firstname | Vorname |
| 3 | middlename | zweiter Vorname |
| 4 | lastname | Nachname |
| 5 | company | Firma |
| 6 | email | E-Mail-Adresse |
| 7 | telephone | Telefonnummer |
| 8 | suffix | Durchwahl |
| 9 | fax | Faxnummer |
| 10 | street | Straße |
| 11 | postcode | Postleitzahl |
| 12 | city | Stadt |
| 13 | region | Region/Bundesland |
| 14 | country | Land |
### getOptivoShippingData()
Mit der Funktion `getOptivoShippingData( )` erhalten Sie Zugriff auf die einzelnen Parameter der Lieferanschrift des Kunden. Die Funktion steht Ihnen über die folgende Anweisung zur Verfügung, hier beispielhaft für den Nachnamen des Kunden:
```html
{{var order.getOptivoShippingData('lastname')}}
```
Mit dem folgenden Mapping übertragen Sie in das Empfängerlistenfeld **lastname** den Rückgabewert des Funktionsaufrufs (Parameter **lastname**) als einfachen Text:
```html
lastname={{var order.getOptivoShippingData('lastname')}}
```
### Parameter für getOptivoShippingData()
| Nr. | Parameter | Beschreibung |
| --- | ---------- | ----------------- |
| 1 | salutation | Anrede |
| 2 | firstname | Vorname |
| 3 | middlename | zweiter Vorname |
| 4 | lastname | Nachname |
| 5 | company | Firma |
| 6 | email | E-Mail-Adresse |
| 7 | telephone | Telefonnummer |
| 8 | suffix | Durchwahl |
| 9 | fax | Faxnummer |
| 10 | street | Straße |
| 11 | postcode | Postleitzahl |
| 12 | city | Stadt |
| 13 | region | Region/Bundesland |
| 14 | country | Land |
### getOptivoOrderData()
Mit der Funktion `getOptivoOrderData( )` erhalten Sie Zugriff auf die Bestellungen des Kunden.
:::hint{type="info"}
**Note**
Die Funktion zum Zugriff auf Bestellungen unterscheidet sich von den Funktionen zum Zugriff auf die Rechnungsanschrift und die Lieferanschrift. Sie übergeben nicht einzelne Parameter an jeweils ein Empängerlistenfeld, sondern eine Liste mit mehreren Parametern an ein einzelnes Empfängerlistenfeld.
:::
Die Funktion steht Ihnen über die folgende Anweisung zur Verfügung, hier beispielhaft für Produkt-ID, Lagereinheit, Produktname, bestellte Menge und Preis:
```html
{{var order.getOptivoOrderData('product_id','sku','name','qty_ordered','price')}}
```
Mit dem Mapping folgenden übertragen Sie in das Empfängerlistenfeld **order\_positions\_csv** eine Zeichenfolge mit den genannten Bestellinformationen:
```html
order_positions_csv={{var order.getOptivoOrderData('product_id','sku','name','qty_ordered','price')}}
```
### Parameter für getOptivoOrderData()
- increment\_id
- state
- status
- coupon\_code
- shipping\_description
- is\_virtual
- store\_id
- base\_discount\_amount
- base\_discount\_canceled
- base\_discount\_invoiced
- base\_discount\_refunded
- base\_grand\_total
- base\_shipping\_amount
- base\_shipping\_canceled
- base\_shipping\_invoiced
- base\_shipping\_refunded
- base\_shipping\_tax\_amount
- base\_shipping\_tax\_refunded
- base\_subtotal
- base\_subtotal\_canceled
- base\_subtotal\_invoiced
- base\_subtotal\_refunded
- base\_tax\_amount
- base\_tax\_canceled
- base\_tax\_invoiced
- base\_tax\_refunded
- base\_to\_global\_rate
- base\_to\_order\_rate
- base\_total\_canceled
- base\_total\_invoiced
- base\_total\_invoiced\_cost
- base\_total\_offline\_refunded
- base\_total\_online\_refunded
- base\_total\_paid
- base\_total\_qty\_ordered
- base\_total\_refunded
- discount\_amount
- discount\_canceled
- discount\_invoiced
- discount\_refunded
- grand\_total
- shipping\_amount
- shipping\_canceled
- shipping\_invoiced
- shipping\_refunded
- shipping\_tax\_amount
- shipping\_tax\_refunded
- store\_to\_base\_rate
- store\_to\_order\_rate
- subtotal
- subtotal\_canceled
- subtotal\_invoiced
- subtotal\_refunded
- tax\_amount
- tax\_canceled
- tax\_invoiced
- tax\_refunded
- total\_canceled
- total\_invoiced
- total\_offline\_refunded
- total\_online\_refunded
- total\_paid
- total\_qty\_ordered
- total\_refunded
- base\_shipping\_discount\_amount
- base\_subtotal\_incl\_tax
- base\_total\_due
- shipping\_discount\_amount
- subtotal\_incl\_tax
- total\_due
- base\_currency\_code
- discount\_description
- global\_currency\_code
- order\_currency\_code
- shipping\_method
- store\_currency\_code
- store\_name
- customer\_note
- created\_at
- updated\_at
- total\_item\_count
- shipping\_incl\_tax
- base\_shipping\_incl\_tax
- coupon\_rule\_name
Nach der Übertragung zu Optimizely Campaign werden die einzelnen Parameter im Empfängerlistenfeld Ihrer Transaktions-Empfängerliste durch ein *Semikolon* getrennt. Wenn mehrere Produkte übertragen wurden, werden die einzelnen Produkte durch einen Zeilenumbruch getrennt. Die in das Empfängerlistenfeld geschriebene Zeichenfolge entspricht dem Aufbau einer Tabelle, die im *CSV-Format* gespeichert wurde.
## Spezielle Feldfunktion für Bestelldaten erstellen
Wenn Sie *Bestelldaten* in einer Transaktions-Mail verwenden möchten, müssen Sie eine neue, spezielle Feldfunktion in Ihrem Optimizely Campaign Mandanten erstellen. Diese muss die Template-Engine von Optimizely Campaign nutzen, um die Zeichenfolge in HTML zu überführen. Folgen Sie dazu den folgenden Schritten:
1. Wählen Sie im Optimizely Campaign [Menü](https://support.optimizely.com/hc/de/articles/4413200452237#heading-3) **Verwaltung** > **Feldfunktionen**.
:::hint{type="success"}
**Tip**
Sollte der Menüpunkt **Feldfunktionen** nicht in Ihrem Mandanten verfügbar sein, wenden Sie sich an die [Kundenbetreuung](https://support.optimizely.com/hc/de/articles/4413200618253).
:::
2. Klicken Sie auf **Hinzufügen**.
3. Geben Sie unter **Allgemein** im Feld **Name** einen prägnanten Namen für die neue Feldfunktion ein, z. B. **CSVBestellObjekte**.
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
| Produkt-ID | SKU | Name | Anzahl | Preis |
#set ($csvContent = $csv.readFromString($user.data.order_positions_csv))#foreach($row in $csvContent) #foreach($item in $row) | $item | #end
#end
```
6\. Klicken Sie auf **Speichern**.
Fügen Sie die Feldfunktion an der gewünschten Stelle in der Optimizely-Vorlage ein. Wenn die Transaktions-Mail versendet wird und das Empfängerlistenfeld **order\_positions\_csv** 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 Die das Layout der Tabelle an Ihre Anforderungen anpassen. Sehen Sie dazu auch [Feldfunktionen](https://support.optimizely.com/hc/de/articles/4413192205325).
:::