Zum Hauptinhalt springen
Magento 2 Integration

Verknüpfe Magento und JUNE miteinander, um z.B. automatisierte Service-Mails zu versenden.

V
Verfasst von Viktor Kutasow
Vor über einem Monat aktualisiert

Mithilfe der JUNE x Magento-Integration kannst du beide Tools miteinander verknüpfen.

Die Integration hat drei wesentliche Funktionen:


Newsletter-Anmeldungen

1. Vorbereitungen in JUNE

Um Newsletter-Anmeldungen mit bzw. von Magento zu synchronisieren, erstellst du zuerst eine E-Mail Liste in JUNE.

Hier erfährst du, wie du E-Mail-Listen anlegst.

Um das Opt-In in Magento zu ermöglichen, musst du ein Feld in der JUNE-Liste anlegen.

  1. Gehe in der oberen Liste auf Einstellungen.

  2. Klicke auf Feld erstellen. Es öffnet sich ein neues Menüfenster.

    Technischer Name: confirmation_code

    Typ: Text

Optional kannst du weitere Felder hinzufügen, um mehr Informationen aus Magento zu speichern:

  • Den Vornamen der Abonnent:innen

    Technischer Name: firstname

    Typ: Text

  • Den Nachnamen der Abonnent:innen

    Technischer Name: lastname

    Typ: Text

  • Die Store-Sprache

    Technischer Name: locale

    Typ: Text

  • Den Store-Code

    Technischer Name: store_code

    Typ: Text

  • Die Website-ID

    Technischer Name: website_id

    Typ: Text

  • Die Anmelde-ID

    Technischer Name: subscription_id

    Typ: Text

Sobald die Felder angelegt sind, klicke im oberen Reiter auf API und notiere den Collect Token, die List ID und den API Token.

2. Magento Modul einrichten

Nachdem du das Magento Modul installiert hast, gehe in das Konfigurations-Menü von Magento und trage die vorher notierten Werte aus JUNE in die entsprechenden Felder ein.

Für die Basic Authentication denke dir einen Benutzernamen und Passwort aus und notiere dir deine Daten. Diese Zugangsdaten werden später benötigt, um An- und Abmeldungen in JUNE zu Magento zu übertragen.

Sobald die Daten eingetragen und das Modul aktiviert ist, werden neue Anmeldungen zu JUNE übertragen.

3. Synchronisierung in JUNE hinzufügen

Um die Informationen aus JUNE an Magento zu übertragen, müssen im Workflow Builder von JUNE drei Journeys erstellt werden, die mit Magento kommunizieren.

Du gelangst in den Workflow Builder, indem du innerhalb einer E-Mail-Liste auf Aktionen klickst.

User wird zur E-Mail-Liste hinzugefügt

  1. Klicke im Workflow Builder auf Aktion erstellen.

  2. Klicke auf die Aktion User zur E-Mail-Liste hinzugefügt wird.

  3. Nun siehst du ein Journey-Feld. Klicke auf Service hinzufügen und wähle Integration aus.

  4. Unter Code-Integration ausführen, wähle Magento 2 Subscriber Sync aus.

  5. Trage darunter die benötigten Informationen (Shop-URL, Benutzername, Passwort) ein.

  6. Vergiss nicht, deine Eingaben zu speichern.

User abonniert den Newsletter

  1. Klicke im Workflow Builder auf Aktion erstellen.

  2. Klicke auf die Aktion User abonniert.

  3. Nun siehst du ein Journey-Feld. Klicke auf Service hinzufügen und wähle Integration aus.

  4. Unter Code-Integration ausführen, wähle Magento 2 Subscriber Sync aus.

  5. Trage darunter die benötigten Informationen (Shop-URL, Benutzername, Passwort) ein.

  6. Vergiss nicht, deine Eingaben zu speichern.

User deabonniert den Newsletter

  1. Klicke im Workflow Builder auf Aktion erstellen.

  2. Klicke auf die Aktion User sich abmeldet.

  3. Nun siehst du ein Journey-Feld. Klicke auf Service hinzufügen und wähle Integration aus.

  4. Unter Code-Integration ausführen, wähle Magento 2 Subscriber Sync aus.

  5. Trage darunter die benötigten Informationen (Shop-URL, Benutzername, Passwort) ein.

  6. Vergiss nicht, deine Eingaben zu speichern.

Nun werden sämtlich An- und Abmeldungen aus JUNE zu Magento übertragen. Deine Integration kommuniziert jetzt in beide Richtungen und die Daten aktualisieren sich sofort in beiden Systemen.


Service Mails

1. Vorbereitungen in JUNE

Um Service-Mails über JUNE zu verschicken, musst du eine neue Liste mit dem Typ Unstructured List anlegen.

Füge vier Pflichtfelder hinzu, um die notwendigen Informationen aus Magento zu speichern

  1. Gehe in der oberen Liste auf Einstellungen.

  2. Klicke auf Felder erstellen. Es öffnet sich ein neues Menüfenster.

    • Technischer Name: action_type

      Typ: Text

  3. Wiederhole den Vorgang für die folgenden Felder:

    • Technischer Name: recipient_email

      Typ: Text

    • Technischer Name: user_data

      Typ: Object

    • Technischer Name: content_data

      Typ: Object

Zusätzlich können noch Informationen zum Magento Store (nützlich für Multi-Store Setups) und zu Produkten bei Bestellbestätigungen gespeichert werden.

Füge dafür folgende optionale Felder hinzu:

  • Technischer Name: store_data

    Typ: Object

  • Technischer Name: product_data

    Typ: Object

Wechsel danach oben zum Reiter API und notiere den Collect Token und den API Token. Diese Informationen werden für das Magento Modul benötigt.

2. Magento Modul einrichten

Nachdem du das Magento Modul installiert hast, gehe in das Konfigurations-Menü von Magento und trage den vorher notierten API Token in das entsprechende Feld ein.

Im Einstellungsbereich darunter können nun mehrere Magento E-Mails hinzugefügt und ausgewählt werden, die von JUNE verarbeitet werden sollen. Diese E-Mails werden ab dem Zeitpunkt nicht mehr von Magento verschickt und stattdessen an JUNE übergeben.

Gebe für jedes ausgewählte E-Mail Template den Collect Token der vorher notierten JUNE-Liste ein.

Alle ausgewählten E-Mail Templates werden an diese Liste übergeben. Falls du die E-Mails in JUNE trennen möchtest, um die Übersichtlichkeit zu verbessern, bietet es sich an, mehrere Listen nach dem selben Prinzip in JUNE zu erstellen und die entsprechenden List Tokens auf die E-Mail Templates zu verteilen.

Unsere Empfehlung ist zumindest für Benutzer- und Bestell-Mails unterschiedliche Listen zu verwenden.

3. E-Mail Versand in JUNE einstellen

Sobald die Daten in der JUNE Liste ankommen, können die E-Mails erstellt werden. Hierzu ein paar Informationen zu den gespeicherten Feldern:

  • action_type: Hier wird der Name des Magento-Templates gespeichert. Mithilfe des Action-Types kannst du die verschiedenen Arten der Service-Mails unterscheiden.

  • user_data: Hier werden weitere Informationen des Benutzers (falls vorhanden) und Empfänger-Adressen für das CC / BCC Mailing (falls eingestellt), gespeichert.

  • content_data: Enthält die Variablen, die Magento für die entsprechenden E-Mails bereitstellt. Für eine Bestellung sind hier sämtliche Bestellinformationen gespeichert. Für eine Benutzer-Anmeldung ist hier der Aktivierungs-Link gespeichert.

  • store_data: Hier werden Informationen über den Store, aus dem die E-Mail erstellt wurde, gespeichert. Sowohl die URL des Stores als auch der Store-Code, die Website-ID und benutzte Locale können hier ausgelesen werden, um unterschiedliche E-Mails in einem Multi-Store Setup zu erzeugen.

  • product_data: Enthält eine saubere Liste aller benutzten Produkt-SKUs in einer Mail.

Workflow für Service-Mails aufbauen

Zum Schluss musst du im Workflow Builder von JUNE noch eine Journey aufbauen. Hiermit werden Service-Mails gesendet, sobald neue Informationen gespeichert werden.

Du gelangst in den Workflow Builder, indem du innerhalb einer Liste auf Aktionen klickst.

  1. Klicke im Workflow Builder auf Aktion erstellen.

  2. Klicke auf die Aktion Data Item zur Liste hinzugefügt wird.

  3. Setze eine Bedingung, je nach Art der Service-Mail. Klicke hierfür auf Bedingung hinzufügen und wähle Custom Segmentation aus. Erstelle eine Regel mithilfe des action_type für die E-Mail, die du automatisieren möchtest. Möchtest du z.B. eine Service-Mail für Bestellbestätigungen versenden, gibst du hier den dazugehörigen Action-Type an.

  4. Klicke im Journey-Feld auf Service hinzufügen und wähle E-Mail senden aus.

  5. Wähle die passende E-Mail aus, die für den Versand verwendet werden soll und passe die Mail ggf. an.

  6. Definiere die Betreffzeile und Absenderinformationen.

  7. Unter Senden an klickst du Auswählen und wählst das Feld recipient_email aus.

Der Workflow soll schließlich so aussehen:

Diesen Vorgang wiederholst du für alle Arten von Service-Mails, die du benötigst. Arten von Service-Mails sind z.B.: Bestell-, Versand- sowie Zahlungsbestätigung.


E-Commerce

1. Vorbereitungen in JUNE

Um E-Commerce Daten an JUNE übertragen zu können, musst du zuerst eine E-Commerce Liste in JUNE erstellen. Wenn du vorher schon eine E-Mail Liste angelegt hast, kannst du diese auch zu einer E-Commerce Liste umwandeln.

Als optionale Felder kannst du die Felder aus dem 1.Schritt bei den Newsletter Anmeldungen übernehmen.

In der Liste muss man auch noch einen Commerce Token erstellen um die Daten aus Magento an JUNE zu übertragen.

  1. Klicke oben auf den Reiter E-Commerce Einstellungen

  2. Erstelle einen neuen Provider, mit den Knopf oben rechts, vom Typ Magento

  3. Klicke auf Speichern

In der Liste ist jetzt ein neuer Eintrag mit Provider Magento und in der Spalte Token findest du den Commerce Token

2. Magento Modul einrichten

Nachdem du das Magento Modul installiert hast, gehe in das Konfigurations-Menü von Magento.
Um die E-Commerce Daten zu übertragen muss zum einen die Übertragung bei Transfer Order Commerce Data bestätigt werden und der Commerce Token aus der erstellten E-Commerce Liste aus JUNE eingetragen werden.

Damit der Kunde, der mit der Bestellung verknüpft ist, auch an JUNE übertragen wird muss Transfer Contact Data aktiviert werden.
Für die Übertragung muss auch noch der Collect Token und der Api Token von der Commerce Liste eingetragen werden.
Die Tokens findest du in der Liste beim Reiter API.

Sobald die Verbindung eingerichtet ist kann man die neuen Bestellungen in JUNE unter dem Reiter E-Commerce Data sehen.

🧑‍💻 Kontakt & Unterstützung

Du benötigst Hilfe beim Einrichten einer Integration? Unsere Developer sind gerne für dich da. Buche dir hier einen passenden Termin.

Hat dies deine Frage beantwortet?