Erste Schritte mit Magento 2.x (CE und EE)

Du wirst lernen

Erfahre, wie du Klaviyo in deinen Magento 2 CE oder EE Shop integrierst. Du musst die Klaviyo-Erweiterung in Magento installieren, die Erweiterung konfigurieren und OAuth einrichten und dann die Integration in Klaviyo aktivieren. In diesem Leitfaden findest du alle erforderlichen Integrationsschritte sowie Informationen dazu, wie du die erfolgreiche Synchronisierung deiner historischen Daten überprüfen kannst.

Bevor du beginnst

Bitte beachte, dass Magento 2 Versionen unter 2.4.0 nicht unterstützt werden.

Damit Klaviyo die notwendigen API-Aufrufe für die Integration tätigen kann, muss dein Magento 2 Server einen öffentlich zugänglichen Hostnamen haben. Magento 2-Server, die lokal gehostet werden, können nicht vollständig in Klaviyo integriert werden.

Es wird dringend empfohlen, Klaviyo IPs zur Zulassungsliste deines Firewall-Anbieters hinzuzufügen, um Authentifizierungs- und Konfigurationsprobleme zu minimieren. Weitere Informationen findest du unter So führst du einen Whitelist für IP-Adressen des Klaviyo-Integrationsdatenverkehrs durch.

Die Magento 2-Erweiterung von Klaviyo sollte über Composer installiert werden. Bitte beachte, dass für die Installation über Composer ein IT-Administrator mit SSH-Zugriff auf den Server erforderlich ist, auf dem Magento 2 gehostet wird.

Installiere die Klaviyo-Erweiterung in Magento 2

1. Melde dich bei deinem Magento 2 Server an und navigiere mit deinem Kommandozeilenprogramm zum Stammverzeichnis deiner Magento App. Dieser Leitfaden zeigt Beispielausgaben für Terminal, aber diese Schritte können für jedes Kommandozeilentool deiner Wahl geändert werden.
2. Führe den folgenden Befehl aus, um von Packagist aus auf die neueste Version der Klaviyo-Erweiterung zuzugreifen. Packagist ist ein Repository für PHP-Code-Bibliotheken, mit dem du ganz einfach die neueste Version der Erweiterung installieren kannst. Composer benötigen Klaviyo/Magento2-Extension
3. Führe den folgenden Befehl aus, um die Klaviyo-Erweiterung zu aktivieren, die du gerade heruntergeladen hast: php bin/magento module:enable Klaviyo_Reclaim --clear-static-content
   
4. Wie in der Beispielausgabe angezeigt, musst du nun alle weiteren Module aktivieren. Führe den folgenden Befehl aus, um sie zu aktivieren: php bin/magento setup:upgrade
5. Überprüfe die Ausgabe für das Modul „Klaviyo_Reclaim“, um sicherzustellen, dass das Klaviyo-Modul aktiviert ist und ausgeführt wird.
6. Um sicherzustellen, dass CSS und JS in deinem Magento 2-Shop weiterhin richtig funktionieren, musst du ’einen allgemeingültigen Befehl zum Bereitstellen von Inhalten ausführen. PHP bin/magento setup:static-content:deploy -f
   
7. Du kannst jetzt von deinem Browser aus zum Magento Admin-Dashboard zurückkehren.

Die Installation über Composer ist abgeschlossen! Fahre mit dem nächsten Abschnitt fort, um Anweisungen zur Konfiguration zu erhalten.

Konfiguriere die Klaviyo-Erweiterung

Anleitung zum Video

1. Navigiere in deinem Klaviyo-Konto zur Registerkarte API-Schlüssel.
2. Navigiere in einem neuen Tab zu deinem Magento Laden Admin.
3. Unter Einstellungen klickst du auf Laden > Konfiguration.
4. Klicke im Dropdown-Menü von Klaviyo auf Allgemein.
5. Setze die Option Klaviyo-Erweiterung aktivieren auf Ja.
6. Kopiere deinen sechsstelligen Klaviyo öffentlichen API-Schlüssel von der Registerkarte API-Schlüssel und füge ihn in das entsprechende Feld auf Magento ein.
7. Erstelle auf der Registerkarte Klaviyo API-Schlüssel einen neuen privaten Schlüssel und füge ihn in das entsprechende Feld in Magento ein. Wenn du dich mit deinem privaten API-Schlüssel authentifizierst, kannst du die Newsletter-Abonnements von Magento mit Klaviyo synchronisieren.

Im nächsten Abschnitt richtest du OAuth ein, das weitere Aspekte der Integration ermöglicht.

OAuth einrichten

Als Nächstes aktivierst du die OAuth-Authentifizierung, um dein Klaviyo-Konto sicher mit der Magento 2-Erweiterung zu verbinden.

1. Navigiere zur Registerkarte Setup OAuth in Magento.
2. Gib deiner Integration einen einprägsamen Namen, da du sie später unter diesem Namen finden musst.
3. Klicke auf Konfiguration speichern , um fortzufahren.
   
4. Suche System im linken Navigationsbereich und wähle Integrationen aus dem System- Tray.
5. Suche deinen Integrationsnamen und klicke auf Aktivieren. Wenn du die Integration aktivierst, wird ein Fenster geöffnet, in dem du aufgefordert wirst, den Zugriff zu genehmigen.
   
6. Klicke auf Zulassen, um zu Klaviyo weitergeleitet zu werden, wo du die Integrationseinrichtung abschließt.
   
7. Melde dich bei Klaviyo an, wenn du dazu aufgefordert wirst, oder bestätige, dass dein Kontoname korrekt ist, und klicke auf Integrieren. Dadurch wird die Magento 2-Integration dem Klaviyo-Konto hinzugefügt, das mit dem API-Schlüssel verbunden ist, den du für die Einrichtung verwendet hast. Wenn du bei mehreren Klaviyo-Konten angemeldet bist und das richtige Konto nicht angezeigt wird, melde dich von allen anderen Sitzungen ab.

Wenn das Fenster automatisch geschlossen wird, war die Verbindung erfolgreich. Du kannst den Erfolg auch bestätigen, indem du dein Klaviyo-Konto in einer neuen Browserregisterkarte oder einem neuen Browserfenster öffnest, die Registerkarte Integrationen auswählst und in der Liste nach Magento 2 suchst.

Wenn du stattdessen die folgende Fehlermeldung erhältst, stelle sicher, dass die im ersten Schritt verwendeten API-Schlüssel dem Konto entsprechen, bei dem du derzeit angemeldet bist.

Wenn du beim Herstellen der Verbindung zwischen Magento und Klaviyo stattdessen eine Liste von Fehlern erhältst, kannst du auf jeden Fehler klicken, um mehr über die Ursache zu erfahren.

Eine Newsletter-Liste erstellen

Als Nächstes wählst du eine Klaviyo Liste aus, mit der du dein Newsletter-Abonnement synchronisieren möchtest. Du hast auch die Möglichkeit, die Klaviyo-Opt-in-Einstellungen oder die Magento 2-Opt-in-Einstellungen für deine gewählte Liste zu verwenden.

1. In Magento klickst du auf Newsletter.
2. Wähle die Klaviyo-Liste, mit der du dein Magento-Anmeldeformular synchronisieren möchtest, aus dem Dropdown-Menü aus.
3. Klicke auf Konfiguration speichern.

Zustimmung bei Bezahlvorgang einholen

Als Nächstes kannst du beim Bezahlvorgang für E-Mail und SMS die Einwilligung aktivieren.

Bitte beachte: Wenn du die Einwilligung beim Bezahlvorgang aktivierst, musst du auch die Webhooks (unten) aktivieren, damit die Einwilligung beim Bezahlvorgang richtig funktioniert.

1. Navigiere auf der Konfigurationsseite unter Klaviyo zu Consent at Checkout (Einwilligung beim Bezahlvorgang).
   
2. You’Hier findest du einen Abschnitt zum Einholen der Einwilligung und SMS-Einwilligung für die E-Mail. Beide werden getrennt behandelt, sodass du nur E-Mail, nur SMS oder beides erfassen kannst. Wenn du sowohl SMS- als auch E-Mail-Abonnent*innen erfasst, wähle für SMS eine andere Liste als für E-Mail. Dadurch wird sichergestellt, dass die Einwilligung immer dem richtigen Kanal zugeordnet wird.
   
   • Die Zustimmung wird nicht synchronisiert (sowohl für E-Mail als auch für SMS), bis der Kunde die Bestellung abschließt und ggf. sein Abonnement aufgrund des Double Opt-in bestätigt.
   • Beachte, dass für Benutzer, die bereits in deinem Magento 2 Laden eingeloggt sind, das Kontrollkästchen für die E-Mail-Einwilligung beim Bezahlvorgang standardmäßig nicht erscheint.
3. Wähle unter E-Mail die Option Ja für Kontakte beim Bezahlvorgang für E-Mail-Marketing abonnieren aus.
4. Wähle eine E-Mail-Liste aus, mit der du dein Abonnent synchronisieren möchtest, z.B. einen Newsletter.
5. Gib den Text des E-Mail-Opt-in-Kontrollkästchens ein, den du verwenden möchtest.
   
6. Wähle unter SMS die Option Ja für Kontakte beim Bezahlvorgang zum SMS-Marketing abonnieren aus.
7. Wähle die Liste aus, mit der deine SMS-Kontakte synchronisiert werden sollen. Weitere Informationen zu diesen Einstellungen findest du in unserer Anleitung zum Einholen von SMS-Einwilligung beim Bezahlvorgang.
   
8. Mit der Sortierreihenfolge kannst du die Platzierung der Zustimmungsfelder E-Mail und SMS ändern. Standardmäßig erscheinen diese Felder unter der ersten E-Mail-Eingabe bzw. dem Feld für die Versandtelefonnummer. Wenn du also die Bezahlvorgang-Seite nicht umgestellt hast, musst du die Sortierreihenfolge nicht ändern. Wenn du das Layout geändert hast, passe die Sortierreihenfolge entsprechend an.
9. Wenn du fertig bist, klicke oben rechts auf Konfiguration speichern.

Webhook aktivieren

Als Nächstes aktivierst du Klaviyo-Webhook in deinem Magento 2-Konto. Bitte beachte, dass die Aktivierung von Webhooks erforderlich ist, damit die Einwilligung beim Bezahlvorgang richtig funktioniert.

1. Navigiere im Admin Dashboard zu Laden > Konfiguration.
2. Klicke auf Klaviyo und wähle die Registerkarte Webhook aus.
3. Erstelle einen geheimen Webhook und gib ihn in das entsprechende Feld Webhook Secret ein. Der Schlüsselschlüssel ist ein Webhook, den Klaviyo zur Validierung verwendet. Dieses Geheimnis kann alles sein, was du auswählst, aber wir empfehlen dir, eine sichere Folge von Buchstaben und Zahlen zu erstellen. Magento blendet deinen geheimen Webhook aus Sicherheitsgründen mit Sternchen aus. Achte also darauf, ihn richtig einzugeben. Wenn du eine Multi-Store-Integration verwendest, sollte der Geheimschlüssel für den Webhook in diesem Feld in deiner Standardkonfiguration eingegeben werden. Dieser Geheimschlüssel wird für jede Shop-Konfiguration als Validierung verwendet. Der geheime Webhook-Schlüssel sollte nur zur Standardkonfiguration und nicht pro Shop hinzugefügt werden.
   
4. Wähle neben den Webhooks, die du aktivieren möchtest, Ja aus dem Drop-down-Menü aus. Weitere Informationen zu den von Klaviyo unterstützten Webhooks findest du in unserem Leitfaden zu Webhooks für Magento 2.
5. Klicke auf Konfiguration speichern.

Aktiviere die Magento 2 Integration in Klaviyo

Anleitung zum Video

1. Öffne Klaviyo und wähle dann in der linken Navigation den Punkt Integrationen. Suche Magento 2 in der Liste und wähle es aus.
2. Auf der nächsten Seite hast du die Möglichkeit, neue Magento 2-Kund*innen zu einer Klaviyo-Liste hinzuzufügen. Klicke auf das Kontrollkästchen Neue Magento 2-Kund*innen zu einer Klaviyo-Liste hinzufügen und wähle eine Liste aus dem Drop-down-Menü aus. Beachte, dass die Aktivierung dieser Einstellung nur Kund*innen zur ausgewählten Liste hinzufügt, sie aber nicht zu Marketing-Nachrichten abonniert. Mit dieser Einstellung werden nur neue Kund*innen synchronisiert. Bestehende Kund*innen müssen manuell von deiner Magento-Liste zu Klaviyo migriert werden.
   
3. Wähle dann aus, welche Shop-Aufrufe von Magento 2 du mit Klaviyo synchronisieren möchtest. Alle Shop-Aufrufe werden standardmäßig mit Klaviyo synchronisiert. Mit dieser Einstellung kannst du auswählen, mit welchen Shops du interagierst. Wenn du in Magento 2 Multi-Source Inventory (MSI) verwendest, überprüfe die Aufrufe bestimmter Magento 2 -Shops und wähle die Shops aus, die du synchronisieren möchtest, damit dein Bestand in Klaviyo richtig dargestellt wird.
4. Aktivieren Sie unter Erweitert die folgenden Einstellungen nach Bedarf:
   
   • Sonderpreiseinstellungen Diese Einstellung bezieht sich auf einen Sonderverkaufspreis für Artikel, die optional in einem bestimmten Zeitraum wirksam werden können. Wir empfehlen dir dringend, diese Funktion zu aktivieren, wenn du sie nutzen möchtest, da sie später schwieriger zu aktivieren ist. Wenn du die Option Sonderpreis für Produktpreise verwenden aktivierst, wird im Produktblock der Sonderpreis angezeigt, sofern zutreffend. Bei Verwendung eines dynamischen Produkt-Feeds wird der Sonderpreis zum Versandzeitpunkt ausgefüllt. Wenn du Artikel aus deinem Katalog manuell auswählst, wird der Sonderpreis ausgefüllt, sobald du das/die Produkt(e) ausgewählt hast. Für jedes Produkt gibt es 4 Metadaten-Felder, die synchronisiert werden:
     • Preis (Erforderlich, Float) Der Standardpreis des Artikels.
     • special_price (Optional, float) Dies ist ein Sonderverkaufspreis für den Artikel. Wenn dieser Preis in Kraft ist, siehst du diesen special_price neben einer durchgestrichenen Preisangabe.
     • special_from_date (Optional, date) Gibt ein Startdatum für special_price an, das in Kraft treten soll.
     • special_to_date (Optional, date) Gibt ein Enddatum für special_price an.
   • Benutzerdefinierte Medien-Stamm-URL Mit dieser Einstellung kannst du den Standardpfad für deine Website-Bilder ändern. Aktiviere diese Einstellung, wenn du deine Produktbilder auf einer anderen URL als deiner Website hostest.
5. Klicke auf Speichern.

Du hast die Magento 2-Integration jetzt erfolgreich aktiviert! Deine Daten werden in wenigen Minuten mit Klaviyo synchronisiert.

Nach der ersten Synchronisierung der historischen Daten wird die Magento 2-Integration alle 30 Minuten synchronisiert.

Daten werden mit der Magento 2 Integration synchronisiert

KlaviyoDie Magento 2-Integration holt wichtige Kunde-Informationen von deiner Magento -Plattform.

Hier sind einige der Daten, die wir von Magento synchronisieren:

• Kundeninformationen wie Vorname, Nachname und Ort.
• Verkaufs- und Bestelldaten, z. B. welche Artikel gekauft wurden, Artikelbilder, Artikelkategorien und angewandte Rabatte.
• Daten zu erfüllten, erstatteten und stornierten Bestellungen.
• Wenn Menschen deine Website besuchen und welche Artikel sie sich ansehen, wird das Webtracking von der Erweiterung übernommen.

Weitere Informationen findest du in unserer Magento 2 Datenübersicht.

Magento Bestellwert in eine einzige Währung umrechnen

Klaviyo unterstützt die Umrechnung aller Fremdwährungen in Magento in eine Hauptwährung in Klaviyo. Bitte kontaktiere den Support, um diese Funktion zu aktivieren. Dies ist besonders hilfreich, wenn du mehrere Shops mit Transaktionen in verschiedenen Währungen hast.

Wenn diese Funktion aktiviert ist:

• Die Conversion erfolgt, wenn Magento Bestelldaten mit Klaviyo synchronisiert.
• Klaviyo prüft, ob der ORDER_CURRENCY_CODE mit dem SET GLOBAL_CURRENCY_CODE übereinstimmt. Wenn nicht, rechnet Klaviyo den Gesamtbetrag der Bestellung von der Bestellwährung in die angegebene globale Währung um, um sicherzustellen, dass deine Finanzauswertungen korrekt sind. Bitte beachte, dass die Bestellpositionen im Währungscode der Bestellung verbleiben und nicht umgerechnet werden.

Upgrade deiner Erweiterung

Möchtest du ein Upgrade für deine Klaviyo Magento 2-Erweiterung durchführen? Folge den Anweisungen im Abschnitt„Installieren“ oben und führe den Befehl zur Installation der neuesten Version aus. Dadurch wird deine aktuelle Version überschrieben und dein Update wird abgeschlossen. Dadurch ist es nicht mehr erforderlich, die Erweiterung neu zu konfigurieren oder die Integration in Klaviyo zu aktivieren. ’s

Deinen Katalog erneut synchronisieren

Du kannst jederzeit eine vollständige Neusynchronisierung deines Magento 2-Katalogs veranlassen. Wenn du deinen Katalog neu synchronisierst, kannst du die Vorteile der Klaviyo-Updates für den Bestand und variantenbezogene Funktionen nutzen.

Um deinen Katalog neu zu synchronisieren:

1. Wähle in Klaviyo die Registerkarte Integrationen.
2. Wähle deine Magento 2 Integrationen aus der Liste aus.
3. Klicke auf die Registerkarte Daten.
4. Klicke unter Katalogdaten synchronisieren auf Neu synchronisieren.