Erste Schritte mit Magento 2.x (CE und EE)
Übersicht
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. Dieser Leitfaden behandelt alle erforderlichen Integrationen-Schritte sowie, wie du bestätigst, dass die Synchronisierung deiner historischen Daten erfolgreich ist.
Bevor du anfängst
Bitte beachte, dass Magento 2 Versionen unter 2.4.0 nicht unterstützt werden.
Um sicherzustellen, dass Klaviyo die notwendigen API-Aufrufe für die Integration durchführen kann, muss dein Magento 2-Server einen öffentlich zugänglichen Hostnamen haben. Lokal gehostete Magento 2-Server können nicht vollständig mit Klaviyo integriert werden.
Es wird dringend empfohlen, Klaviyo-IP-Adressen zur Zulassungsliste deines Firewall-Anbieters hinzuzufügen, um Authentifizierungs- und Konfigurationsprobleme zu minimieren. Weitere Informationen findest du unter So setzt du IP-Adressen für Klaviyo-Integrations-Traffic auf die Zulassungsliste.
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
- Melde dich bei deinem Magento 2-Server an und navigiere über dein Befehlszeilenprogramm zum Stammverzeichnis deiner Magento-App. Diese Anleitung zeigt Beispielausgaben für Terminal, aber diese Schritte können für jedes Befehlszeilenprogramm deiner Wahl geändert werden.
- Führe den folgenden Befehl aus, um über Packagist auf die neueste Version der Klaviyo-Erweiterung zuzugreifen. Packagist ist ein Repository für PHP-Codebibliotheken, mit dem du ganz einfach die neueste Version der Erweiterung installieren kannst.
composer require klaviyo/magento2-extension - 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

- Wie in der Beispielausgabe angezeigt, musst du jetzt alle zusätzlichen Module aktivieren. Führe den folgenden Befehl aus, um sie zu aktivieren:
php bin/magento setup:upgrade - Scanne die Ausgabe nach
Module 'Klaviyo_Reclaim', um zu bestätigen, dass das Klaviyo-Modul aktiviert ist und ausgeführt wird. - Damit das CSS und JS in deinem Magento 2-Shop weiterhin ordnungsgemäß funktionieren, musst du einen Befehl zur Bereitstellung statischer Inhalte ausführen.
php bin/magento setup:static-content:deploy -f

- 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 für Konfigurationsanweisungen fort.
Konfiguriere die Klaviyo-Erweiterung
Video-Anleitung
- Navigiere in deinem Klaviyo-Konto zum Tab „API-Schlüssel“.
- Navigiere in einer neuen Registerkarte zu deinem Magento-Shop-Admin.
- Klicke unter Einstellungen auf Shops > Konfiguration.
- Klicke im Drop-down-Menü Klaviyo auf Allgemein.
- Setze Klaviyo-Erweiterung aktivieren auf Ja.
- Kopiere deinen öffentlichen Klaviyo API-Schlüssel (Site ID) aus dem Tab „API-Schlüssel“ und füge ihn in das entsprechende Feld in Magento ein.
- Erstelle im Tab „API-Schlüssel“ in Klaviyo einen neuen privaten API-Schlüssel und kopiere ihn in das entsprechende Feld in Magento. Mit der Authentifizierung über deinen privaten API-Schlüssel kannst du Newsletter-Abonnements von Magento mit Klaviyo synchronisieren.
Im nächsten Abschnitt richtest du OAuth ein, das andere Aspekte der Integration aktiviert.

OAuth einrichten
Als Nächstes aktivierst du die OAuth-Authentifizierung, um dein Klaviyo-Konto sicher mit der Magento 2-Erweiterung zu verbinden.
- Navigiere in Magento zur Registerkarte OAuth einrichten.
- Gib deiner Integration einen einprägsamen Namen, da du sie später unter diesem Namen finden musst.
- Klicke auf Konfiguration speichern , um fortzufahren.

- Suche System im linken Navigationsbereich und wähle Integrationen aus dem System- Tray.
- 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.

- Klicke auf Zulassen, um zu Klaviyo weitergeleitet zu werden, wo du die Integrationseinrichtung abschließt.

- 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 den Fehler „Klaviyo-Konto stimmt nicht mit der Unternehmens-ID überein“ siehst, stelle sicher, dass die API-Schlüssel, die du in Magento eingegeben hast, zu dem Klaviyo-Konto gehören, bei dem du gerade angemeldet bist, und versuche es dann erneut.

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

Lege eine Newsletter-Liste fest
Als Nächstes wählst du eine Klaviyo-Liste aus, mit der du deine Newsletter-Abonnent*innen synchronisieren möchtest. Du hast auch die Möglichkeit, die Klaviyo-Opt-in-Einstellungen oder die Magento 2-Opt-in-Einstellungen für deine ausgewählte Liste zu verwenden.
- Klicke in Magento auf Newsletter.
- Wähle aus dem Drop-down-Menü die Klaviyo-Liste aus, mit der du dein Magento-Anmeldeformular synchronisieren möchtest.
- Klicke auf Konfiguration speichern.

Einwilligung beim Bezahlvorgang aktivieren
Du kannst die Einwilligung im Checkout für E-Mail und für mobile Kanäle (SMS, WhatsApp oder beides) einholen.
Bitte beachte: Wenn du die Einwilligung beim Bezahlvorgang aktivierst, musst du auch die Webhooks (unten) aktivieren, damit die Einwilligung beim Bezahlvorgang richtig funktioniert.
- Navigiere auf der Konfigurationsseite unter Klaviyo zu Consent at Checkout (Einwilligung beim Bezahlvorgang).

- Du siehst einen Abschnitt zum Einholen der E-Mail-Einwilligung und der Einwilligung für Mobilgeräte (SMS/WhatsApp). Beide werden getrennt behandelt, sodass du nur E-Mail, nur SMS/WhatsApp oder beides erfassen kannst. Wenn du sowohl SMS-/WhatsApp- als auch E-Mail-Abonnent*innen erfasst, wähle für SMS/WhatsApp eine andere Liste als für E-Mail. Dadurch wird sichergestellt, dass die Einwilligung immer dem richtigen Kanal zugeordnet wird.
- Die Einwilligung wird nicht synchronisiert (sowohl für E-Mail und SMS als auch für WhatsApp), bis der Kunde die Bestellung abgeschlossen hat und gegebenenfalls sein Abonnement aufgrund von Double Opt-in bestätigt.
- Beachte, dass das Kontrollkästchen für die Einwilligung zur E-Mail von Benutzer*innen, die bereits bei deinem Magento 2-Shop angemeldet sind, beim Bezahlvorgang standardmäßig nicht angezeigt wird.
- Wähle unter E-Mail die Option Ja für Kontakte beim Bezahlvorgang für E-Mail-Marketing abonnieren aus.
- Wähle eine E-Mail-Liste aus, mit der du Abonnent*innen synchronisieren möchtest, z. B. einen Newsletter.
- Gib den Text des E-Mail-Opt-in-Kontrollkästchens ein, den du verwenden möchtest.

- Wähle unter Mobilgeräte die Option Ja für Textnachricht- und WhatsApp-Abonnent*innen erfassen aus.
- Wähle die Liste aus, mit der deine SMS/WhatsApp-Kontakte synchronisiert werden sollen. Weitere Details zu diesen Einstellungen findest du in unserem Leitfaden zum Einholen der SMS- und/oder WhatsApp-Einwilligung beim Checkout.

- Mit der Sortierreihenfolge kannst du die Platzierung der Felder für die Einwilligung der E-Mail und SMS ändern. Standardmäßig werden diese Felder unter der ersten E-Mail bzw. unter dem Feld für die Telefonnummer des Versands angezeigt. Wenn du also die Bezahlseite nicht neu angeordnet hast, musst du die Sortierreihenfolge nicht ändern. Wenn du das Layout geändert hast, passe die Sortierreihenfolge entsprechend an.
- Wenn du fertig bist, klicke oben rechts auf Konfiguration speichern.
Aktiviere Webhooks
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.
- Navigiere im Admin-Dashboard zu Shops > Konfiguration.
- Klicke auf Klaviyo und wähle die Registerkarte Webhook aus.
- 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.

- Wähle in der Dropdown-Liste neben den Webhooks, die du aktivieren möchtest, Ja aus. Wenn du mehr über die von Klaviyo unterstützten Webhooks erfahren möchtest, sieh dir unseren Leitfaden zu Webhooks für Magento 2 an.
- Klicke auf Konfiguration speichern.
Magento 2-Integration in Klaviyo aktivieren
Video-Anleitung
- Öffne Klaviyo und wähle im linken Navigationsfenster Integrationen aus. Suche Magento 2 in der Liste und wähle es aus.
- Auf der nächsten Seite kannst du auswählen, Magento 2-Kund*innen zu einer Klaviyo-Liste hinzuzufügen. Wähle Neue Magento-2-Kund*innen zu einer Klaviyo-Liste hinzufügen aus und wähle eine Liste aus dem Dropdown-Menü. Das Hinzufügen einer*s Kund*in zu einer Liste erteilt für sich genommen keine Marketingeinwilligung. Verwende die Einwilligungseinstellungen für Newsletter und Checkout in Magento, um diese Einwilligung einzuholen.
Bestehende Kundenprofile sind in der Synchronisierung historischer Daten enthalten. Um bestehende Newsletter-Abonnent*innen aus einer CSV hochzuladen, folge der Anleitung zum Hochladen bestehender Magento 2-Abonnent*innen in eine Klaviyo-Liste.

- Wähle als Nächstes aus, welche Store-Views aus Magento 2 du mit Klaviyo synchronisieren möchtest. Standardmäßig werden alle Store-Views mit Klaviyo synchronisiert. Mit dieser Einstellung kannst du auswählen, welche Stores du integrieren möchtest. Wenn du Multi-Source Inventory (MSI) in Magento 2 verwendest, wähle Bestimmte Magento 2-Store-Views aus und wähle die Stores aus, die du synchronisieren möchtest, damit dein Bestand in Klaviyo korrekt dargestellt wird.
- Konfiguriere unter Erweitert die folgenden Einstellungen nach Bedarf:
- Einstellungen für Sonderpreise
Diese Einstellung bezieht sich auf einen speziellen Angebotspreis für Artikel, der optional in einem bestimmten Datumsbereich gelten kann. Aktiviere sie vor deiner ersten Katalog-Synchronisierung, wenn du Sonderpreise verwenden möchtest. Wenn du sie später aktivierst, synchronisiere deinen Katalog erneut, um bestehende Produkte zu aktualisieren. Wenn du Sonderpreis für Produktpreise verwenden, wenn zutreffend aktivierst, zeigt der Produktblock den Sonderpreis an, wenn zutreffend. Bei Verwendung eines dynamischen Produkt-Feeds wird der Sonderpreis zum Versandzeitpunkt eingefügt. Wenn du Artikel manuell aus deinem Katalog auswählst, wird der Sonderpreis eingefügt, sobald du das/die Produkt(e) auswählst. Für jedes Produkt gibt es 4 Metadatenfelder, die synchronisiert werden:- Preis
(Erforderlich, float) Der Standardpreis des Artikels. - Sonderpreis
(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. - Sonder-Von-Datum
(Optional, Datum) Gibt ein Startdatum für special_price an, das in Kraft treten soll. - Sonder_bis_Datum
(Optional, Datum) Gibt ein Enddatum für special_price an, das in Kraft tritt.
- Preis
- Medienstamm-URL
Um den Standardpfad für die Bilder deiner Website zu ändern, wähle Medienstamm-URL ändern aus und gib deine Medienstamm-URL ein. Verwende diese Einstellung, wenn deine Bilder unter einer anderen URL als deine Website gehostet werden. - Synchronisierung auf aktuelle Bestellungen beschränken
Bei regelmäßigen Bestellsynchronisierungen werden Bestellungen abgerufen, die seit der vorherigen Synchronisierung aktualisiert wurden. Um diese Synchronisierungen danach zu begrenzen, wann Bestellungen erstellt wurden, wähle Synchronisierung auf aktuelle Bestellungen begrenzen aus und wähle im Dropdown-Menü ein Zeitfenster aus. Nur aktualisierte Bestellungen, die innerhalb dieses Zeitfensters erstellt wurden, werden in regelmäßige Bestellungssynchronisierungen einbezogen. So wird verhindert, dass ältere Bestellungen nach geringfügigen Aktualisierungen erneut abgerufen werden. Allerdings werden alle Bestellungen ausgeschlossen, die vor dem ausgewählten Zeitraum erstellt wurden, auch wenn sie wichtige Aktualisierungen enthalten. Diese Einstellung wirkt sich nicht auf deine anfängliche Synchronisierung historischer Daten aus.
- Einstellungen für Sonderpreise
- Klicke auf Einrichtung abschließen.
Deine Magento 2-Integration ist jetzt aktiviert, und die Synchronisierung deiner historischen Daten hat begonnen.
Nachdem die erste Synchronisierung der Kundenhistorie abgeschlossen ist, wird die Magento 2-Integration alle 30 Minuten synchronisiert.
Synchronisierung deiner historischen Daten bestätigen
- Wähle in Klaviyo Integrationen aus und öffne dann deine Magento 2-Integration.
- Wähle die Registerkarte Daten.
- Sieh dir den Abschnitt historische Daten an. Während der Import läuft, wird der Synchronisierungsfortschritt angezeigt. Wenn der Import abgeschlossen ist, bestätigt der Abschnitt, dass deine historischen Bestellungen, Kund*innen und Produkte synchronisiert wurden, und zeigt ein Datum Zuletzt synchronisiert am an.
Mit der Magento 2-Integration synchronisierte Daten
Die Magento 2-Integration von Klaviyo ruft wichtige Kundeninformationen von deiner Magento-Plattform ab.
Hier sind einige der Daten, die wir von Magento synchronisieren:
- Kundeninformationen wie Vorname, Nachname und Standort.
- Verkaufs- und Bestelldaten, einschließlich gekaufter Artikel, Artikelbilder, Artikelkategorien und angewendeter Rabatte.
- Daten zu Erfüllung, Rückerstattung und stornierten Bestellungen.
- Wenn Besucher*innen deine Website besuchen und welche Artikel sie sich ansehen; das Web-Tracking wird von der Erweiterung übernommen.
Wenn du mehr erfahren möchtest, schau dir unsere Magento 2-Datenreferenz an.
Wandle Magento-Bestellwerte in eine einzige Währung um
Klaviyo unterstützt die Conversion aller Fremdwährungen in Magento in eine primäre Währung in Klaviyo. Bitte kontaktiere den Support, um diese Funktion zu aktivieren. Das ist besonders hilfreich, wenn du mehrere Stores mit Transaktionen in unterschiedlichen 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 deine Erweiterung
Um deine Klaviyo Magento 2-Erweiterung zu aktualisieren, wiederhole die oben genannten Schritte unter Installiere die Klaviyo-Erweiterung in Magento 2, einschließlich der Magento-Upgrade- und Static-Content-Deployment-Befehle. Diese Schritte ersetzen deine aktuelle Erweiterungsversion. Du musst die Erweiterung nicht neu konfigurieren oder die Integration in Klaviyo nicht erneut aktivieren.
Deinen Katalog erneut synchronisieren
Du kannst jederzeit eine vollständige historische Neu-Synchronisierung deines Magento 2-Katalogs anstoßen. Eine Neu-Synchronisierung deines Katalogs kann dir helfen, Klaviyo-Updates für Bestand und variantenbezogene Funktionen zu nutzen. Synchronisiere deinen Katalog neu, nachdem du die Katalog-Synchronisierungseinstellungen geändert hast, um diese Änderungen auf bestehende Produkte anzuwenden.
So synchronisierst du deinen Katalog erneut:
- Wähle in Klaviyo die Registerkarte Integrationen.
- Wähle deine Magento 2-Integration aus der Liste aus.
- Klicke auf die Registerkarte Daten.
- Klicke unter Katalogdaten synchronisieren auf Neu synchronisieren.

Überprüfe den Synchronisierungsfortschritt im selben Abschnitt, während die erneute Synchronisierung läuft. Wenn er abgeschlossen ist, zeigt der Abschnitt ein Datum Zuletzt synchronisiert am an.
Weitere Ressourcen
- Magento-2-Datenreferenz
Erfahre, welche Daten Klaviyo aus deinem Magento 2-Shop importiert, wenn du die beiden Plattformen integrierst. Klaviyo Integrationen mit Magento 2 importiert bei der ersten historischen Synchronisierung alle historische Daten aus deinem Magento 2-Shop. Nach der Aktivierung beginnt die Integration außerdem damit, Bestell- und Kund*innendaten alle 30 Minuten zu synchronisieren. Beispiele für diese Daten sind Informationen, die mit früheren aufgegebenen Bestellungen, erfüllten Bestellungen usw. verknüpft sind.
- Klaviyo Community: Magento 2 "Ask Me Anything" Question and Answer Video