Anmeldung und Abmeldung konfigurieren
Note
Dieses Kapitel richtet sich an Administratoren und Entwickler mit Administratorrechten in Magento 2.
Dieses Kapitel beschreibt, wie Sie die Funktion zur Newsletter-Anmeldung und -Abmeldung konfigurieren, wenn Sie Magento als E-Commerce-Plattform mit Anbindung an Optimizely Campaign nutzen. Zudem finden Sie am Ende dieses Kapitels alle benötigten Informationen, wenn Sie weitere Empfängerdaten zu Optimizely Campaign übertragen möchten, die nicht in der Standardkonfiguration der Magento-2-Integration enthalten sind.
Um die Anmeldung und Abmeldung zu konfigurieren, gehen Sie wie folgt vor:
- Konfigurieren Sie das Opt-In-Mailing (die Anmeldebestätigung) in Optimizely Campaign und referenzieren Sie den Bestätigungs-Link mithilfe einer Feldfunktion auf Ihren Shop.
- Erstellen Sie zwei Landing-Pages in Ihrem Magento-2-System, eine für die erfolgreiche Anmeldung zu Ihrem Newsletter, die andere für die erfolgreiche Abmeldung von Ihrem Newsletter.
- Hinterlegen Sie die Mandanten-ID, den Autorisierungs-Code für den API-Zugriff und die ID des Opt-In-Vorgangs in Ihrem Webshop.
- Optional: Erweitern Sie die Empfängerlistenstruktur, um weitere Empfängerdaten/Kundendaten zu übertragen, die nicht in der Standardkonfiguration der Magento-2-Integration enthalten sind.
Opt-In-Mailing konfigurieren
- Wählen Sie im Optimizely Campaign Menü 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 E-Mail-Knoten auf Eigenschaften .
- Klicken Sie auf Inhalt bearbeiten….
- Klicken Sie auf den Namen des Paragraphen, der den Anmeldebestätigungs-Link enthält.
- Klicken Sie im Bereich Text auf Quellcode.
- Ersetzen Sie den enthaltenen Link durch die folgende Code-Zeile/Feldfunktion:
{Double-Opt-In-Link}?id=${user.data.bmecssid}&code=${user.data.bmecsscc}Sie finden den zu ersetzenden Link im <a>-Tag zwischen den Anführungszeichen. Beispiel: Im Quellcode ist folgender Link im <a>-Tag enthalten:
<a href="http://srv2.de/subscribe.html">Anmeldung abschließen</a>Ersetzen Sie den rot markierten Link zwischen den Anführungszeichen folgendermaßen:
<a href="{Double-Opt-In-Link}?id=${user.data.bmecssid}&code=${user.data.bmecsscc} ">Anmeldung abschließen</a>
Note
Die Parameter id und code ermöglichen der Magento-2-Integration die Zuordnung zu den Datensätzen in Ihrem Shop.
- Klicken Sie auf Übernehmen > Schließen > Speichern und schließen.
Landing-Pages erstellen
- Melden Sie sich in Ihrem Magento-2-System mit Administrator-Rechten an.
- Wechseln Sie zu Content > Pages.
- Klicken Sie auf Add New Page.
- Vergeben Sie im Feld Page Title einen Namen für die Landing-Page.
Note
Vergeben Sie eindeutige Bezeichnungen für die Landing-Pages, zum Beispiel Optimizely Campaign Anmeldebestätigung beziehungsweise Optimizely Campaign Abmeldebestätigung.
- Klicken Sie auf Content.
- Geben Sie im Feld Content Heading die Überschrift ein, die auf der Landing-Page angezeigt werden soll.
- Geben Sie im Textfeld den Text ein, der auf der Landing-Page angezeigt werden soll.
- Optional: Nehmen Sie bei Bedarf weitere Einstellungen auf der Maske vor, zum Beispiel Layout-Anpassungen unter Design.
- Klicken Sie auf Save Page.
- Wiederholen Sie die Schritte 3–9, um die zweite Landing-Page anzulegen.
Autorisierungs-Code, Opt-In-ID und Mandanten-ID hinterlegen
Note
Verwechseln Sie nicht die Empfängerliste für Ihre Newsletter-Empfänger mit der Transaktions-Empfängerliste für Ihre Transaktions-Mails. Die Optimizely Kundenbetreuung richtet für den Versand von Newslettern und für den Versand von Transaktions-Mails (zum Beispiel Bestellbestätigungen, Rechnungen und so weiter) zwei unterschiedliche Typen von Empfängerlisten für Sie ein.
- Autorisierungs-Code. Für die Optimizely Campaign Empfängerliste (die die Kundenbetreuung für Sie zur Anbindung Ihres Shops vorbereitet und in Ihrem Mandanten hinterlegt hat). Sie können den Autorisierungs-Code in Ihrem Optimizely Campaign Mandanten in der API-Übersicht einsehen. Wechseln Sie zum Reiter Empfängerlisten und wählen Sie die entsprechende Empfängerliste aus. Klicken Sie auf Autorisierungs-Codes verwalten und kopieren Sie den Autorisierungs-Code der Liste. Wenn für die gewählte Empfängerliste noch kein Autorisierungs-Code vorhanden ist, klicken Sie auf Autorisierungs-Code erstellen.
- Opt-In-ID. Sie finden die Opt-In-ID im Optimizely Campaign Menü unter Verwaltung > API-Übersicht > Opt-In-Prozesse.
- Mandanten-ID. Die Empfängerlisten-ID finden Sie im Optimizely Campaign Menü unter Verwaltung > API-Übersicht > Empfängerlisten.
- Um die drei Parameter in Ihrem Magento-2-System zu hinterlegen, melden Sie sich in Ihrem Magento-2-System mit Administrator-Rechten an.
- Wählen Sie Stores > Configuration.
- Klicken Sie auf Episerver > Episerver Campaign.
- Geben Sie im Bereich Allgemein die folgenden Daten ein:
- Client ID. Ihre Mandanten-ID.
- Client Name. Name für den Mandanten.
- Authorisation Code. Geben Sie den Autorisierungs-Code ein.
- Opt-In ID. Geben Sie die Opt-In-ID ein.
- Debug Mode. Wählen Sie Yes.
- Wählen Sie im Bereich HTTP-API aus der Drop-down-Liste Landing-Page für Anmeldebestätigung die Landing-Page aus, die Sie in Ihrem Magento-2-System für die Newsletter-Anmeldung erstellt haben.
- Wählen Sie im Bereich HTTP-API aus der Drop-down-Liste Landing-Page für Abmeldebestätigung die Landing-Page aus, die Sie in Ihrem Magento-2-System für die Newsletter-Abmeldung erstellt haben.
- Speichern Sie Ihre Änderungen.
Note
Codierte Werte (Client ID, Private key) müssen bei jedem Speichervorgang neu eingetragen werden, da ansonsten der codierte Wert erneut codiert wird.
Übertragene Attribute in der Standardkonfiguration
Die Magento-2-Integration überträgt nur die E-Mail-Adresse von Kunden, die sich mit ihrer E-Mail-Adresse zum Newsletter anmelden, aber nicht in ihrem Kundenkonto angemeldet sind. Von im Kundenkonto angemeldeten Kunden werden die in der nachfolgenden Tabelle stehenden Daten übertragen.
Wenn ein Kunde oder ein Administrator im Shop-System die Kundendaten ändert, werden die Änderungen der Daten automatisch in die Optimizely Campaign Empfängerliste übertragen. Änderungen an Kundendaten, die Sie in Optimizely Campaign in einer Empfängerliste vornehmen, synchronisiert die Magento-2-Integration nicht mit Ihrem Shop-System. Ändern Sie deshalb Kundendaten stets in Ihrem Magento-2-System, um die Datensätze synchron zu halten.
- Email. E-Mail-Adresse des Kunden/Empfängers
- Salutation. Anrede
- Firstname. Vorname
- Lastname. Nachname
- Language. Sprache des in Magento 2 eingerichteten Webshops, in dem sich der Kunde registriert hat
- Street. Straße
- Zip. Postleitzahl
- City. Stadt
- State. Bundesland
- Country. Land
- bmecssid. ID, der von der Magento-2-Integration generiert und zur Identifikation bei der Kommunikation mit Optimizely Campaign genutzt wird
- bmecsscc. Confirmation Code, die von der Magento-2-Integration generiert und zur Identifikation bei der Kommunikation mit Optimizely Campaign genutzt wird
- store_id. ID des Webshops, in dem sich der Kunde registriert hat
- dob. Geburtsdatum
- group_id. Kundengruppe
Empfängerlistenstruktur erweitern und weitere Empfängerdaten übertragen
Bei Bedarf können Sie über die Standardattribute hinaus weitere Empfängerdaten/Kundendaten aus Ihrem Magento-2-System zu Optimizely Campaign übertragen. Um die Übertragung einzurichten, müssen Sie:
- weitere Empfängerlistenfelder beauftragen
- in Magento 2 die Übertragung der weiteren Empfängerdaten aktivieren
Note
Die zusätzlichen Attribut-Felder in Ihrem Magento-2-System müssen konform zu den Vorgaben von Magento 2 programmiert worden sein. Zusätzlichen Attribut-Felder, die nicht konform zu den Magento-2-Vorgaben programmiert wurden, können nicht zu Optimizely Campaign übertragen werden.
Weitere Empfängerlistenfelder beauftragen
Um weitere Empfängerlistenfelder zu beauftragen, wenden Sie sich an die Kundenbetreuung und teilen Sie Optimizely alle zusätzlichen Empfängerlistenfelder mit, die Sie für benutzerdefinierte Attribute benötigen. Die Kundenbetreuung erweitert Ihre Empfängerliste Ihren Wünschen entsprechend um die zusätzlich benötigten Empfängerlistenfelder.
Übertragung weiterer Empfängerdaten aktivieren
Nachdem die Kundenbetreuung Ihre Empfängerliste um die gewünschten Empfängerlistenfelder erweitert hat, aktivieren Sie in Magento 2 die Übertragung der entsprechenden Empfängerdaten über die HTTP-API.
- Melden Sie sich in Ihrem Magento-2-System mit Administrator-Rechten an.
- Wechseln Sie zu Stores > Configuration.
- Klicken Sie auf Episerver > Episerver Campaign.
- Wählen Sie im Bereich HTTP-API aus der Liste Configure additional customer attributes to transmit die weiteren Empfängerdaten aus, die Sie zusätzlich zu den Standardattributen zu Optimizely Campaign übertragen möchten.
Tip
Um mehrere Attribute gleichzeitig auszuwählen, drücken sie die Strg-Taste.
- Speichern Sie Ihre Änderungen.