Allgemeine Informationen

Funktionen des Plugins:

• Klaviyo Newsletter versenden und Automatisierung mit Klaviyo Flows
• Kunden- und Bestellinformationen & Website Events zu Klaviyo synchronsieren
• Alternativ zum JavaScript Tracking ist ein ServerSideTracking Events ohne Benutzer Consent möglich

Egal, ob Sie eine Migration von JTL Shop zu Klaviyo planen oder weiterhin die bewährte Newsletterfunktion von JTL nutzen möchten – unser Plugin ermöglicht eine mühelose Synchronisation Ihrer Newsletterempfänger von JTL Shop 5 zu Klaviyo. So stellen Sie sicher, dass Ihre Kommunikationskanäle stets auf dem neuesten Stand sind und keine wertvollen Kontakte verloren gehen.

Unser Plugin überträgt alle relevanten Eventdaten aus Ihrem JTL Shop zu Klaviyo. Dadurch erhalten Sie detaillierte Einblicke in die Aktivitäten Ihrer Kunden, von Seitenaufrufen und Produktansichten bis hin zu Bestellungen und Versandinformationen inklusive Trackingnummern. Diese Daten ermöglichen Ihnen die Erstellung hochgradig personalisierter Klaviyo-Flows und Marketingautomatisierungen, die Ihre Kunden gezielt ansprechen und zu höheren Konversionsraten führen.

Nutzen Sie diese Segmente, um spezifische Marketingmaßnahmen durchzuführen und Ihre Zielgruppe mit maßgeschneiderten Angeboten und Nachrichten zu begeistern. Erhöhen Sie Ihre Marketingeffizienz und erzielen Sie beeindruckende Ergebnisse durch gezielte Ansprache und individuelle Kundeninteraktionen.

Erleben Sie die volle Kraft Ihrer Daten und optimieren Sie Ihr Marketing wie nie zuvor. Mit dem JTL Shop 5 und dem Klaviyo Integrations-Plugin können Sie Ihr E-Commerce-Geschäft auf das nächste Level bringen. Überzeugen Sie sich selbst!

Verbinde deinen Klaviyo Account mit dem Plugin

Um Ihren JTL-Shop mit Klaviyo zu verbinden, müssen Sie zunächst einen Klaviyo-Account erstellen. Sollten Sie noch keinen Account haben, können Sie sich hier einen neuen Account registrieren. Nach der erfolgreichen Registrierung benötigen wir den Public Key sowie einen neu generierten Private Key. Diese Einstellungen finden sie bei Klaviyo unten links unter "Settings" und dann im Bereich "Account".

Den Public sowie den Private Key tragen sie im installierten Plugin in den Einstellungen ein.

Nach der Installation können Sie im Plugin diverse Einstellungen vornehmen, um das Tracking zu konfigurieren. Sie haben die Wahl zwischen JavaScript-basiertem Tracking mit Zustimmung des Nutzers und serverbasiertem Tracking ohne Benutzerconsent. Beim serverbasierten Tracking sind ggf. nicht alle Website-Events verfügbar.

Auf Wunsch können Sie auch alle bestehenden Newsletterempfänger von JTL Shop zu Klaviyo übertragen oder nur diejenigen Empfänger, die ihren Double-Opt-In-Consent im JTL Shop gegeben haben. Dieses Feature ist insbesondere für eine initiale Migration des Newslettersystems von JTL Shop zu Klaviyo von Interesse.

Event Übersicht

Event Name	Auslöser	Beschreibung	Daten
Active on Site	Javascript	User ist das erste Mal in der Session auf der Seite aktiv	Seite, Browser, OS
Viewed Product	Javascript	User hat sich eine Produktseite angeschaut	Artikelname, URL, Preis, SKU, Image
Viewed Category	Javascript	User hat sich eine Kategorieseite angeschaut	Name, ID, URL
Added to Cart	Javascript	User hat ein Produkt in den Warenkorb gelegt	Artikelname, SKU, Preis, Menge, URL
Started Checkout	Javascript	User hat den Checkout Prozess gestartet	Artikelname, SKU, Preis, Menge, Total
Checkout Completed	Javascript	User hat den Checkout komplett abgeschlossen	Artikelname, SKU, Preis, Menge, Total, Email, Kunde
Ordered Product	Server Side	User hat ein Produkt bestellt, je Produkt ein Event	Artikelname, SKU, Preis brutto/netto, Menge
Purchased Item	Server Side	User hat ein Produkt gekauft, Bestellung ist bezahlt, je Produkt ein Event	Artikelname, SKU, Preis brutto/netto, Menge
Placed order	Server Side	User hat eine Bestellung im Shop aufgegeben, enthält alle bestellten Produkte	Artikel, Lieferadresse, Rechnungsadresse, Zahlungsart, Versandart, Bestellnummer, Lieferkosten
Fulfilled Order	Server Side	Die Bestellung hat den Status Ausgeliefert erreicht.	Bestellnummer, Lieferkosten, Artikel, Trackinglink
Cancelled Order	Server Side	Die Bestellung hat den Status Storniert erreicht.

Server Side:
ein Tracking erfolgt nur, wenn der User eingeloggt ist. Ein Consent ist nicht erforderlich, es wird kein JS geladen, Klaviyo Forms funktionieren nicht.

Javascript:
es kann bereits getrackt werden, bevor der User sicht einloggt, Option User Consent erforderlich regelt, ob User immer getrackt wird oder nur nach seinem Consent. Die nachfolgenden Track Events sind immer serverseitig und werden auch ausgelöst, wenn der User keinen Consent gibt.

Einstellungen im Plugin

Generelle Einstellungen

Einstellung	Werte	Beschreibung
Debug	Ja / Nein	Wenn der Debug Modus aktiviert ist, werden zusätzliche Informationen ins Log geschrieben.
PUBLIC Api-Key von Klaviyo	Api Key	PUBLIC API-Key aus dem Backend von Klavyio hier eintragen. Bitte beachten, dass der public key verwendet wird!
PRIVATE Api-Key von Klaviyo	Api Key	PRIVATE API-Key von Klaviyo
Tracking Methode	Javascript / ServerSide	ServerSide = ein Tracking erfolgt nur, wenn der User eingeloggt ist. Ein Consent ist nicht erforderlich, es wird kein JS geladen, Klaviyo Forms funktionieren nicht. | Javascript: es kann bereits getrackt werden, bevor der User sicht einloggt, Option User Consent erforderlich regelt, ob User immer getrackt wird oder nur nach seinem Consent. Die nachfolgenden Track Events sind immer serverseitig und werden auch ausgelöst, wenn der User keinen Consent gibt.
User Consent erforderlich (nur relevant bei JS)	Ja / Nein	Kunde muss Klaviyo über den Consentmanager akzeptieren, bevor die klaviyo.js geladen wird und Eventdaten / Anmeldeformulare geladen werden.
Fullfillment Events splitten	Ja / Nein	Ja = Es werden einzelne Fulfillment Events mit den jeweiligen gelieferten Positionen übertragen (für jeden Lieferschein) [Standard], NEIN = In jedem Fulfillment Event werden alle (bereits gelieferten) gelieferten Positionen übergeben (Workaround für Kunden mit störenden Plugins)

Event Einstellungen

Einstellung	Werte	Beschreibung
Track "ordered product"	Ja / Nein	Event "ordered product" übertragen.
Track "placed order"	Ja / Nein	Event "placed order" übertragen.
Track "fulfilled order"	Ja / Nein	Event "fulfilled order" übertragen.
Track "purchased items"	Ja / Nein	Event "purchased items" übertragen.
Track "cancelled order"	Ja / Nein	Event "cancelled order" übertragen.

Newsletter Einstellungen

Einstellung	Werte	Beschreibung
Newsletter Abonnenten → Klaviyo List	Ja / Nein	Newsletter Abonnenten bei einem "subscribe/unsubscribe" in Liste bei Klaviyo hinzufügen/entfernen.
Klaviyo ListID für Newsletter Empfänger	Klaviyo List ID	ListID aus Klaviyo, welche für die Newsletter Empfänger verwendet wird. Wird die vorherige Option auf "Ja" gesetzt, ist diese Einstellung zwingend erforderlich! Bitte beachten, dass die Liste in Klaviyo unter "Settings → Consent" auf "single-opt" gestellt ist, der DOI kann aktuell in JTL noch nicht unterdrückt werden.
Alle Newsletter Abonnenten übertragen	Ja / Nein	Ja = es werden alle Newsletterempfänger übertragen | Nein = es werden nur Newsletterempfänger übertragen, die ihren Double Opt-In im JTL Shop durchgeführt haben.

Back in Stock Einstellungen (Produktexport)

Einstellung	Werte	Beschreibung
Back in stock	Ja / Nein	Back in Stock in Klaviyo nutzen.
Artikelnummer oder Interne Artikel ID	Artikelnummer / Interne Artikel ID	Definition, welches Feld im Export genutzt werden soll, damit das Matching in Klaviyo funktioniert.

Historische Daten

Einstellung	Werte	Beschreibung
Klaviyo ListID für Historische Daten	List ID	ListID aus Klaviyo, welche für die historischen Daten verwendet wird. Wird dieses Feld leer gelassen, werden die Profile keiner Liste hinzugefügt.
Historische Daten bis gewähltem Datum übertragen	Datum	Bestellungen nur bis zu einem gewählten Datum übertragen, sinnvoll wenn historische Daten vor der Aktivierung es Plugins übertragen werden sollen.
Historische Daten bis gewählter Zeit übertragen	Uhrzeit	analog zur vorherigen Einstellung: Bestellungen bis einem gewählten Zeitpunkt übertragen

Template Variablen

Diese Einstellungen können sinnvoll sein, falls das Viewed Product Event keine Daten liefert. Das Plugin holt sich hier die Inhalte aus dem DOM der Produktdetailsseite, welche je nach eingesetztem Template abweichen kann.

Einstellung	Werte	Beschreibung
HTML-Selektor Produktname	HTML Tag	HTML-Selektor für den Produktnamen auf der Produkt Detailseite
HTML-Selektor SKU	HTML Tag	HTML-Selektor für die SKU auf der Produkt Detailseite
HTML-Selektor Bild-URL	HTML Tag	HTML-Selektor für die Bild-URL auf der Produkt Detailseite
HTML-Selektor Preis	HTML Tag	HTML-Selektor für den Preis auf der Produkt Detailseite
HTML-Selektor Hersteller	HTML Tag	HTML-Selektor für den Hersteller auf der Produkt Detailseite
HTML-Selektor Produkt-URL	HTML Tag	HTML-Selektor für die Produkt-URL auf der Produkt Detailseite

Newsletter

Über den Button können alle bereits im JTL Shop hinterlegten Newsletter Empfänger zu Klaviyo übertragen werden. Hierfür muss zwingend eine Liste in den Einstellungen hinterlegt werden. Diese Funktion kann bei der initialen Einrichtung von Klaviyo zur Datenübernahme genutzt werden. Wir verweisen auf die Opt-in Einstellung der Liste, so dass übertragene Profile nicht erneut eine Double-Opt-in Einladung erhalten.

Produktexport

Mit dem Klick auf den Button wird im Hintergrund eine Produktexportstruktur im JTL Shop unter Administration -> Export -> Weitere Formate angelegt. Basierend auf der Einstellung im ersten Plugin Reiter wird als ID entweder die interne kArtikel ID aus JTL Shop oder die SKU verwendet. Die URL https://IHREURLVOMSHOP/export/klaviyo.xml kann dann als Produktfeed in Klaviyo importiert und die Produktdaten dann in den Flows / Kampagnen verwendet werden.

Historische Daten

Per Button Klick übertragt das Plugin die historischen Daten, genauer gesagt die Events Placed Order und Ordered Product, an Klaviyo und erstellt ggf. die noch nicht vorhandenen Profile. Bei der Selektion kann ein Datum sowie eine Uhrzeit in den Einstellungen angegeben werden, bis zu diesem die Daten aus dem JTL Shop exportiert werden. Diese Funktion ist wichtig, wenn das Plugin zu einem Zeitpunkt X eingerichtet und aktiviert wurde, neue Events bereits gesendet werden, man aber die Historie noch übertragen möchte. Das Plugin speichert sich alle übermittelten Events, so dass es zu keinen doppelten Übertragungen kommt.

Wichtig:Wenn die Übertragung aufgrund eines Server Timeouts abbricht, kann die Übertragung mit einem erneuten Klick auf den Button wieder aufgenommen werden.

Wichtig:Profile (neu angelegte und auch bestehende) können in eine Liste übernommen werden. Diese kann in den Einstellung definiert werden. Bitte darauf achten, welche Opt-in Methode in der Liste definiert ist. Ist keine Liste angegeben, werden die Profile ohne Liste in Klaviyo angelegt. Wir verweisen hier auf die API Einstellung, bei der man auch festlegen kann, ob ein Double-Opt-in bei über die API angelegten Profilen durchgeführt werden soll.

Coupons

Über den Button werden aktive Coupons aus dem JTL Shop als API Gutschein in Klaviyo angelegt. Hierbei ist zu beachten, dass die Kupons als Einfachverwendung eingestellt werden, da Mehrfachverwendungen in Klaviyo nicht möglich sind. Der Name des Coupons darf nicht länger aus 32 Zeichen sein und keine Sonderzeichen enthalten. Das Plugin speichert sich, welche Coupons bereits an Klaviyo übertragen wurden. Wir empfehlen Coupons per Massengenerierung in JTL Shop anzulegen.

Über einen Cronjob alle X Stunden übermittelt das Plugin die eingelösten Coupons an Klaviyo, so dass diese dort ebenfalls als eingelöst zu finden sind und man ggf. auf das Event reagieren kann.

Event Log

Im Event Log speichert das Plugin alle an Klaviyo übermittelten Ordered Product sowie Placed Order Events. Das Ganze funktioniert auch mit den historischen Events, so dass gerade bei der initialen Massendatenübernahme von historischen Daten ein Status ersichtlich ist.

Weitere Hinweise

Bitte beachten Sie, dass die Übertragung von Javascript Events (Viewed Product, Added to Cart, Started Checkout, Checkout Completed) an Klaviyo nur nach Akzeptanz des Klaviyo Cookies über den JTL Consent Manager durch den Kunden erfolgt (Stichwort DSGVO). Diese Funktion kann in den Plugineinstellungen nach Bedarf deaktiviert werden, davon raten wir jedoch ab.