Klaviyo – Deliver Smarter Marketing
Vollständige Klaviyo-Integration für Shopware: Echtzeit-Event-Tracking, Newsletter-Listen-Sync, Back-in-Stock, Produktkatalog-Export und Coupon-Übertragung – DSGVO-konform via Cookie Consent.
Highlights
- Vollständige Klaviyo-Integration – E-Commerce Events, Newsletter-Listen, Back-in-Stock, Coupon-Sync, Produktkatalog-Export – alles in einem Plugin.
- Echtzeit-Event-Tracking – Verfolgt Shopbesucher, angeschaute Produkte, gestartete Checkouts, Bestellungen und Warenkorbaktionen – via JavaScript oder Server-Side API.
- DSGVO-konform – Events werden nur übertragen, wenn der Kunde das Klaviyo Cookie akzeptiert hat. Cookie-Name: „shopsyKlaviyo“.
- Historische Daten & Gutschein-Sync – Bestehende Bestellungen und Shop-Coupons können direkt nach Klaviyo übertragen werden.
Über die Erweiterung
Shopware Integration für Klaviyo
Newsletter einfach versenden an Kunden aus Deinem Shop.
Dieses Plugin bietet eine vollständige Klaviyo Integration. Alles Nötige ist bereits im Plugin enthalten.
Bitte beachten, dass Javascript Events (viewed product, added to cart, started checkout, checkout completed) nur nach Klaviyo übertragen werden, wenn das Klaviyo Cookie über den Shopware Consent Manager vom Kunden akzeptiert wurde (Stichwort DSGVO). Diese Funktion kann seit Version 1.0.5 in den Plugineinstellungen deaktiviert werden.
Ist der Kunde nicht eingeloggt, hat sich mit dem gleichen Browser aber vorher einmal eingeloggt, werden die Daten ebenfalls nach Klaviyo übertragen.
Informationen zu den Klaviyo Events: Guide to Integrating a Standard Ecommerce Platform Weitere Informationen zu Klaviyo direkt bei klaviyo.com
Versionshistorie
- Ab Plugin Version 1.0.1: Produkt-Katalog kann automatisiert nach Klaviyo übertragen werden.
- Ab Plugin Version 1.1.0: Newsletter Subscriber werden direkt in die entsprechenden Klaviyo-Listen eingetragen.
- Ab Plugin Version 1.1.4: ServerSide API Events für alle Events nutzbar.
- Ab Plugin Version 1.2.0: „Back in Stock“-Funktion wird unterstützt.
- Ab Plugin Version 1.2.1: Property „checkOutURL“ via ShareBasket.
- Ab Plugin Version 1.6.6: „checkOutURL“ auch ohne zusätzliches Plugin setzbar. Coupon-Status-Aktualisierung via Scheduled Task.
- Ab Plugin Version 1.8.9: Alle historischen Bestellungen via Scheduled Task nach Klaviyo übertragbar.
Die Einrichtung kann bei Problemen kostenlos per Screensharing zusammen durchgeführt werden: Kontaktformular
Technische Details
- Kompatibel mit Shopware 5 & 6
- Verfügbar in: Deutsch
Anleitung SW6 - App und Self-Managed
1. Installation & API-Keys einrichten
Shopware Admin → Erweiterungen → Meine Erweiterungen → Klaviyo – Deliver Smarter Marketing installieren & aktivieren.
Anschließend: Erweiterungen → Meine Erweiterungen → Klaviyo → Konfiguration.
PUBLIC API-Key
Den öffentlichen API-Key aus Klaviyo eintragen. Bei mehreren Verkaufskanälen oben den Kanal wechseln und jeden einzeln konfigurieren.
PRIVATE API-Key
Nur nötig, wenn die Newsletter-Funktion verwendet wird.
Methode zum Tracking der Events
Klaviyo empfiehlt JavaScript Events. Hinweis: Einige Events (z.B. Fulfilled Order, Purchased Items) werden immer über die Server-Side API übertragen.
Klaviyo Cookie erforderlich (DSGVO)
Events werden nur übertragen, wenn der Kunde das Cookie „shopsyKlaviyo“ akzeptiert hat. Wird nicht der Shopware Consent Manager verwendet, muss diese Option deaktiviert oder das Cookie im eigenen Manager eingetragen werden.
Track Ordered Product / Placed Order / Placed Order Extra Daten
Rechnungs- und Versandadresse zusätzlich im „Placed Order“ Event übertragen.
Track Purchased Items
Event bei Zahlstatus „Komplett bezahlt“.
Track Fulfilled Order
Event bei Bestellstatus „Komplett ausgeliefert“.
Track Cancelled Order / Refunded Order
Events bei Stornierung oder Rückgabe.
Back in Stock
Kunden können benachrichtigt werden, wenn Artikel wieder verfügbar sind. Voraussetzung: Produkte müssen über den Produktexport in Klaviyo vorhanden sein.
Optionen: Double-Opt-in, Datenschutz-Checkbox, CAPTCHA konfigurierbar.
Newsletter Abonnenten syncen
Abonnenten werden direkt in Klaviyo-Listen eingetragen – nach Verkaufskanal und Sprache (Listenname: „Shopware_Newsletter_[Verkaufskanal]_[Sprache]“). Double-Opt-in in Shopware deaktivieren – Klaviyo übernimmt das.
Klaviyo API-Test
Testet die Verbindung zu Klaviyo. Bitte unter „Alle Verkaufskanäle“ ausführen. Ergebnis unter Klaviyo → Audience → Profiles einsehbar.
2. Produktkatalog-Export einrichten
Bei Installation wird automatisch ein Produktexport-Verkaufskanal erstellt. Dieser muss noch minimal nachkonfiguriert werden.
Schritte:
- Unter Kataloge → Dynamische Produktgruppen: Den Eintrag „Klaviyo“ editieren und Bedingungen definieren (Standard: alle aktiven Produkte).
- Verkaufskanal „Klaviyo Catalog Feed“ öffnen und konfigurieren: Storefront Verkaufskanal, Domain und Währung auswählen. Dateiname:
klaviyo.xml, Zeichenkodierung: UTF-8, Format: XML. „Varianten als eigene Produkte exportieren“ empfohlen. API-Zugangsschlüssel generieren → Export-URL kopieren.
Template einrichten: Im Verkaufskanal auf den Tab „Template“ klicken und den Code aus der beiliegenden Datei einfügen. Dann „Template testen“ und „Vorschau generieren“.
Klaviyo Product Feed Template herunterladen
In Klaviyo einrichten: Content → Products → Add new Source. Export-URL aus Shopware eintragen → „Define Source“. Unter „Configure Field Mapping“ sind keine Änderungen nötig, wenn das mitgelieferte Template verwendet wird. → „Complete Feed setup“.
3. Historische Bestellungen übertragen
Im Shopware Bestelllisting: Bestellungen markieren → Drei-Punkte-Button → gewählte Events („Fulfilled Order“ oder „Purchased Items“) nach Klaviyo übertragen.
Ab Plugin Version 1.8.9 auch via Scheduled Task oder Konsole möglich:
php console scheduled-task:run-single shopsy.klaviyo.historical_orders_sync
Bitte beachten: Bei sehr vielen Bestellungen kann die Verarbeitung mehrere Stunden dauern.
4. Gutscheine (Coupons) nach Klaviyo syncen
Aktive Promotions aus der Shop-Administration können nach Klaviyo übertragen werden – für die Verwendung in Flows und Kampagnen. Nur individuelle Coupons werden in Klaviyo angelegt. Bereits vorhandene Coupons werden nicht erneut erstellt.
Promotions nach Klaviyo übertragen:
Im Promotion-Listing auf den Button „Promotions nach Klaviyo übertragen“ klicken.
Einzelne Promotion übertragen:
In der Detailansicht einer Promotion möglich.
Status aktualisieren:
Mit „Promotions in Klaviyo aktualisieren“ werden eingelöste Coupons automatisch aus Klaviyo entfernt. Ein Scheduled Task („shopsy.klaviyo_update_promotions“) übernimmt dies auch automatisch.
Bei Fragen stehe ich per Kontaktformular zur Verfügung.
