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

Du wirst lernen

Erfahre, wie du mit Magento 1 integrierst. Klaviyo lässt sich sowohl mit Magento 1 CE als auch mit Magento 1 EE integrieren. Wir unterstützen derzeit Magento Versionen 1.5 und höher.

Die Integration von Magento 1 mit Klaviyo erfolgt in zwei Schritten:

1. Aktiviere die Magento Integration in Klaviyo.
2. Installiere die Klaviyo-Erweiterung in Magento.

Dieser Leitfaden behandelt beide Schritte und die damit verbundenen Aufgaben für Magento 1 Laden.

Magento API-Anmeldeinformationen einrichten

Die Magento 1.x Integration mit Klaviyo erfordert das Erstellen einer neuen Rolle mit vollem Ressourcenzugriff und die Zuweisung eines neuen Benutzers zu dieser Rolle. Der Benutzername und das Passwort dieses Benutzers dienen als API-Anmeldedaten.

Klicke in deinem Magento-Adminpanel auf die Registerkarte System und wähle Web Services > SOAP/XML-RPC-Rollen.

Wähle Neue Rolle hinzufügen. Klicke dann auf die Registerkarte Rollenressourcen und setze den Ressourcenzugriff auf Alle.

Wähle die Registerkarte Rolleninfo, benenne die Rolle "Klaviyo," und klicke auf Rolle speichern.

Klicke auf die Registerkarte System und wähle Webdienste > SOAP/XML-RPC-Benutzer.

Wähle Neuen Benutzer hinzufügen.

Klicke auf die Registerkarte Benutzerrolle und setze die Rolle auf Klaviyo.

Klicke auf die Registerkarte Benutzerinfo. Setze den Benutzernamen auf "Klaviyo" und gib einen starken API-Schlüssel ein. Du kannst einen beliebigen alphanumerischen Wert eingeben. Speichere den Benutzernamen und den API-Schlüssel, da du sie verwenden wirst, wenn du die Magento 1 Integration in Klaviyo aktivierst. Gib den Rest der Informationen ein und klicke auf Benutzer speichern.

API Leistung

Um die Leistung deiner Integration zu verbessern, empfehlen wir dringend, das Caching für die beiden Magento Web Services Konfigurationseinstellungen zu aktivieren.

Klicke in deinem Magento-Administrationsbereich auf System > Cache Management.

Aktiviere die Zwischenspeicherung für die beiden Einstellungen der Webdienste-Konfiguration.

Aktiviere die Magento 1 Integration in Klaviyo

Verwende den Magento API-Schlüssel, den du erstellt hast, um die Magento 1 Integration in Klaviyo zu aktivieren.

melde dich bei deinem Klaviyo Konto an und klicke in der linken Navigation auf Integrationen. Dann klickst du auf Integrationen hinzufügen und suchst nach Magento. Klicke auf die Magento-Karte und dann auf Installieren.

Gib die folgenden Informationen ein:

• Site URL
  Die Site URL ist die Adresse deiner Magento-Instanz.
• API-Benutzername
  Der Benutzername, den du für deinen neuen Benutzer mit API-Berechtigungen erstellt hast.
• Passwort / API-Schlüssel
  Der API-Schlüssel, den du für deinen neuen Benutzer erstellt hast.

Klicke jetzt auf Mit Magento verbinden. Du bekommst die folgenden erweiterten Optionen angezeigt, die du bei Bedarf aktivieren solltest:

• Laden
  Alle Magento 1 Laden sind standardmäßig mit Klaviyo synchronisiert. Mit dieser Einstellung kannst du auswählen, in welchen Laden du dich integrieren möchtest. Auf der Seite Supporting Multiple Magento Laden erfährst du mehr. 
• Sonderpreis-Einstellungen
  Wir empfehlen dir dringend, die Sonderpreiseinstellungen zu aktivieren, wenn du diese Funktion nutzen möchtest. Es ist schwieriger, diese Funktion später zu aktivieren. Mehr über diese Einstellung erfährst du im AbschnittSonderpreis weiter unten.
• Gutschein-Einstellungen
  Lies dir diese Anleitung durch, wie du Gutschein in Magento 1 aktivierst und fülle dann diese Felder aus.

Wenn du fertig bist, klicke auf Einrichtung abschließen.

Magento 1 ist jetzt mit Klaviyo verbunden. Als Nächstes fügst du die Klaviyo Extension/Plug-in zu deinem Magento Konto hinzu.

Installiere die Klaviyo-Erweiterung in Magento

Die Klaviyo Erweiterung fügt deinem Magento Laden das Active on Site und Viewed Product Tracking hinzu. Die Installation der Klaviyo Erweiterung für Magento ist ebenfalls erforderlich, um Bezahlvorgang Started Events zu synchronisieren. Es ist wichtig, deine Bezahlvorgang Started Events zu synchronisieren, damit sie deinen Warenkorbabbruch Flow auslösen können.

KlaviyoDie neueste Erweiterung für Magento 1 ist v.1.9.0, Update Oktober 2024: Magento 1 v1.9.0 Extension Download.

Nachdem du die Erweiterung auf deinen Computer heruntergeladen hast, navigiere zu System > Magento Connect > Magento Connect Manager.

Klicke unter Direktes Hochladen der Paketdatei auf Datei wählen und wähle die Erweiterung aus, die du oben heruntergeladen hast. Klicke auf Hochladen. Die Erweiterung wird hochgeladen und installiert.

Sobald du die Erweiterung installiert hast, navigierst du zur Seite der Erweiterung, um die Einstellungen zu konfigurieren.
Klicke auf System > Konfiguration und dann auf Klaviyo unter dem Abschnitt Kunde. Wenn du nach dem Klick auf Klaviyo eine 404-Meldung erhältst, logge dich aus Magento aus und melde dich gleich wieder an.

Setze Aktiviert auf Ja und fülle die anderen Felder aus. Der Verbraucherschlüssel, das Verbrauchergeheimnis, das Autorisierungs-Token und das Autorisierungsgeheimnis können alle leer gelassen werden, es sei denn, du richtest den Gutschein mit Magentoein.

Ein Magento-Anmeldeformular mit einer Klaviyo-Liste synchronisieren

Du kannst optional ein Magento-Anmeldeformular synchronisieren, damit die Nutzer zu einer Klaviyo-Liste hinzugefügt werden.

Erstelle zunächst eine Liste in Klaviyo, die du mit deinem Magento-Anmeldeformular synchronisieren möchtest.

Wenn du dich nicht bereits auf der Registerkarte Allgemeine Einstellungen befindest (wie im vorherigen Abschnitt beschrieben), navigiere zu System > Konfiguration und klicke auf Klaviyo unter dem Abschnitt Kunde.

Wähle aus dem Dropdown-Menü Allgemeine Abonnementliste die Klaviyo Liste aus, mit der du synchronisieren möchtest.

In der Standardeinstellung ist Klaviyo Opt-In-Einstellungen für diese Liste verwenden auf Ja eingestellt , d.h. du verwendest die Klaviyo Einstellungen für diese Liste. Wir empfehlen, dass du diese Einstellung aktiviert lässt. Wenn diese Einstellung aktiviert ist:

• Bei einer Double-Opt-in-Liste: Der/die Nutzer/in erhält eine Bestätigungs-E-Mail, bevor er/sie in die Liste aufgenommen wird. Sobald sie per E-Mail bestätigt haben, werden sie der Liste hinzugefügt und eine Subscribe to Liste Metrik wird erstellt. Wenn du keine Bestätigung erhältst, werden sie nicht in die Liste aufgenommen.
• Für eine Single-Opt-In-Liste: Der Kunde wird zu einer Liste hinzugefügt und eine Subscribe to Liste Metrik wird erstellt.

Wenn Nein, keine Opt-in-E-Mails von Klaviyo senden aktiviert ist, wird nie eine abonnierte Liste Metrik erstellt, wenn ein Profil zu einer Liste hinzugefügt wird. Wir empfehlen diese Einstellung nicht, aber sie ist verfügbar, um eine alte Einstellung zu erhalten.

Einen Magento Cron Job einrichten

Die Klaviyo-Erweiterung nutzt Cron-Jobs, um auf dem neuesten Stand zu bleiben und regelmäßige Wartungsaufgaben durchzuführen.

Gehe im Magento Admin Panel zu System > Konfiguration.

Scrolle ganz nach unten zum Abschnitt Erweitert und wähle System.

Wähle dann Cron (Geplante Tasks). Richte einen Cron ein, der alle 5 Minuten ausgeführt wird, und klicke dann auf Save Config.

Weitere Informationen zum Einrichten von Magento-Cron-Jobs findest du in der Magento-Dokumentation, wo du genauere Informationen zum Einrichten eines Cron-Jobs findest.

cron in einem UNIX-basierten Betriebssystem einrichten

Wenn du Shell-Zugriff auf deinen Server hast, kannst du den Befehl crontab service verwenden. Der Magento-Cron muss alle fünf Minuten laufen, also ist die Zeitkonfiguration:

*/5 * * * *

Die vollständige Zeile in crontab wird wie eine der folgenden aussehen (wir empfehlen die erste Version):

*/5 * * * * /bin/sh Magento/cron.sh
*/5 * * * * /bin/bash Magento/cron.sh
*/5 * * * * /usr/bin/php Magento/cron.php
*/5 * * * * /usr/local/bin/php -f Magento/cron.php

wobei Magento der Ort deiner Magento Installation auf dem Server ist.

Richte cron mit cPanel (oder deinem virtuellen Hosting-Anbieter) ein

Wenn du keinen Shell-Zugang hast, kannst du in der Dokumentation deines virtuellen Hosting-Anbieters nachsehen. Im Folgenden werden wir cPannel als Beispiel verwenden.

Melde dich im cPanel deines Hosting-Accounts an. Suche den Abschnitt "Erweitert" und klicke auf das Symbol "Cron Jobs".

Eine Liste der aktuellen Cron-Jobs wird zusammen mit einem Formular zum Hinzufügen eines neuen Jobs angezeigt. Gib die folgenden Einstellungen in das Formular "Add New Cron Job" ein. Achte darauf, dass du Magento durch den Pfad zu deiner Magento Installation ersetzt. Wenn du dir nicht sicher bist, wie der Pfad lautet oder wie du ihn findest, kannst du ein FTP-Programm verwenden, um die Dateien auf deinem Server zu durchsuchen und das Verzeichnis zu finden, das die Datei cron.sh enthält.

Nachdem du den neuen Cron-Job hinzugefügt hast, solltest du innerhalb von 15 Minuten Bezahlvorgang-Daten in Klaviyo sehen.

Überwachung der Synchronisierung historischer Daten

Wenn du dich zum ersten Mal mit Magento 1 integrierst, synchronisiert Klaviyo die Daten der letzten 90 Tage von Magento 1, damit du sofort mit der Anwerbung deiner neuesten Kunden beginnen kannst. Nach der Synchronisierung deiner letzten 90 Tage beginnt Klaviyo mit der vollständigen Synchronisierung deiner historischen Daten. Je nachdem, wie viele Bestellungen, Kunden und Produkte dein Laden hat, kann es zwischen ein paar Minuten und mehreren Tagen dauern, bis alle deine Daten synchronisiert sind.

Sobald diese historische Synchronisierung abgeschlossen ist, werden alle 30 Minuten neue Daten mit Klaviyo synchronisiert. Um den Fortschritt der ersten Synchronisierung zu überprüfen, klicke auf die Registerkarte Analytics in der Seitenleiste.

Finde die Metrik Placed Order und ändere den Datumsbereich der Grafik, um zu sehen, welche Daten vollständig synchronisiert wurden. Wenn die Synchronisierung abgeschlossen ist, wird die Magento 1-Integration auf derRegisterkarte Integrationen als abgeschlossen markiert. Wenn du selbst überprüfen willst, ob alle Daten aus Magento 1 synchronisiert sind, kannst du die Gesamtbestellungen für ein paar Tage oder eine Woche abgleichen. Bevor du mit der Validierung beginnst, solltest du sicherstellen, dass die Zeitzone deines Kontos mit den Einstellungen in Magento 1 übereinstimmt.

Daten werden mit der Magento 1 Integration synchronisiert

KlaviyoDie Integration von Magento ermöglicht es dir, bestimmte Kunde-Informationen aus deiner Magento Plattform zu ziehen, um gezielte, datengesteuerte E-Mails in Klaviyo zu versenden. Sobald du deine Integration konfiguriert hast, kannst du E-Mails auf der Grundlage des Kundenkaufs und der Website-Aktivität personalisieren und zielgerichtet versenden. Hier sind einige der Daten, die wir von Magento synchronisieren:

• Kundeninformationen wie Vorname, Nachname und Ort.
• Klaviyo synchronisiert alle Kunden, die deine Magento Newsletter-Liste abonniert haben, in Zukunft. Es ist wichtig, dass du sicherstellst, dass jeder Kunde, der auf deiner Magento Newsletter-Liste steht, dem Erhalt von Marketing-E-Mails zugestimmt hat.
• Daten zu erfüllten, erstatteten und stornierten Bestellungen.
• Wann Menschen deine Website besuchen und welche Artikel und Kategorien sie sich ansehen.
  • Diese Metrik wird in deinem Konto als Aktiv auf der Seite und Gesehenes Produkt angezeigt.
  • Mit der Integration musst du das Tracking-Snippet nicht zu deiner Seite Klaviyo Magento hinzufügen, da diese Metrik bereits von unserer Erweiterung übernommen wird.

Mehr dazu erfährst du unter Überprüfen und Verstehen deiner Magento 1-Daten.

Erstelle einen API-Schlüssel mit eingeschränkten Rechten

Diese Dokumentation behandelt die Magento SOAP API, auf der die Klaviyo-Integration aufbaut. Wir empfehlen, den Zugriff auf alle Endpunkte innerhalb des Pfades /API/* zu ermöglichen. Auch wenn diese höchstwahrscheinlich nicht direkt mit den Berechtigungen übereinstimmen, die du beim Einrichten des SOAP-Benutzers und der Rolle siehst (da sich die Berechtigungen in den verschiedenen 1.x-Versionen geändert haben), sind hier die API-Aufrufe, die wir für Magento 1.x machen:

• catalogCategoryTree
• catalogInventoryStockItemList
• catalogProductAttributeInfo
• catalogProductAttributeMediaList
• catalogProductInfo
• katalogProduktListe
• catalogProductTagList
• customerCustomerInfo
• customerCustomerList
• customerGroupList
• salesOrderInfo
• salesOrderList
• shoppingCartInfo
• storeList

Wenn du bestimmte Ports auf die Whitelist setzen musst (z.B. wenn du eine Firewall hast), ist die Magento Integration derzeit auf HTTP/80, aber wenn sie auf 443 verfügbar ist, kann dies geändert werden.

Sonderpreis

Wenn du deine Integrationseinstellungen konfigurierst, hast du die Möglichkeit, "Sonderpreis,", einzubinden. Dabei handelt es sich um einen Sonderverkaufspreis für Artikel, der optional in einem bestimmten Datumsbereich wirksam werden kann. Für jedes Produkt gibt es 4 Metadatenfelder, die wir synchronisieren werden:

• Preis (Erforderlich float): Der Standardpreis des Artikels
• special_price (Optional float): Dies ist ein spezieller Verkaufspreis für den Artikel. Wenn dieser Preis in Kraft ist, siehst du diesen special_price neben einem durchgestrichenen Preis
• special_from_date (Optionales Datum): Hier wird das Datum angegeben, ab dem der Sonderpreis gelten soll.
• special_to_date (Optionales Datum): Hier wird ein Enddatum für die Gültigkeit des Sonderpreises angegeben.

Auf der Einstellungsseite für die Magento 1-Integration gibt es ein Kontrollkästchen für Sonderpreis für Produktpreise verwenden, wenn anwendbar. Wenn diese Einstellung aktiviert ist, wird im Produktblock der Sonderpreis angezeigt, wenn er zutrifft. 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.

Magento Bestellwert in eine einzige Währung umrechnen

Klaviyo Unterstützt die Umrechnung aller Fremdwährungen auf Magento in eine Hauptwährung auf Klaviyo. Wenn diese Funktion aktiviert ist, erfolgt die Konvertierung, wenn Magento die Bestelldaten mit Klaviyo synchronisiert. Das ist besonders hilfreich, wenn du mehrere Läden mit Transaktionen in verschiedenen Währungen hast.

Klaviyo überprüft, ob der order_currency_code mit dem eingestellten global_currency_code übereinstimmt. Wenn das nicht der Fall ist, rechnet Klaviyo die Bestellsumme von der Bestellwährung in die globale Währung um, die du in deinen Integrationseinstellungen angegeben hast. So wird sichergestellt, dass deine Finanzanalysen genau sind.

Upgrade deiner Erweiterung

Verwendest du eine Magento-Erweiterungsversion unter 1.8.3? Wir empfehlen dir, sofort auf die Version 1.8.3 zu aktualisieren. Ältere Versionen der Erweiterung verwenden Klaviyo's v1 und v2 API, die nicht mehr verfügbar sind und nicht mehr wie erwartet funktionieren. 

Um deine Erweiterung zu aktualisieren, entferne deine alte Erweiterung und befolge dann die Schritte in diesem Leitfaden, um sie neu zu installieren. Du kannst die Version 1.8.3 hier herunterladen: Magento 1 v1.8.3 Extension Download.