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

Du wirst lernen

Erfahre, wie du Klaviyo in deinen Magento 2 CE oder EE Laden integrieren kannst. Du musst die Klaviyo-Erweiterung in Magento installieren, die Erweiterung konfigurieren, OAuth einrichten und dann die Integration in Klaviyo aktivieren. In diesem Leitfaden findest du alle erforderlichen Integrationsschritte und erfährst, wie du die erfolgreiche Synchronisierung deiner historischen Daten bestätigen kannst. 

Bevor du beginnst

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.

Finde die Version deiner Klaviyo-Erweiterung

Alle Versionsbereiche in der Tabelle sind inklusive. Alle Erweiterungen sind für die Installation über den Composer verfügbar. 

Der Installationsprozess unterscheidet sich je nachdem, welche Magento 2 Version du verwendest. 

Wenn du Magento 2 Version 2.4.0 oder höher verwendest, befolge die Anweisungen im Abschnitt Installieren mit Composer weiter unten.

Für diejenigen, die Magento 2 Versionen vor 2.4.0 verwenden: Wir haben Patches veröffentlicht, um die Kompatibilität zwischen älteren Versionen unserer Erweiterungen und unserer neuen API herzustellen. Die Github-Links findest du in der Tabelle oben, und du kannst sie auch über Packagist/Composer installieren. Du musst die Installation mit der Methode durchführen, die du derzeit für die Installation von Erweiterungen verwendest (wenn das der Composer ist, kannst du den Abschnitt Installieren mit dem Composer unten befolgen). Wenn du Magento 2 Version 2.2.0 verwendest, musst du nach der Installation auch OAuth manuell aktivieren.

Installiere die Klaviyo-Erweiterung in Magento 2

Anleitung zum Video

Mit Composer installieren

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 die neueste Version der Klaviyo-Erweiterung von Packagist zu erhalten. 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
3. Wenn du eine ältere Version der Magento 2-Erweiterung mit Composer installieren musst, gib die Version an, die du installieren möchtest. Zum Beispiel:
   composer require Klaviyo/magento2-extension:3.0.4-patch
4. 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
5. Wie in der Beispielausgabe angezeigt, musst du nun alle zusätzlichen Module aktivieren. Führe den folgenden Befehl aus, um sie zu aktivieren:
   php bin/Magento setup:upgrade
6. Überprüfe die Ausgabe für das Modul "Klaviyo_Reclaim", um sicherzustellen, dass das Klaviyo-Modul aktiviert ist und läuft.
7. Um sicherzustellen, dass CSS und JS auf deinem Magento 2 Laden weiterhin richtig funktionieren, musst du einen Befehl zum Bereitstellen statischer Inhalte ausführen.
   php bin/Magento setup:static-content:deploy -f
8. 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. Wir haben einen separaten Leitfaden für diejenigen, die eine bestehende Integration haben und OAuth hinzufügen müssen. Wenn du Magento 2 Version 2.2.0 verwendest, besuche unsere Anleitung zur manuellen Aktivierung von OAuth für deine Integration. 

1. Navigiere zur Registerkarte Setup OAuth in Magento.
2. Gib deiner Integration einen einprägsamen Namen, da du sie später unter diesem Namen wiederfinden musst.
3. Klicke auf Save Config , um fortzufahren.
   
4. Sucheim linken Navigationsbereich nach "System" und wähle " Integrationen" in der Systemablage.
5. Suche den Namen deiner Integration und klicke auf Aktivieren. Wenn du die Integration aktivierst, öffnet sich ein Fenster, in dem du aufgefordert wirst, den Zugriff zu genehmigen.
   
6. Klicke auf " Zulassen", um zu Klaviyo weitergeleitet zu werden, wo du die Einrichtung der Integration abschließen kannst.
   
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 zu dem Klaviyo-Konto hinzugefügt, das mit dem API-Schlüssel verknüpft 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 sich das Fenster automatisch schließt, war die Verbindung erfolgreich. Du kannst den Erfolg auch bestätigen, indem du dein Klaviyo-Konto in einem neuen Browser-Tab oder -Fenster öffnest, die Registerkarte Integrationen auswählst und in der Liste nach Magento 2 suchst.

Wenn du stattdessen die folgende Fehlermeldung erhältst, vergewissere dich, dass die im ersten Schritt verwendeten API-Schlüssel mit dem Konto übereinstimmen, mit dem du gerade eingeloggt 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 Save Config.

Zustimmung bei Bezahlvorgang einholen

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

Bitte beachte, dass du, wenn du die Zustimmung bei Bezahlvorgang aktivierst, auch den Webhook (siehe unten) aktivieren musst, damit die Zustimmung bei Bezahlvorgang richtig funktioniert. 

1. Auf der Seite Konfiguration, unter Klaviyozu Zustimmung bei Bezahlvorgang navigieren.
   
2. Du siehst einen Abschnitt zum Sammeln der E-Mail-Einwilligung und SMS-Einwilligung. Die beiden werden getrennt behandelt, sodass du nur E-Mail, nur SMS oder beides sammeln kannst. Wenn du sowohl SMS als auch E-Mail-Abonnent sammelst, wähle eine andere Liste für SMS als für E-Mail. So wird sichergestellt, dass die Zustimmung 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 Kontakt zum E-Mail-Marketing bei Bezahlvorgang abonnieren.
4. Wähle eine E-Mail-Liste aus, mit der du dein Abonnent synchronisieren möchtest, z.B. einen Newsletter.
5. Gib den Text für das E-Mail-Opt-in-Kontrollkästchen ein, das du verwenden möchtest.
   
6. Unter SMSwählst du Ja für Kontakt zu SMS-Marketing bei Bezahlvorgang abonnieren.
7. Wähle die Liste, mit der dein SMS Kontakt synchronisiert werden soll. Weitere Details zu diesen Einstellungen findest du in unserem Leitfaden zum Sammeln von SMS-Einwilligung bei 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 Save Config.

Webhook aktivieren

1. Navigiere im Admin Dashboard zu Laden > Konfiguration.
2. Klicke auf Klaviyo und wähle die RegisterkarteWebhook. 
3. Erstelle ein Webhook-Geheimnis und gib es in das entsprechende Feld Webhook Geheimnisein. Das Webhook-Geheimnis ist ein Schlüssel, den Klaviyo für die Validierung verwendet. Du kannst das Geheimnis frei wählen, aber wir empfehlen, eine sichere Zeichenfolge aus Buchstaben und Zahlen zu erstellen. Magento versteckt dein Webhook-Geheimnis aus Sicherheitsgründen mit Sternchen, also achte darauf, dass du es richtig eingibst.
   
   Wenn du eine Multi-Laden-Integration verwendest, sollte das Webhook-Geheimnis in diesem Feld in deiner Standardkonfiguration eingegeben werden, und dasselbe Geheimnis wird als Validierung für jede Laden-Konfiguration verwendet. Das Webhook-Geheimnis sollte nur zur Standardkonfiguration hinzugefügt werden und nicht per Laden.
4. Wähle neben dem Webhook, den du aktivieren möchtest, Ja aus dem Dropdown-Menü. Wenn du mehr über den von Klaviyo unterstützten Webhook erfahren möchtest, sieh dir unseren Leitfaden zum Webhook für Magento 2an.
5. Klicke auf Save Config.

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 Kunden zu einer Klaviyo Liste hinzuzufügen. Klicke auf das Kontrollkästchen Magento 2 Kunde zu einer Klaviyo Liste hinzufügen und wähle eine Liste aus dem Dropdown-Menü. Wenn du diese Einstellung aktivierst, werden die Kunden nur der ausgewählten Liste hinzugefügt, aber nicht für Marketingnachrichten angemeldet.
   
   Mit dieser Einstellung werden nur neue Kunden synchronisiert; bestehende Kunden müssen manuell von deiner Magento Liste auf Klaviyomigriertwerden.
3. Aktiviere unter Erweitert die folgenden Einstellungen nach Bedarf :
   • Laden
     Alle Magento 2 Laden sind standardmäßig mit Klaviyo synchronisiert. Mit dieser Einstellung kannst du auswählen, in welchen Laden du dich integrieren möchtest. Mehr dazu erfährst du unter Supporting multiple Magento Laden. 
   • Sonderpreiseinstellungen
     Diese Einstellung bezieht sich auf einen Sonderverkaufspreis für Artikel, der optional in einem bestimmten Datumsbereich in Kraft treten kann. Wir empfehlen dir dringend, diese Funktion zu aktivieren, wenn du sie nutzen willst, da sie später nur schwer zu aktivieren ist. Wenn du die Option Sonderpreis für Produktpreise verwenden, wenn anwendbar aktivierst, wird im Produktblock der Sonderpreis angezeigt, wenn anwendbar. Wenn du einen dynamischen Produktfeed verwendest, wird der Sonderpreis am Versandzeitpunkt eingefügt. Wenn du Artikel manuell aus deinem Katalog auswählst, wird der Sonderpreis eingeblendet, sobald du das/die Produkt(e) ausgewählt hast. Für jedes Produkt gibt es 4 Metadatenfelder, die synchronisiert werden:
     
     • Preis
       (Erforderlich, Float) Der Standardpreis des Artikels.
     • spezial_preis
       (Optional, Float) Dies ist ein Sonderverkaufspreis für den Artikel. Wenn dieser Preis in Kraft ist, siehst du diesen Sonderpreis neben einem durchgestrichenen Preis.
     • sonderpreis_ab_datum
       (Optional, Datum) Hier wird das Datum angegeben, ab dem der Sonderpreis gültig sein soll.
     • spezial_bis_datum
       (Optional, Datum) Hier wird ein Enddatum für die Gültigkeit des Sonderpreises angegeben.
   • Benutzerdefinierte Medien-Stamm-URL
     Mit dieser Einstellung kannst du den Standardpfad für deine Website-Bilder ändern. Aktiviere diese Einstellung, wenn du deine Produktbilder unter einer anderen URL als auf deiner Website hostest. 
4. Klicke auf Speichern.

Du hast jetzt erfolgreich die Magento 2-Integration aktiviert! Deine Daten werden innerhalb weniger 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-Datenreferenz. 

Magento Bestellwert in eine einzige Währung umrechnen

Klaviyo Unterstützt die Umrechnung aller Fremdwährungen auf Magento in eine Hauptwährung auf Klaviyo. Bitte kontaktiere den Support, um diese Funktionen zu aktivieren. Das ist besonders hilfreich, wenn du mehrere Läden mit Transaktionen in verschiedenen Währungen hast.

Wenn diese Funktion aktiviert ist:

• Die Umwandlung erfolgt, wenn Magento die Bestelldaten mit Klaviyo synchronisiert. 
• Klaviyo prüft, ob der order_currency_code mit dem eingestellten global_currency_codeübereinstimmt. Wenn dies nicht der Fall ist, rechnet Klaviyo die Bestellsumme von der Bestellwährung in die angegebene globale Währung um, um sicherzustellen, dass deine Finanzanalysen korrekt sind. Bitte beachte, dass die Bestellpositionen in der Bestellwährung bleiben und nicht umgerechnet werden. 

Upgrade deiner Erweiterung

Sieh dir die folgende Tabelle an: Verwendest du eine niedrigere Erweiterungsversion als die, die für deine Magento 2-Version angegeben ist? Wenn das der Fall ist, empfehlen wir, deine Erweiterung sofort zu aktualisieren. Einige ältere Versionen der Erweiterung verwenden die API von Klaviyov1 und v2, die nicht mehr verfügbar sind und nicht mehr wie erwartet funktionieren. Wir stellen spezielle gepatchte Versionen zur Verfügung, um Kunde auf älteren Versionen von Magento 2 zu unterstützen, die in der Tabelle verlinkt sind.

Bestimme zunächst anhand der unten stehenden Tabelle, auf welche Version der Erweiterung du upgraden musst. 

Alle Versionsbereiche in der Tabelle sind inklusive. Alle Erweiterungen sind für die Installation über den Composer verfügbar. 

Jetzt, wo du dich für eine Version entschieden hast, ist es an der Zeit, das Upgrade durchzuführen. Der Upgrade-Prozess unterscheidet sich je nachdem, welche Magento 2 Version du verwendest. 

Wenn du Magento 2 Version 2.4.0 oder höher verwendest, befolge die Anweisungen unter Installation mit Composer und führe den Befehl aus, um die neueste Version zu installieren. Damit wird deine aktuelle Version überschrieben und das Update ist abgeschlossen - es ist nicht nötig, die Erweiterung neu zu konfigurieren oder die Integration in Klaviyo erneut zu aktivieren.

Für diejenigen, die Magento 2 Versionen vor 2.4.0 verwenden: Wir haben Patches veröffentlicht, um die Kompatibilität zwischen älteren Versionen unserer Erweiterungen und unserer neuen API herzustellen. Github-Links findest du in der Tabelle oben, und sie können auch über Packagist/Composer installiert werden. Du musst die Installation mit der Methode durchführen, die du derzeit für die Installation von Erweiterungen verwendest (wenn das der Composer ist, kannst du den Abschnitt Installieren mit dem Composer oben befolgen).

Zusätzliche Ressourcen

• Magento 2 Daten Referenz
• So sammelst du SMS-Einwilligung beim Bezahlvorgang auf Magento 2
• Klaviyo Community: Magento 2 "Ask Me Anything" Frage und Antwort Video