---
title: Einleitung zur Magento-1-Integration
slug: campaign/docs/einleitung-zur-magento-1-integration
docTags:
createdAt: 2026-08-06T15:53:54.252Z
---
:::hint{type="info"}
**Note**
Die Magento-1-Integration wird nicht weiter mit Updates unterstützt. Updates finden nur noch für die Magento-2-Integration statt.
:::
:::hint{type="info"}
**Note**
Dieses Kapitel richtet sich an Administratoren und Entwickler mit Administratorrechten in Magento 1.
:::
Wenn Sie Magento 1 als E-Commerce-Plattform nutzen, können Sie Magento 1 an Optimizely Campaign anbinden und Ihre Shop-Kundendaten über die Optimizely-E-Mail-Marketing-Plattform verwalten. Die gesamte Empfängerverwaltung von der Registrierung über den Opt-In-Prozess bis zur Aktualisierung der Empfängerdaten und der Abbestellungen wird in Optimizely Campaign durchgeführt. Die Integration ermöglicht den schnellen und sicheren Versand von Transaktions-Mails sowie von regulären E-Mail-Kampagnen über Optimizelys Server. Sie können darüber hinaus Produktdaten in Optimizely Campaign importieren und diese zur professionellen Produktdarstellung in Ihren Remarketing-Kampagnen oder Empfehlungen nutzen.
## Unterstützte Versionen
| Magento CE | | Magento EE | |
| ---------- | - | ---------- | - |
| 1.7 | ✓ | 1.12 | ✓ |
| 1.8 | ✓ | 1.13 | ✓ |
| 1.9 | ✓ | 1.14 | ✓ |
## Installation
Die Installation sollte von einem Administrator oder Dev-Operator durchgeführt werden. Zur Nutzung der Integration müssen Sie die Optimizely Campaign Extension in Magento installieren. Dazu benötigen Sie auf Ihrem Magento-Server mindestens **PHP 5.3** sowie **phpseclib 0.3.6** (die offizielle Distribution ab Version 0.3.6.). Diese können Sie über PEAR installieren: [http://phpseclib.sourceforge.net/pear.htm](http://phpseclib.sourceforge.net/pear.htm)
Installieren Sie die Optimizely Campaign Extension über das Dateisystem. Sie benötigen dazu eine FTP-Verbindung zu Ihrem Server, um das Installationspaket zu übertragen. Gehen Sie wie folgt vor:
1. Entpacken Sie das ZIP-Archiv lokal auf Ihrem PC.
2. Stellen Sie eine FTP-Verbindung zu Ihrem Magento-Server her.
3. Kopieren Sie den Ordner **app** in Ihren Magento-Server.
:::hint{type="info"}
**Note**
Die Installation und Konfiguration sollte zuerst in einer nicht-produktiven (Live-)Umgebung durchgeführt und getestet werden.
:::
## Konfiguration in Optimizely Campaign
Bei der Einrichtung Ihrer Optimizely Campaign Extension sollten Ihnen einige Daten für die Konfiguration vorliegen. Falls Sie mit einer Magento-Installation mehrere Storeviews, Stores und/oder Webseiten betreiben, finden Sie im Kapitel [Mehrere Mandanten konfigurieren](docId\:d6mJVzm3DqGo5bJhBKn_k) weitere Informationen.
Melden Sie sich in Ihrem Optimizely Campaign Mandanten an und wählen Sie den gewünschten Mandanten aus. Kopieren Sie die folgenden IDs und Codes:
- **Mandanten-ID**. Wählen Sie im Optimizely Campaign [Menü](docId\:PmNPgvNucBrAG5Rw8f41f) **Verwaltung** > **API-Übersicht** > **REST-API**.
- **Autorisierungs-Code**. Wählen Sie im Optimizely Campaign [Menü](docId\:PmNPgvNucBrAG5Rw8f41f) **Verwaltung** > **API-Übersicht** > **Empfängerlisten**. Wählen Sie die gewünschte Empfängerliste aus und klicken Sie auf **Autorisierungs-Codes verwalten**. Sollte für die gewählte Liste noch kein Code angelegt sein, klicken Sie auf **Autorisierungscode erstellen**.
- **Opt-In-ID**. Wählen Sie im Optimizely Campaign Menü **Verwaltung** > **API-Übersicht** > **Opt-In-Prozesse**. Wählen Sie den Opt-In-Prozess aus, den Sie für den Magento-Shop verwenden möchten (siehe folgender Abschnitt).
- **Opt-In-Link**. Bearbeiten Sie das System-Mailing, das Sie zur Anmeldebestätigung (Opt-In) der Kunden aus dem Magento-Shop nutzen möchten und ersetzen Sie darin die Standard-Feldfunktion für den Opt-In-Link: `{Double-Opt-In-Link}` durch den parametrisierten Ausdruck: `{Double-Opt-In-Link}?id={bmecssid}&code={bmecsscc}`
Die weitere Konfiguration in Optimizely Campaign nimmt die [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV) für Sie vor. Dazu benötigt Optimizely folgende Angaben aus Ihrem Magento-Shop:
- **IP-Adresse Ihres Magento-Shops**. Wird in Ihrem Mandanten hinterlegt.
- **Weiterleitungs-E-Mail-Adresse**. Sollte eine administrative E-Mail-Adresse sein, an die ARF-Reports, Bounces, Spam, Autoresponder und Antworten geschickt werden.
- **Versanddomäne Ihres Shops**. Muss an Optimizely delegiert werden und wird als Versanddomäne in Ihrem Mandanten hinterlegt.
## Empfängerdaten importieren
Bei Einrichtung der Magento-Integration legt die Kundenbetreuung eine Empfängerliste mit den Standardfeldern aus Magento in Ihrem Optimizely Campaign Mandanten an. Die Empfängerliste enthält folgende Felder:
| Feldname | Datentyp | Beschreibung |
| ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| email | String | E-Mail-Adresse |
| salutation | String | Anrede |
| firstname | String | Vorname |
| lastname | String | Nachname |
| language | String | ISO-Code für die Sprache. Hier wird stets die Sprache aus dem StoreView verwendet, über das sich der Benutzer registriert hat. |
| street | String | Straße |
| zip | String | Postleitzahl oder internationaler ZIP-Code |
| city | String | Stadt |
| state | String | Bundesland |
| country | String | Land |
Außer der E-Mail-Adresse und der automatischen Sprache sind alle Felder optional. Um die oben genannten Daten zu erhalten, erstellen Sie ein erweitertes [Anmeldeformular](docId\:d6mJVzm3DqGo5bJhBKn_k) beziehungsweise ein Profil-bearbeiten-Formular und binden Sie dieses in Ihre Shop-Seiten ein.
## Weitere Empfängerdatenfelder anlegen und übertragen
Sie können in Magento weitere Empfängerdaten, so genannte Kundenattribute, speichern und diese an Optimizely Campaign übertragen. Die Kundenattribute ermöglichen es Ihnen, Ihre Kundenansprache nach Ihren Wünschen und Anforderungen anzupassen. Sie können Kundenattribute zur Personalisierung von Newsletter-Inhalten oder zur Bildung von qualitativen Kundensegmenten nutzen.
:::hint{type="info"}
**Note**
In der Magento Community Edition steht die Funktion zum Anlegen weiterer Kundenattribute (Schritte 1-7) nicht zur Verfügung. Für die Community Edition stehen Ihnen Extensions von Drittanbietern zur Verfügung, die die Konfiguration der Attribute im Browser nachrüsten.
:::
1. Wählen Sie im Menü **Kunden** > **Attribute** > **Kundenattribute verwalten**.
2. Klicken auf **Neue Attribute hinzufügen** und definieren Sie zunächst die **Eigenschaften**:
3. Geben Sie im Feld **Attributcode** einen uniquen internen Namen ein.
4. Wählen Sie im Feld **Eingabetyp** einen Datentyp aus.
:::hint{type="info"}
**Note**
Für die Übertragung an Optimizely Campaign werden nur die Feldtypen *TextField*, *Text Area*, *Date* oder *Ja*/*Nein* unterstützt.
:::
5. Definieren Sie die weiteren Angaben für das Kundenattribut wie gewünscht.
6. Wechseln Sie zum Reiter **Bezeichnung/Optionen verwalten** und definieren Sie die Bezeichnung des Kundenattributs, so wie sie im Admin-Bereich und in den verschiedenen Sprachen angezeigt werden soll. Sie müssen mindestens eine Bezeichnung im Feld **Admin** eingeben. Wenn Sie die übrigen Felder leer lassen, wird die Bezeichnung aus dem Feld **Admin** als Standard für alle anderen verwendet.
7. Klicken Sie auf **Attribut speichern**.
8. Wechseln Sie zum Menü **System** > **Konfiguration** > optivobroadmail.
9. Öffnen Sie das Panel **HTTP-API** und wählen Sie aus der Liste **Zusätzliche Kunden-Attribute übertragen** alle Kundenattribute aus, die an Optimizely Campaign gesendet werden sollen. Halten Sie die STRG-Taste gedrückt, um mehrere Attribute auszuwählen.
10. Klicken Sie auf **Konfig. speichern**, um die Änderungen zu übernehmen. Die ausgewählten Attribute werden nun bei jedem HTTP-API-Aufruf an Optimizely Campaign übertragen.
11. Um die übertragenen Daten verarbeiten zu können, teilen Sie der Optimizely[ Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV) den Feldnamen und -typ des Kundenattributs mit, damit die Empfängerlisten in Ihrem Optimizely Campaign Mandanten entsprechend angepasst werden. Sobald diese Anpassung erfolgt ist, steht Ihnen dieses Feld in Optimizely Campaign zur Verfügung, um beispielsweise Personalisierungen im Newsletter vorzunehmen oder Zielgruppen auf Basis dieser Kundenattribute zu erstellen.
## Produktdaten in Vorlage importieren
Wenn Sie den [Produktdatenexport](docId\:d6mJVzm3DqGo5bJhBKn_k) in Magento konfigurieren, benötigen Sie in Optimizely Campaign eine entsprechend ausgestattete [Nachrichtenvorlage](docId\:U4doAsilJp9v7hCuah63u) mit einer Content-Schnittstelle, um die importierten Daten in Ihre Mailings einzubinden (beispielsweise in Form von Empfehlungen oder Cross- und Upselling-Angeboten).
:::hint{type="info"}
**Note**
Eine individuelle Vorlage und die Content-Schnittstelle sind Zusatzfunktionen und gehören nicht zum Standardlieferumfang der Magento-Integration. Wenden Sie sich für weitere Informationen an die [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV).
:::
Die Magento-Integration überträgt folgende Produktdaten an Optimizely Campaign:
| Feldname | Datentyp | Beschreibung |
| ------------------- | -------- | --------------------------------- |
| id | Long | Produkt-ID |
| name | String | Produktbezeichnung |
| category | String | Produktkategorie (absoluter Pfad) |
| description | String | Produktbeschreibung |
| short\_description | String | Kurzbeschreibung des Produkts |
| sku | String | Artikelnummer |
| product\_url | String | URL zur Produkt-Landing-Page |
| price | String | Produktpreis |
| special\_price | String | Angebotspreis |
| special\_from\_date | String | Angebot gültig von |
| special\_to\_date | String | Angebot gültig bis |
| base\_image | String | Produktbild |
| small\_image | String | Verkleinertes Produktbild |
| thumbnail | String | Thumbnail-Bild |
## Konfiguration in Magento
Öffnen Sie in Magento die System-Konfiguration und wählen Sie dort im Menü optivo den Menüpunkt optivo broadmail aus.
:::hint{type="info"}
**Tip**
Sollte beim Aufruf eine 404-Fehlermeldung (Seite nicht gefunden) erscheinen, melden Sie sich ab und anschließend wieder an.
:::
### Allgemein
Öffnen Sie den Bereich **Allgemein** und füllen Sie die Felder mit den Daten aus, die Sie im vorherigen Schritt aus Ihrem Optimizely Campaign Mandanten kopiert haben:
- **Client ID**. Mandanten-ID
- **Client Name**. Tragen Sie optional den Namen Ihres Optimizely Campaign Mandanten ein. Das Feld dient zur Orientierung, da sich die Mandanten-ID schwierig merken lässt.
- **Authorisation Code**. Autorisierungs-Code
- **Opt-In-Id**. Opt-In-ID
### HTTP-API
Öffnen Sie den Bereich **HTTP-API** und geben Sie die URL der Bestätigungsseite für das Double Opt-In ein sowie in das zweite Feld die URL der Bestätigungsseite für den Abmeldeprozess:
:::hint{type="info"}
**Tip**
Die CMS-Seite für die Bestätigung (Newsletter Confirm Page) oder Abmeldung (Newsletter Unsubscribe Page) kann auch eine speziell für diesen Fall erstellte CMS-Seite sein.
:::
### SMTP-API
Öffnen Sie den Bereich **SMTP-API** und wählen Sie aus, ob Sie die Optimizely Campaign SMTP-API für den Versand von Transaktions-E-Mails nutzen möchten. Wenn Sie hier **Ja** ausgewählt haben, geben Sie in die folgenden Felder die entsprechenden Daten ein:
- **Benutzername des API-Benutzers**. Erhalten Sie von der [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV).
- **Passwort des API-Benutzers**. Erhalten Sie von der [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV).
Sie müssen auch in Magento die **Store E-Mail-Adressen** konfigurieren. Öffnen Sie den Menüpunkt **Store E-Mail-Adressen** und legen Sie für die hier angegebenen E-Mail-Adressen die Domain fest, die Sie im Zuge der SMTP-Einrichtung an Optimizely delegiert haben.
### FTP-API
Öffnen Sie den Bereich **FTP-API (Product Export)** und wählen Sie aus, ob Sie den Produktdatenexport nach Optimizely Campaign aktivieren möchten. Wenn Sie hier **Ja** gewählt haben, füllen Sie die folgenden Datenfelder mit den entsprechenden Angaben aus:
- **Benutzername des API-Benutzers**. Diesen erhalten Sie von der [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV).
- **Private Key is encrypted**. Wählen Sie in der Drop-down-Liste **Ja** aus.
- **Private Key**. Für den Datenaustausch per SFTP müssen Sie ein Schlüsselpaar generieren. Lesen Sie dazu das Dokument [FTP-Zugriff über SCP](docId\:H7Xzu5E_o_7p1bt9Uk4Ty). Tragen Sie den Private-Key hier ein und übermittelt Sie den Public-Key an Optimizely.
- **Daily Export at**. Wählen Sie hier die Uhrzeit aus, zu der der tägliche Produktdatenexport gestartet werden soll.
### Transaktions-Mail-Adresse
Wählen Sie in der System-Konfiguration im Menü **Allgemein** den Menüpunkt **Store E-Mail-Adressen** aus. Öffnen Sie die Versandadresse, die Sie für Ihre Transaktions-Mails über Optimizely Campaign nutzen möchten und geben Sie dort einen Absendernamen und eine Absenderadresse ein. Standardmäßig wird die Versandadresse **Verkaufsmitarbeiter** für Transaktions-Mails (z. B. Bestellbestätigungen) verwendet. Sie können auch eine andere Versandadresse dazu konfigurieren (z. B. *Angepasste Email 1*). Um diese Versandadresse für Transaktions-Mails zu hinterlegen, wechseln Sie zum Menüpunkt **Verkaufs-E-Mails** im Bereich **Verkäufe** und wählen Sie dort die entsprechende Versandadresse für jede Verkaufsaktion aus.
:::hint{type="info"}
**Note**
Die Versanddomäne der Transaktions-Mails muss an Optimizely delegiert und in Ihrem Optimizely Campaign Mandanten ebenfalls als Versanddomäne hinterlegt werden. Die Verwaltung der delegierten Domain wird von Optimizely übernommen. Verwenden Sie daher nicht die Hauptdomäne Ihres Shops (zum Beispiel example.com), sondern eine Subdomäne für Transaktions-Mails einzurichten (zum Beispiel transactions.example.com) und diese zu delegieren.
:::
## Transaktions-Mails konfigurieren
Sie können für alle Aktionen im Shop (Bestellungen, Versendungen, Änderungen von Kunden- und Versanddaten und so weiter) den Versand von Transaktions-Mails über Optimizely Campaign konfigurieren. Dazu müssen Sie die entsprechenden Vorlagen in Ihrem Magento-Shop anpassen beispielsweise neue Vorlagen erstellen. Um eine Vorlage zu erstellen, führen Sie die folgenden Schritte aus:
1. Wählen Sie im Menü **System** > **E-Mails zur Transaktion**. Es werden alle Vorlagen für Transaktions-Mails in einer Tabelle angezeigt.
:::hint{type="info"}
**Note**
In der Spalte **Vorlagentyp** sehen Sie, ob eine Vorlage für den Versand über den Magento-Shop (Vorlagentyp: HTML) oder über Optimizely Campaign (Vorlagentyp: optivo) konfiguriert wurde. Sie können den Vorlagentyp ändern und Vorlagen, die für den Versand über den Magento-Shop konfiguriert sind, über Optimizely Campaign versenden. Gehen Sie dazu genauso vor, wie ab Schritt 6 beschrieben.
:::
2. Um eine neue Vorlage zu erstellen, klicken Sie auf **Neue Vorlage hinzufügen** und wählen Sie im Bereich **Standardvorlage wählen** eine Vorlage aus. Magento selbst kann keine leere Vorlage erstellen.
3. Wählen Sie in der darunter liegenden Drop-down-Liste ein Gebietsschema aus. Dieses Schema bestimmt die Formatierung von Preisen und Datumsangaben.
4. Klicken Sie auf **Vorlage laden**, um den Inhalt zu übernehmen.
5. Geben Sie im Bereich **Vorlageninformationen** einen Vorlagennamen ein. Dieser Name wird nur intern verwendet.
6. Aktivieren Sie das Kontrollkästchen **mit** optivo broadmail **versenden**. Die beiden neuen Felder optivo **authcode** und optivo **bmmailid** werden nun angezeigt.
7. Tragen Sie im Feld optivo **authcode** den Autorisierungs-Code für die Empfängerliste ein, die für die Transaktions-Mail verwendet werden soll.
1. Wählen Sie im Optimizely Campaign [Menü](docId\:PmNPgvNucBrAG5Rw8f41f) **Verwaltung** > **API-Übersicht** > Reiter **Empfängerlisten**.
2. Wählen Sie eine Empfängerliste aus und klicken Sie auf **Autorisierungs-Codes verwalten**. In einem neuen Fenster öffnet sich eine Liste mit den Autorisierungs-Codes für die gewählte Empfängerliste.
3. Kopieren Sie die ID des gewünschten Autorisierungs-Codes und tragen Sie diese in Magento in das entsprechende Feld ein. Wenn für die Empfängerliste noch kein Autorisierungs-Code vorhanden ist, klicken Sie auf **Autorisierungs-Code erstellen**, um einen neuen Code zu generieren.
8. Tragen Sie im Feld optivo **bmmailid** die ID der Transaktions-Mail in Optimizely Campaign ein, die Sie mit dieser Transaktion versenden möchten. Die Transaktions-Mail müssen Sie zuvor in Ihrem Optimizely Campaign Mandanten anlegen. Lesen Sie dazu das Kapitel [Transaktions-Mails](docId:6JbMqxBf1Te6K0YPlNSxo).
9. Entfernen Sie den HTML-Code aus dem Feld **Vorlageninhalt**.
10. Tragen Sie alle Empfängerparameter, die Sie mit dieser Vorlage an Optimizely Campaign übergeben möchten, nach folgendem Schema ein:
```html
[parameter]={{var order.getOptivoBillingData('[variable]')}}
```
:::hint{type="info" indent="2"}
**Note**
Der String \[parameter] muss durch den Namen des Parameters in Optimizely Campaign ersetzt werden, der String \[variable] durch den Namen der Variablen, die Magento für das Bestellobjekt zur Verfügung stellt. Die Zeile `lastname={{var order.getOptivoBillingData('lastname')}}` übergibt beispielsweise den Nachnamen des Empfängers an Optimizely Campaign. Eine vollständige Liste aller verfügbaren Empfängerparameter finden Sie im Kapitel [Empfänger und Rechnungsdaten](docId\:F5nz2hX78AGPPbQWO0ZxW).
:::
11. Um einen weiteren Parameter einzufügen, beginnen Sie mit einer neuen Zeile.
12. Neben den mit der Funktion `getOptivoBillingData` verfügbaren Variablen können Sie auch die Shop-spezifischen Standardvariablen an Optimizely Campaign übergeben, um diese in der Transaktions-Mail zu verwenden. Verwenden Sie dafür das folgende Schema:
```html
[parameter]=[variable]
```
:::hint{type="info" indent="2"}
**Note**
Für jede übergebene Variable benötigen Sie ein korrespondierendes Feld **\[parameter]** in der Ziel-Empfängerliste in Optimizely Campaign. Um eine Variable einzufügen, klicken Sie auf **Variable einfügen...** und wählen Sie die gewünschte Variable aus der Liste aus. Beispielsweise übergibt die Zeile `resetPassword={{htmlescape var=$customer.password}}` ein neues Passwort an das Feld `resetPassword`. Sie können damit eine Transaktions-Mail an Empfänger verschicken, die ein neues Passwort angefordert haben.
:::
13. Tragen Sie ebenfalls alle Bestellpositionen, die Sie mit dieser Vorlage an Optimizely Campaign übergeben möchten, nach folgendem Schema ein:
```php
orderPositions={{var order.getOptivoProducts('product_id','sku','name','price','qty_ordered)}}
```
:::Paragraph{indent="1"}
Die fünf Standardparameter (*Produkt-ID*, *Bestellnummer*, *Name*, *Preis* und *Anzahl*) werden nach dem obigen Schema übergeben. Wenn Sie einen dieser Parameter nicht benötigen, können Sie ihn aus dem Schema entfernen. Wenn Sie weitere Bestellparameter übergeben möchten, müssen Sie dafür eine eigene Vorlage programmieren. Eine Liste der verfügbaren Bestellparameter und Hinweise zur Vorlage finden Sie im Kapitel [Bestellungsdetails](docId\:eswx17oy22kT4c4YwA2es).
:::
:::hint{type="info" indent="2"}
**Note**
Sie benötigen PHP-Kenntnisse und Kenntnisse des Magento-Objektmodells zur Programmierung.
:::
14. Klicken Sie auf **Vorlage speichern**.
:::hint{type="info"}
**Note**
Die Vorlage ist nach dem Speichern noch nicht aktiv. Es werden keine Transaktions-Mails damit versendet.
:::
15. Um die Vorlage zu aktivieren und mit einer Aktion zu verknüpfen, öffnen Sie im Menü **System** > **Konfiguration**.
16. Suchen Sie im linken Menü den Abschnitt **Verkäufe** und klicken Sie auf **Verkaufs-E-Mails**. Es werden alle Aktionen angezeigt, die einen Transaktions-Mail-Versand auslösen.
17. Öffnen Sie das Panel der gewünschten Aktion und wählen aus den Drop-down-Listen für die Vorlagen (es gibt jeweils eine Vorlage für angemeldete Benutzer und Gäste) die gewünschte Vorlage aus.
## Mehrere Mandanten konfigurieren
Magento und Optimizely Campaign bieten die Möglichkeit, mehrere Mandanten abzubilden. Nehmen Sie die Konfiguration jedes einzelnen Mandanten genau so vor, wie in den Abschnitten zur [Konfiguration](docId\:d6mJVzm3DqGo5bJhBKn_k) beschrieben. Achten Sie auf die richtige Zuordnung der Mandanten in Optimizely Campaign und Magento. Für jeden Mandanten benötigen Sie die Mandanten-ID, den Mandantennamen, den Autorisierungs-Code und die Opt-In-ID. Die Bestätigungsseiten für das Opt-In und die Abmeldebestätigung können Sie für jeden Mandanten separat konfigurieren oder dieselben URLs für alle Mandanten verwenden. Die Konfiguration für die SMTP-API und die FTP-API ist global und muss nur einmal durchgeführt werden.
:::hint{type="info"}
**Note**
Um die Mandanten in Optimizely Campaign und Magento richtig zuzuordnen, wenden Sie sich an die [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV)
:::
### Mandantenauswahl in Magento
In Magento werden die Mandanten über Webseiten, Stores und Storeviews abgebildet. Mehr Informationen dazu finden Sie im [Benutzerhandbuch](http://www.magentocommerce.com/resources/magento-user-guide) von Magento. Die Mandantenauswahl finden Sie in der Konfiguration oben links:
## Anmeldeformular einbinden
Die Registrierung für Ihren Newsletter erfolgt über das Web-Anmeldeformular auf Ihren Shop-Seiten. Die Registrierungsdaten werden per HTTP-Request an Optimizely Campaign übertragen. Die Standardvorlage für das Anmeldeformular können Sie auf jeder beliebigen CMS-Seite integrieren. Die Anbindung an Optimizely Campaign erfolgt in jedem Fall automatisch, wenn Sie die Standardvorlage verwenden. Für die einfache Newsletter-Registrierung wird im Standardformular lediglich die E-Mail-Adresse abgefragt. Außerdem übergibt Magento automatisch die Sprache, in der der neue Abonnent im Magento-Shop angemeldet ist, an Optimizely Campaign. Diese Informationen können Sie beispielsweise nutzen, um Newsletter in verschiedenen Sprachen zu versenden.
Um weitere Empfängerdaten abzufragen, benötigen Sie ein erweitertes Anmeldeformular. Für ein solches Formular benötigen Sie erweiterte Programmierkenntnisse in HTML. Die Daten, die Sie mit der Integration abfragen und verarbeiten können, finden Sie im Abschnitt [Empfängerdaten importieren](docId\:d6mJVzm3DqGo5bJhBKn_k).
## Anmeldeformular in eine CMS-Seite integrieren
1. Wechseln Sie in der oberen Menüleiste zum Menüpunkt **CMS**.
2. Wechseln Sie in der Übersicht **Seiten** zum Menüpunkt **Inhalt verwalten**.
3. Wählen Sie **Neue Seite hinzufügen** oder bearbeiten Sie eine vorhandene CMS-Seite.
4. Geben Sie im Editorfeld folgenden Code-Schnipsel ein:
```php;
{{block type="core/template" template="newsletter/subscribe.phtml"}}
```
5. Klicken Sie auf **Speichern** beziehungsweise auf **Veröffentlichen**.
## Anmeldeformular in eine Kategorieseite integrieren
1. Wechseln Sie in der oberen Menüleiste zum Menüpunkt **Katalog**.
2. Wechseln Sie in der Übersicht **Kategorien** zum Menüpunkt **Kategorien verwalten**.
3. Wählen Sie die gewünschte Kategorie und optional einen Mandanten aus und wechseln Sie zum Reiter **Eigene Gestaltung**.
4. Je nach Spalten-Layout und der gewünschten Positionierung des Anmeldeformulars geben Sie im Editorfeld folgenden Code-Schnipsel ein:
```php
```
:::Paragraph{indent="1"}
Dieser Code-Schnipsel bindet das Anmeldeformular in der rechten Spalte des Layouts ein. Wenn Sie den Newsletter in der linken Spalte einbinden wollen, ersetzen Sie den Tag
`` durch ``
sowie das Attribut `name="right.newsletter"` durch `name="left.newsletter"`.
Je nach Einbindung und zur korrekten Darstellung auf verschiedenen Endgeräten kann es notwendig sein, Anpassungen im CSS vorzunehmen.
:::
5. Klicken Sie auf **Speichern** beziehungsweise auf **Veröffentlichen**
:::hint{type="info"}
**Note**
**Zusätzliche Integrationsmöglichkeiten**
In diesem Abschnitt wurden nur die Integrationsmöglichkeiten aufgezeigt, die aus dem Backend heraus möglich sind. Darüber hinaus kann die Integration über das Vorlagen-System von Magento nahezu überall stattfinden. Für diese Anpassungen sind Design-Kenntnisse und der Zugriff auf das Dateisystem der Magento-Installation notwendig.
:::
## Fehlerbehandlung
### Magento-Logging aktivieren
Standardmäßig werden allgemeine Logs in die Datei *system.log*, Fehler und Ausnahmen in die Datei *exception.log* geschrieben. Sie können diese Dateinamen im Verzeichnis: *var/log/* ändern.
1. Wählen Sie im Menü **System** > **Konfiguration**.
2. Wählen Sie **Fortgeschritten** > **Developer**.
3. Setzen Sie die Option **Aktiviert** auf **Ja**.
### Entwicklermodul aktivieren
Um Fehler zu analysieren und sicherzustellen, dass ein effektives Logging stattfindet, sollte in Magento der Entwicklermodus über die *.htaccess* oder direkt in der *index.php* von Magento aktiviert werden:
Das Logfile für die Optimizely Campaign Extension befindet sich ebenfalls im Verzeichnis */var/log/* innerhalb der Magento-Installation. Der Name des Logfiles lautet optivo\*\_*broadmail*.log\*.
### Konflikte mit anderen Magento-Erweiterungen
Es können Konflikte zwischen der Optimizely Campaign Extension und anderen Extensions auftreten, sollten diese die gleichen Magento-Core-Funktionalitäten erweitern. Dies kann besonders im Zusammenhang mit anderen Magento-Extensions auftreten, die ebenfalls Newsletter-, SMTP- oder ähnliche Funktionalitäten wie die Optimizely Campaign Extension bereitstellen.
Weiterhin können durch lokale Code-Anpassungen im Code-Pool local weitere Seiteneffekte oder Nebenwirkungen im Zusammenspiel auftreten.
Daher ist bei der Fehleranalyse zu berücksichtigen, welche Extensions und Eigenentwicklungen in die Magento-Installation eingebunden sind.
:::hint{type="info"}
**Tip**
Um solche Konflikte und Fehlfunktionen der Integration auszuschließen, installieren Sie Ihre Magento-Plattform mit der Optimizely Campaign Extension und allen anderen verwendeten Extensions immer zuerst auf einem Testsystem und bilden Sie dort verschiedene Testszenarien ab, bevor Sie diese Installation in eine Produktivumgebung überführen.
:::