So integrierst du Spree

Übersicht

In diesem Artikel erfährst du, wie du Spree mit Klaviyo integrierst. Nach Abschluss dieser Schritte kannst du E-Mails auf Grundlage der Einkäufe und Website-Aktivitäten der einzelnen Kund*innen personalisieren und gezielt versenden. Hier sind die Daten, die wir aus Spree synchronisieren:

• Verkaufs- und Bestelldaten, einschließlich der gekauften Produkte, Produktbilder, Variantendetails und aller angewendeten Rabatte
• Kund*inneninformationen einschließlich Vor- und Nachname, Standort und wie sie deinen Shop gefunden haben
• Daten zu erfüllten Bestellungen

Die Spree-Integration in Klaviyo einbinden

1. Wähle in Klaviyo die Registerkarte Integrationen.
2. Klicke auf Apps entdecken, suche nach Spree und klicke auf die Karte. Klicke dann auf Installieren.
3. Auf der nächsten Seite musst du deine Store-URL und einen Spree-API-Schlüssel/ein verschlüsseltes Passwort angeben. Du kannst diesen API-Schlüssel in deiner Spree-Administration generieren, indem du zu Users navigierst, ein Konto auswählst und dann API-Schlüssel generieren auswählst.
4. Füge zurück in Klaviyo deine Store-URL und deinen API-Schlüssel/dein verschlüsseltes Passwort in die Felder ein.
   

5. Wenn du eine versionierte Spree API (v1) verwendest, aktiviere das entsprechende Kontrollkästchen.
6. Klicke auf Mit Spree verbinden.
7. Wenn du Kund*innen, die sich in deinem Spree-Shop für den Empfang von E-Mails anmelden, zu einer Liste in Klaviyo hinzufügen möchtest, aktiviere auf der nächsten Seite das Kästchen Neue Spree-Kund*innen zu einer Klaviyo-Liste hinzufügen . Wähle nach dem Aktivieren dieses Kästchens eine Liste aus, zu der neue Opt-ins hinzugefügt werden.
8. Wenn du so weit bist, klicke auf Einrichtung abschließen. Dann solltest du eine Erfolgsmeldung sehen, die anzeigt, dass du erfolgreich integriert hast.

Klaviyo-Onsite-Tracking installieren

Um das Onsite-Tracking zu installieren, das aus zwei Ereignissen besteht – Active on Site und Viewed Product –, suche zuerst deinen öffentlichen API-Schlüssel. Melde dich bei deinem Klaviyo-Konto an und gehe zu Kontoname > Einstellungen > API-Schlüssel. Dein öffentlicher Schlüssel ist sechs Zeichen lang. Kopiere diesen Schlüssel sicher, um ihn im nächsten Schritt zu verwenden.

Es gibt zwei Arten von Onsite-Tracking, die du nutzen kannst:

• Auf Seite aktiv
  Diese Metrik wird immer dann getrackt, wenn jemand deine Website über einen identifizierbaren Browser besucht.
• Viewed Product
  Diese Metrik wird immer dann getrackt, wenn ein identifizierbarer Browser eine Produktseite auf deiner Website aufruft

„Auf Website aktiv“-Tracking

Diese Metrik wird immer dann getrackt, wenn ein identifizierbarer Browser deine Website besucht.

1. Um das Tracking von Auf der Website aktiv -Aktivitäten zu starten, füge den folgenden Code-Snippet zu deiner Haupt-Vorlage des Shops hinzu, damit er auf allen Seiten enthalten ist. Du solltest dieses Snippet entweder zusammen mit anderen Analytics-Skripten platzieren, die du nutzt, oder direkt vor dem schließenden </body> -Tag.
2. Stelle sicher, dass du Public API Key durch den öffentlichen API-Schlüssel deines Klaviyo-Kontos ersetzt:

<script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=PUBLIC_API_KEY"></script>
<script type="text/javascript"> 
//Initialize the Klaviyo object on page load
!function(){if(!window.klaviyo){window._klOnsite=window._klOnsite||[];try{window.klaviyo=new Proxy({},{get:function(n,i){return"push"===i?function(){var n;(n=window._klOnsite).push.apply(n,arguments)}:function(){for(var n=arguments.length,o=new Array(n),w=0;w<n;w++)o[w]=arguments[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){window._klOnsite.push([i].concat(o,[function(i){t&&t(i),n(i)}]))}));return e}}})}catch(n){window.klaviyo=window.klaviyo||[],window.klaviyo.push=function(){var n;(n=window._klOnsite).push.apply(n,arguments)}}}}(); </script>

1. Je nachdem, welche Arten von Vorlagen du für deine Website verwendest, sind die Syntax von {% if user.is_logged_in %} und {{ user.email }} wahrscheinlich unterschiedlich. Mit der verfügbaren Vorlagen-Sprache möchtest du prüfen, ob die Person, die die aktuelle Seite ansieht, angemeldet ist. Wenn ja, gib ihre E-Mail-Adresse und ihren Namen aus, sofern verfügbar. Wenn du keine Namensinformationen hast, entferne diese beiden Zeilen und das nachgestellte Komma nach der Zeile mit der E-Mail-Adresse $email.
2. Mit diesem Klaviyo-Tracking-Code kannst du eine aktiv-Metrik erfassen, damit du Daten zu Website-Besuchen und zum Verhalten von Besucher*innen sehen und nutzen kannst. Über diese Metrik erfasst Klaviyo Onsite-Aktivitäten für bekannte Browser.
3. Um zu testen, ob dein Onsite-Tracking korrekt eingerichtet ist, gehe zu einer Seite in deinem Shop und füge ?utm_email=email@example.com ans Ende der URL hinzu. Ersetze dabei email@example.com durch deine E-Mail-Adresse. Lade die Seite neu und suche dann in Klaviyo nach deiner E-Mail-Adresse. Du solltest sehen, dass ein Profil erstellt wurde und deine Website-Aktivitäten getrackt hat.

„Produkt angesehen“-Tracking

Wenn du einen Browse Abandonment-Flow einrichten oder Segmente auf der Grundlage von Produkt-Surfdaten erstellen möchtest, solltest du das JavaScript-Ereignis-Tracking für die Metrik Produkt aufgerufen hinzufügen.

1. Füge in deiner Vorlage für die Produktseite das folgende Snippet hinzu:

<script type="text/javascript">
 var klaviyo = window.klaviyo || [];
 klaviyo.track("Viewed Product", {
    Title: '{{ product.name }}',
    ItemId: {{ product.id }},
    Categories: {{ category in product.categories|json }}, // The list of categories is an array of strings.
    ImageUrl: '{{ product.image_url }}',
    Url: '{{ product.permalink }}',
    Metadata: {
    Brand: '{{ product.brand }}',
    Price: {{ product.price }},
    OnSale: {{ product.on_sale }},
    RegularPrice: {{ product.regular_price }},
    SalePrice: {{ product.sale_price }}
 }
 });
</script>

1. Das obige Snippet verwendet die {{ }} -Platzhalter-Syntax, die sich von der deines Spree-Stores unterscheiden kann. Wichtig ist, dass Produktfelder dynamisch gerendert werden, je nachdem, welche Produktseite du dir gerade ansiehst.
2. Nachdem das Viewed Product -Tracking für deine Website konfiguriert wurde, sollten Viewed Product -Daten in deinem Klaviyo-Konto angezeigt werden, sobald bekannte Besucher*innen deine Produktseiten durchsuchen.

So funktioniert Onsite-Tracking

Wenn du Klaviyo Onsite-Tracking zu deiner Website hinzufügst, können wir nur die Surfaktivitäten von „bekannten Browsern“ tracken – d. h. von Browsern, die deine Website schon mindestens einmal besucht haben und dabei mit Engagement interagiert haben. Es gibt 2 wichtige Möglichkeiten, wie wir eine*n Website-Besucher*in für das Onsite-Tracking identifizieren können:

• Jemand hat irgendwann über eine Klaviyo Email auf deine Website geklickt
• Jemand hat irgendwann ein Klaviyo-Formular abonniert oder eine Einwilligung darüber erteilt

Klaviyo verfolgt keine anonymen Browser.

Klaviyo-Synchronisierung überwachen

So überprüfst du deine Integrationen:

1. Klicke in Klaviyo auf das Dropdown-Menü Analytics und wähle Metrik aus. Hier kannst du filtern, um alle Spree-Metriken anzuzeigen.
2. Suche in Spree die Metrik Placed Orderund klicke auf das Symbol „Aktivitäts-Feed“. Wenn deine Integrationen begonnen haben, Daten zu synchronisieren, siehst du, dass Placed Order -Ereignisse hier angezeigt werden.
3. Wir synchronisieren automatisch alle historischen Bestelldaten. Um das zu überprüfen, kannst du die Anzahl der Events an einem bestimmten Tag in Klaviyo mit der in deiner Spree-Oberfläche vergleichen und bestätigen, dass sie übereinstimmen. Wenn du zum Beispiel die Metrik Placed Order untersuchst, kannst du mit der Maus über den Datenpunkt von gestern fahren oder dir die Datentabelle unter dem Diagramm ansehen, um zu sehen, wie viele Bestellungen gestern gemeldet wurden.
4. Vergleiche diese Zahl mit dem, was seit gestern in Spree gespeichert ist, und du solltest sehen, dass sie exakt übereinstimmen. Wenn nicht, liegt das Problem höchstwahrscheinlich daran, dass die Zeitzone deines Klaviyo-Kontos nicht mit deiner in Spree festgelegten Zeitzone übereinstimmt.
5. So überprüfst du deine Zeitzoneneinstellung in Klaviyo:
   • Klicke unten links auf deinen Kontonamen.
   • Wähle dann Einstellungen > Organisation aus.
   • Scrolle nach unten zu Zeitzone.
6. Nachdem diese historische Synchronisierung abgeschlossen ist, siehst du einen hellgrünen Rahmen um deine Spree-Integrationen auf dem Tab Integrationen.

Daten, die von Spree synchronisiert wurden

Unten findest du eine Liste der Metriken, die Spree mit Klaviyo synchronisiert. Alle Spree-Metriken, die mit deinem Konto synchronisiert werden, kannst du unter Analytics > Metriken einsehen.

Bestellung aufgegeben

Diese Metrik erfasst jedes Mal ein Ereignis, wenn jemand eine Bestellung aufgibt und erfolgreich dafür bezahlt. Das entspricht Bestellungen in Spree, die abgeschlossen sind, d. h., Kund*innen haben den gesamten Checkout-Prozess abgeschlossen. Mit dieser Metrik kannst du ganz einfach dynamische Listen von Personen erstellen, basierend auf der Anzahl der Bestellungen, die sie aufgegeben haben, oder ihrem Lifetime Value. Du kannst auch E-Mails erstellen, um frühere Kund*innen erneut zu aktivieren oder Kund*innen-Dankes-E-Mails an Erstkäufer*innen zu senden. Du kannst Ereignisse für platzierte Bestellungen anhand der folgenden Kriterien filtern und anvisieren:

• IsDiscounted
  Ob bei einer Bestellung ein Rabatt angewendet wurde, z. B. true oder false.
• Artikelnamen
  Die Namen der in diesem Ereignis gekauften Produkte.

Produkt bestellt

Diese Metrik ähnelt der Metrik Placed Order. Allerdings wird für jeden Artikel, den jemand bestellt, ein Ereignis erfasst. Wenn jemand zum Beispiel ein T-Shirt und eine Shorts gekauft hat, wird das in Klaviyo als ein Placed Order -Ereignis und zwei Ordered Product -Ereignisse angezeigt: eines für das T-Shirt und eines für die Shorts. Diese Metrik ist hilfreich, um Listen zu erstellen, die Kund*innen ansprechen, die bestimmte Artikel oder Artikel aus bestimmten Kategorien gekauft haben (oder nicht gekauft haben). Du kannst die Metrik Ordered Product auch als Auslöser für Flows verwenden, um E-Mails über verwandte Produkte zu senden, die natürlich gut zusammenpassen, die einige Kund*innen aber noch nicht gekauft haben.

• Categories
  Die Kategorien, zu denen das bestellte Produkt gehört, z. B. Shirts, Mens oder Sale.
• Name
  Der Name des gekauften Produkts, z. B. Rotes T-Shirt für Herren.
• ProductId
  Die ID deines Produkts, wie sie in deinem Shop festgelegt ist, z. B. 2022, 2023, 2024.
• Quantity
  Die Menge eines bestellten Produkts.
• SKU
  Die SKU des Produkts, wie sie in deinem Shop festgelegt ist.
• Variantenoption: Farbe
  Die Farbe des Produkts, falls verfügbar, z. B. Rot oder Blau.
• Variantenoption: Größe
  Die Größe des Produkts, falls verfügbar, z. B. Medium oder Large.

Bestellung erfüllt

Diese Metrik erfasst ein Ereignis, wenn eine Bestellung von Kund*innen versendet wird. Das Ereignis in Klaviyo enthält die Tracking-Nummer für alle Sendungen, sodass du diese Metrik als Trigger für Versandbestätigungs-E-Mails verwenden kannst. Eine weitere gängige E-Mail basierend auf der Metrik Fulfilled Order ist die Produktbewertungs-E-Mail, in der du Kund*innen bittest, eine Bewertung für Artikel abzugeben, die sie kürzlich gekauft haben. Wenn du die Metrik Fulfilled Order verwendest, kannst du diese E-Mails zeitlich danach planen, wann jemand seine Bestellung erhält, sodass du dir keine Sorgen machen musst, ihnen eine E-Mail zu senden, bevor sie ihr Paket erhalten haben. Du kannst Fulfilled Order -Ereignisse anhand der folgenden Kriterien filtern und für das Targeting nutzen:

• IsDiscounted
  Ob bei einer Bestellung ein Rabatt angewendet wurde, z. B. true oder false.
• ItemNames
  Die Namen der in diesem Ereignis gekauften Artikel.

Bezahlvorgang gestartet

Diese Metrik erfasst jedes Mal ein Ereignis, wenn jemand einen Checkout startet und die E-Mail-Adresse eingegeben hat. Der primäre Anwendungsfall für diese Metrik ist das Senden von E-Mails zu Warenkorbabbruch. Mit Klaviyo kannst du ganz einfach einen E-Mail-Flow einrichten, um eine Warenkorb-Erinnerung zu senden, wenn jemand den Checkout gestartet hat, aber nach ein paar Stunden noch keine Bestellung aufgegeben hat. Das Ereignis Started Checkout enthält alle Informationen über den Warenkorb einer Person, sodass du die Produkte in ihrem Warenkorb sowie Bilder dieser Produkte anzeigen kannst. Für fortgeschrittene Nutzer*innen kannst du zwei Flows für Warenkorbabbruch einrichten – einen für Erstkund*innen, der einen Rabattcode enthält, und einen für Wiederholungskäufer*innen, der keinen Rabattcode enthält. Du kannst Started Checkout -Ereignisse anhand der folgenden Kriterien filtern und für das Targeting nutzen:

• IsDiscounted
  Ob bei einer Bestellung ein Rabatt angewendet wurde, z. B. true oder false.
• ItemNames
  Die Namen der in diesem Ereignis gekauften Artikel.

Kundendaten

Zusätzlich zu den Metriken, die Klaviyo aus Spree synchronisiert, werden auch Kund*inneneigenschaften zu jedem Klaviyo-Profil hinzugefügt. Du kannst diese Eigenschaften in Segmenten und Flows verwenden. Hier sind die Eigenschaften, die automatisch von Spree synchronisiert werden:

• E-Mail
• Vorname
• Nachname
• City
• Bundesland/Region
• Postleitzahl
• Country
• Phone Number

Ergebnis

Du hast jetzt dein Klaviyo-Konto mit Spree integriert, Onsite-Tracking installiert und deine synchronisierten Daten überprüft.

Weitere Ressourcen