Erste Schritte mit Shopware

Übersicht

Hier erfährst du, wie du Shopware 6 integrieren und Daten zu Site-Aktivitäten, Bestellungen, Katalogen und Abonnenten in Klaviyo übertragen kannst.

Bevor du anfängst

Bitte beachte Folgendes:

• Vergewissere dich vor der Integration, dass du bei dem Klaviyo-Konto angemeldet bist, das du integrieren möchtest.
• Die Shopware-6-Integration wird Klaviyo über einen Drittanbieter unterstützt. Wenn du den Support kontaktieren musst, lies im Abschnitt unten nach, wie das geht.

Plug-in zu deinem Shopware-Konto hinzufügen

1. Gehe im Shopware Store zur Klaviyo-Plug-in-Seite.
2. Melde dich an, wenn du dazu aufgefordert wirst, und wähle dann In den Warenkorb.
3. Gehe zum Bezahlvorgang und schließe deine Bestellung ab.
4. Sobald die Bestellung bestätigt wurde, klicke auf die Option, um zu deinem Shopware-Konto zu gelangen.
5. Navigiere in deinem Shopware-Konto zu Händler > Shops.
6. Wähle den Shop aus, für den du die Plug-in gekauft hast.
7. Suche im Abschnitt „Lizenzen“ die Klaviyo Plug-in und öffne die Plug-in-Detailseite.

Lade die Erweiterung herunter und installiere sie

Du kannst die Installation über eine von zwei Methoden durchführen: über Composer oder über das Herunterladen unserer Erweiterung. Nachdem du eine Installationsmethode ausgewählt hast, solltest du diese Methode bei jedem Update verwenden.

Installation über Composer

Bei der Installation über Composer musst du die Klaviyo-Erweiterungsversion angeben. Nicht alle Erweiterungen funktionieren für alle Shopware-Versionen.

Verwendest du eine Shopware-Version zwischen 6.4.4.0 und 6.4.XX.XX? Führe den Befehl mit der folgenden Erweiterungsversion aus:

composer require klaviyo/shopware-klaviyo:1.23.0

Verwendest du eine Shopware-Version zwischen 6.5.0.0 und 6.5.XX.XX? Führe den Befehl mit der folgenden Erweiterungsversion aus:

composer require klaviyo/shopware-klaviyo:2.23.0

Verwendest du eine Shopware-Version zwischen 6.6.0.0 und 6.6.XX.XX? Führe den Befehl mit der folgenden Erweiterungsversion aus:

composer require klaviyo/shopware-klaviyo:3.7.0

Verwendest du Shopware Version 6.7.0.0 oder höher? Führe den Befehl mit der folgenden Erweiterungsversion aus:

composter require klaviyo/shopware-klaviyo:4.3.0

Installation per Upload

1. Öffne die Plug-in-Detailseite und lade die neueste verfügbare Version (oder eine erforderliche Version) herunter:
   
   • Verwendest du eine Shopware-Version zwischen 6.4.4.0 und 6.4.XX.XX? Lade Klaviyo-Erweiterung Version 1.23.0 herunter.
   • Verwendest du eine Shopware-Version zwischen 6.5.0.0 und 6.5.XX.XX? Lade die Klaviyo-Erweiterungsversion 2.23.0 herunter.
   • Verwendest du eine Shopware-Version zwischen 6.6.0.0 und 6.6.XX.XX? Lade die Klaviyo-Erweiterung Version 3.7.0 herunter.
   • Verwendest du Shopware Version 6.7.0.0 oder höher? Lade Klaviyo-Erweiterungsversion 4.3.0 herunter.
2. Melde dich bei deinem Shopware-Admin-Konto für den Shop an, den du integrieren möchtest.
3. Klicke auf Erweiterungen > Meine Erweiterungen.
4. Klicke auf Erweiterung hochladen und wähle die ZIP-Datei aus, die du von deinem Shopware-Konto heruntergeladen hast. Während des Uploads siehst du möglicherweise eine Warnmeldung. Klicke auf Bestätigen, um fortzufahren.
   

5. Sobald die Erweiterung in deiner Erweiterungsliste erscheint, klicke auf Installieren.
   

6. Aktiviere die Klaviyo-Erweiterung.
   

Erweiterung in Shopware konfigurieren

1. Navigiere in deinem Shopware-Shop-Admin-Bereich zu den Einstellungen und klicke auf die Registerkarte Erweiterungen .
2. Wähle Klaviyo. Du wirst zur Einstellungsseite der Klaviyo-Erweiterung weitergeleitet.
3. Wähle unter Sales Channels (Vertriebskanäle) aus dem Drop-down-Menü den Vertriebskanal aus, den du mit Klaviyo integrieren möchtest. Integriere nur einen Vertriebskanal mit Klaviyo pro Shopware-Shop. Außerdem musst du deine Einstellungen für jeden Vertriebskanal individuell konfigurieren.
4. Wähle unter Interaktionseinstellungen das Cookie-Einwilligungstool aus, das du mit dieser Integration verwenden möchtest. Hinweis: Besucher, die keine Klaviyo-Cookies akzeptieren, werden von Klaviyo nicht getrackt und können auch keine Klaviyo-Formulare anzeigen. Die Optionen für das Cookie-Einwilligungstool sind:
   • Nichts
     Wenn diese Option aktiviert ist, hat Klaviyo kostenlosen Zugang zum Speichern von Cookies.
   • Shopware-Standard
     Wenn diese Option aktiviert ist, wird die Cookie-Verwaltung über die Standardmethode von Shopware implementiert, sofern sie aktiviert ist. Um sie zu aktivieren, navigiere zu Einstellungen > Shop > Grundlegende Informationen, suche den Abschnitt Sicherheit und Datenschutz und aktiviere dann die Option Standard-Cookie-Benachrichtigung verwenden.
   • Cookie Bot
     Wenn diese Option ausgewählt ist, wird die Cookie-Verwaltung von CookieBot implementiert. Wenn du CookieBot auswählen möchtest, musst du ihn bereits in deinem Shopware-Shop installiert haben.
   • Manager der Einwilligung
   • Wenn diese Option aktiviert ist, wird die Einwilligungsverwaltung über den Einwilligungs-Manager implementiert. Wenn du den Einwilligungs-Manager auswählen möchtest, musst du ihn bereits in deinem Shopware-Shop installiert haben.
   • Benutzerzentrierte CMP-Daten
     Wenn diese Option ausgewählt ist, wird das Einwilligungsmanagement über Usercentrics CMP implementiert. Wenn du Usercentrics CMP auswählen möchtest, musst du es bereits in deinem Shopware-Shop installiert haben.
5. Wenn du kein Cookie-Verwaltungstool verwendest (das das Laden des Klaviyo-Skripts bereits blockiert) und die Ladezeiten der Seite beschleunigen möchtest, aktiviere die Einstellung Klaviyo nach der ersten Interaktion mit der Seite initialisieren. Dadurch wird das folgende Verhalten aktiviert:
   • Nachdem der Client mit der Seite interagiert hat, werden die Klaviyo-Skripte initialisiert.
   • Bei nachfolgenden Seitenübergängen werden die Skripte sofort initialisiert.
     

6. Rufe deine öffentlichen und privaten API-Schlüssel von Klaviyo ab, um fortzufahren. Öffne dazu eine neue Registerkarte und melde dich bei dem Klaviyo-Konto an, das du mit Shopware integrieren möchtest.
   1. Klicke unten links auf deinen Kontonamen und wähle Einstellungen.
   2. Wähle API-Schlüssel aus.
   3. Klicke auf Privaten API-Schlüssel erstellen. Benenne den Schlüssel „Shopware-Integration“, wähle dann „ Full Access Key “ aus und klicke auf „ Erstellen“. Klicke auf der nächsten Seite auf Schlüssel kopieren.
   4. Füge den privaten API-Schlüssel in die entsprechende Einstellung in Shopware ein.
   5. Klicke in Klaviyo auf Fertig. Kopiere dann deinen öffentlichen API-Schlüssel von der Seite.
   6. Füge den öffentlichen API-Schlüssel in Shopware in das entsprechende Feld ein.
7. Als Nächstes wählst du eine Klaviyo-Liste aus dem Drop-down-Menü für Profile, die sich über ein Shopware-Formular anmelden, zu der du hinzugefügt werden kannst.
   

1. Wähle eine Kennung aus, die du für die Zuordnung von „Wieder auf Lager“-Variantenfeldern verwenden möchtest. Du solltest die Kennung verwenden, die mit der in deinem Katalog übereinstimmt.
2. Aktiviere alle Metriken, die du von Shopware mit Klaviyo synchronisieren möchtest.
   

3. Wenn du dich für „Wieder auf Lager“ entscheidest, kannst du die Textfarbe und den Hintergrund der Pop-up-Schaltfläche „Wieder auf Lager“, der Pop-up-Schaltfläche „Schließen“ und der Schaltfläche „Abonnieren“ anpassen. Klicke auf das Quadrat und wähle dann mit dem Selektor eine Farbe aus. Wenn du die hexadezimalen Farbcodes für die Farben deiner Marke hast, füge sie in das entsprechende Feld ein.
   

4. Unter Fragmentnamen findest du eine Referenz, wie du im HTML-Code auf verschiedene „Wieder auf Lager“-Komponenten verweisen kannst. Du kannst sie in deinem Website-Code anpassen.
   

5. Benutzerdefinierte Feldzuordnung: Hier siehst du benutzerdefinierte Felder, die du in Shopware eingerichtet hast (mit dem technischen Namen in Grau). Jedes dem Customer-Objekt zugewiesene Feld kann mit Klaviyo synchronisiert werden. Um diese benutzerdefinierten Felder mit Klaviyo-Profilen zu synchronisieren, musst du das jeweilige Feld in Aktiv umschalten. Gib dann unter Feldname den Namen ein, den du für das Feld in Klaviyo verwenden möchtest.
   

6. Wenn du fertig bist, klicke auf Speichern.
7. Um eine Synchronisierung historischer Ereignisse durchzuführen, klickst du oben auf der Seite auf Historische Ereignisse synchronisieren.
8. Um eine Synchronisierung bestehender Abonnent*innen durchzuführen, klickst du oben auf der Seite auf Abonnent*innen synchronisieren.

Deinen Katalog-Feed synchronisieren

Um deine Integration mit Klaviyo abzuschließen, musst du einen Feed deines Produktkatalogs erstellen und ihn dann mit Klaviyo synchronisieren. So generierst du den Feed:

1. Melde dich bei deinem Shopware-Shop-Admin an.
2. Klicke auf + neben Sales Channels, um einen neuen Kanal hinzuzufügen.
3. Klicke neben Produktvergleich auf Verkaufskanal hinzufügen.
4. Wähle unter Vorlage die Option Klaviyo XML aus.
5. Gib dem Kanal einen Namen, z. B. Klaviyo Export.
6. Wähle unter Steuererhebung die Option Zeilenweise (horizontale) Berechnung aus.
7. Unter Storefront Sales Channel:
   • Wähle den Storefront-Vertriebskanal aus, für den dieser Katalog bestimmt ist.
   • Wähle die Storefront-Domain aus.
   • Wähle die Währung aus.
   • Wähle die Sprache aus.
   • Wähle die Kundengruppe aus.
8. Unter Produktexport:
   • Benenne die Datei (z. B. klaviyo.xml).
   • Wähle die Codierung UTF-8 aus.
   • Wähle das Dateiformat XML aus.
9. Lasse Varianten exportieren, wenn diskrete Produkte deaktiviert sind.
10. Wähle das Intervall: 1 Tag.
11. Lass Generieren über den Planer deaktiviert.
12. Wähle deine dynamische Produktgruppe aus.
13. Aktiviere unter Status die Option Aktiv.
14. Klicke oben rechts auf Speichern.
15. Scrolle nach unten und kopiere die Export-URL, die du für die Klaviyo-Synchronisierung verwenden wirst.
16. Jetzt, da der Feed generiert ist, musst du ihn mit Klaviyo synchronisieren. Folge den Anweisungen zum Synchronisieren eines benutzerdefinierten Katalog-Feeds mit Klaviyo.

Von Shopware synchronisierte Daten

Wenn du alles über die von Shopware synchronisierten Daten und den Zugriff darauf in Klaviyo erfahren möchtest, lies unsere Shopware-Datenreferenz.

Klaviyo-Anmeldeformulare

Du kannst Klaviyo-Anmeldeformulare zu deinem Shopware-Shop hinzufügen, um Abonnent*innen zu sammeln. Beachte, dass nur Website-Besucher*innen, die Klaviyo-Cookies akzeptieren, Klaviyo-Anmeldeformulare sehen können.

So kontaktierst du den Support

Die Klaviyo Shopware 6-Integration wird von Klaviyo über einen Drittanbieter unterstützt. Wenn du Fragen zur Integration hast und Support brauchst, kannst du den integrationsspezifischen Support kontaktieren, indem du unser Formular ausfüllst.

Wenn du allgemeine Unterstützung bei Klaviyo-bezogenen Fragen brauchst, kontaktiere den Klaviyo-Support.

Ergebnis

Du hast Shopware 6 mit Klaviyo integriert, um Website-Aktivitäten, Bestellungen, Kataloge und Abonnentendaten in Klaviyo zu integrieren. Ab sofort kannst du Klaviyo für deine eigenen Marketing-Anforderungen nutzen.