Integreren met Spree

Wat je leert

Leer hoe je Spree met Klaviyo kunt integreren. Nadat je deze stappen hebt voltooid, kun je e-mails personaliseren en targeten op basis van de aankopen en websiteactiviteit van elke klant. Dit is de data die we vanuit Spree synchroniseren:

• Verkoop- en bestelgegevens, inclusief welke producten zijn gekocht, productafbeeldingen, variatiedetails en eventuele toegepaste kortingen
• Klantgegevens, waaronder voor- en achternaam, locatie en hoe ze je winkel hebben gevonden
• Gegevens van afgeronde bestellingen

Voeg de Spree-integratie toe in Klaviyo

1. Selecteer in Klaviyo het tabblad Integraties.
2. Klik op Apps ontdekken, zoek naar Spree en klik op de kaart. Klik vervolgens op Installeren.
3. Op de volgende pagina moet je je winkel-URL en een Spree-API-sleutel/versleuteld wachtwoord opgeven. Je kunt deze API-sleutel genereren in je Spree-beheerder door naar Gebruikers te gaan, een account te kiezen en vervolgens API-sleutel genereren te selecteren.
4. Terug in Klaviyo plak je je Store-URL en API-sleutel/versleuteld wachtwoord in de vakken.
   

5. Als je een versiebeheer-API van Spree (v1) gebruikt, vink dan het bijbehorende vakje aan.
6. Klik op Koppelen aan Spree.
7. Als je klanten die zich aanmelden om e-mail te ontvangen van je Spree-store wilt toevoegen aan een lijst in Klaviyo, vink dan op de volgende pagina het vakje Nieuwe Spree-klanten toevoegen aan een Klaviyo-lijst aan. Nadat je dit vakje hebt aangevinkt, selecteer je een lijst waaraan nieuwe aanmeldingen worden toegevoegd.
8. Klik op Installatie afronden als je klaar bent. Je ziet dan een succesbericht dat aangeeft dat je de integratie succesvol hebt voltooid.

Installeer Klaviyo onsite-tracking

Om tracking op de site te installeren, die bestaat uit twee events - Actief op site en Product bekeken, zoek je eerst je openbare API-sleutel. Log in op je Klaviyo-account en ga naar Accountnaam > Instellingen > API-sleutel. Je openbare sleutel is zes tekens lang. Kopieer deze sleutel veilig voor gebruik in de volgende stap.

Er zijn twee soorten tracking op locatie die je kunt gebruiken:

• Actief op website
  Deze meetwaarde wordt bijgehouden wanneer een identificeerbare browser je website bezoekt
• Product bekeken
  Deze meetwaarde wordt bijgehouden wanneer een identificeerbare browser een productpagina op je website bekijkt

"Actief op site"-tracking

Deze meetwaarde wordt bijgehouden wanneer een identificeerbare browser je website bezoekt.

1. Om Actief op site -activiteit te gaan tracking, voeg je het volgende codefragment toe aan je hoofdtemplate van je winkel, zodat het op alle pagina's wordt opgenomen. Je moet dit fragment plaatsen bij de andere analytics-scripts die je gebruikt of vlak voor de afsluitende </body> -tag.
2. Zorg ervoor dat je Public API Key vervangt door de openbare API-sleutel van je Klaviyo-account:

<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. Afhankelijk van de typen templates die je voor je website gebruikt, is de syntaxis {% if user.is_logged_in %} en {{ user.email }} waarschijnlijk anders. Met de beschikbare templatetaal wil je controleren of de persoon die de huidige pagina bekijkt is ingelogd. Als dat zo is, moet je hun e-mailadres en naam weergeven, als die beschikbaar zijn. Als je geen naamgegevens hebt, verwijder je die twee regels en de afsluitende komma na de regel met het e-mailadres $email.
2. Met deze Klaviyo-trackingcode kun je een meetwaarde voor actief op sitevolgen, zodat je gegevens over sitebezoeken en bezoekersgedrag kunt bekijken en benutten. Via deze meetwaarde volgt Klaviyo onsite-activiteit voor bekende browsers.
3. Om te testen of je onsite tracking goed is ingesteld, ga je naar een pagina in je winkel en voeg je ?utm_email=email@example.com toe aan het einde van de URL, waarbij je email@example.com vervangt door je e-mailadres. Nadat je de pagina opnieuw hebt geladen, zoek je in Klaviyo naar je e-mailadres. Je zou moeten zien dat er een profiel is aangemaakt en dat het je site-activiteit heeft getrackt.

"Product bekeken"-tracking

Als je een flow voor website verlaten wilt instellen of segmenten wilt bouwen op basis van gegevens over productbrowsen, wil je JavaScript-event-tracking toevoegen voor een Viewed Product -meetwaarde.

1. Voeg in je productpagina-template het volgende snippet toe:

<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. Het bovenstaande snippet gebruikt de {{ }} -placeholdersyntaxis, die mogelijk anders is voor je Spree-store. Het belangrijkste is dat productvelden dynamisch worden gerenderd op basis van welke productpagina je bekijkt.
2. Nadat Viewed Product -tracking is geconfigureerd voor je site, zouden Viewed Product -gegevens in je Klaviyo-account moeten worden ingevuld terwijl bekende bezoekers door je productpagina's bladeren.

Hoe tracking op je site werkt

Wanneer je Klaviyo onsite tracking aan je site toevoegt, kunnen we alleen de browseactiviteit van "bekende browsers" volgen - oftewel browsers die eerder minstens één keer je site hebben bezocht en betrokken zijn geweest. Er zijn twee belangrijke manieren waarop we een websitebezoeker kunnen identificeren voor onsite tracking:

• Als iemand op een bepaald moment via een Klaviyo Email op je website heeft geklikt
• Als iemand zich op een bepaald moment heeft aangemeld/opgegeven via een Klaviyo-formulier

Klaviyo houdt geen gegevens bij van anonieme browsers.

Houd de Klaviyo-sync in de gaten

Om je integratie te controleren:

1. Klik op de dropdown Analytics in Klaviyo en selecteer Meetwaarden. Hier kun je filteren om alle Spree-meetwaarden te bekijken.
2. Zoek de Placed Order-meetwaarde van Spree en klik op het pictogram Activiteitenfeed. Als je integratie is begonnen met het synchroniseren van gegevens, zie je dat Placed Order -events hier worden ingevuld.
3. We synchroniseren automatisch alle historische bestelgegevens. Om dit te verifiëren, kun je het aantal events op een bepaalde dag in Klaviyo vergelijken met wat er in je Spree-interface staat en bevestigen dat ze overeenkomen. Als je bijvoorbeeld de meetwaarde Placed Order verkent, kun je met de muis over het datapunt van gisteren bewegen of de gegevenstabel onder de grafiek bekijken om te zien hoeveel bestellingen er gisteren zijn gerapporteerd.
4. Vergelijk dat getal met wat er vanaf gisteren in Spree is opgeslagen en je zou moeten zien dat ze precies overeenkomen. Als dat niet zo is, is het probleem waarschijnlijk dat de tijdzone van je Klaviyo-account niet overeenkomt met de tijdzone die je in Spree hebt ingesteld.
5. Zo controleer je je tijdzone-instelling in Klaviyo:
   • Klik linksonder op je accountnaam.
   • Selecteer en klik vervolgens op Instellingen > Organisatie.
   • Scrol naar beneden naar Tijdzone.
6. Zodra deze historische synchronisatie is voltooid, zie je een lichtgroene rand rond je Spree-integratie op het tabblad integraties.

Gegevens gesynchroniseerd vanuit Spree

Hieronder vind je een lijst met meetwaarden die Spree synchroniseert naar Klaviyo. Je kunt alle Spree-meetwaarden die naar je account worden gesynchroniseerd bekijken via Analyses > Meetwaarden.

Bestelling geplaatst

Deze meetwaarde registreert een gebeurtenis elke keer dat iemand een bestelling plaatst en deze succesvol betaalt. Dit komt overeen met bestellingen in Spree die voltooid zijn, wat betekent dat een klant het volledige afrekenproces heeft doorlopen. Met deze meetwaarde kun je eenvoudig dynamische lijsten maken van mensen op basis van het aantal bestellingen dat ze hebben geplaatst of hun levenslange waarde. Je kunt ook e-mails maken om eerdere klanten opnieuw te betrekken of bedankmails sturen naar klanten voor hun eerste aankoop. Je kunt Placed Order -gebeurtenissen filteren en targeten op basis van de volgende criteria:

• IsDiscounted
  Of er een korting op een bestelling is toegepast, bijv. true of false.
• ItemNames
  De namen van de producten die in dit event zijn gekocht.

Product Besteld

Deze meetwaarde is vergelijkbaar met de meetwaarde Bestelling geplaatst, maar er wordt een gebeurtenis vastgelegd voor elk item dat iemand bestelt. Als iemand bijvoorbeeld een T-shirt en een korte broek heeft gekocht, wordt dit in Klaviyo weergegeven als één gebeurtenis Bestelling geplaatst en twee gebeurtenissen Product besteld, één voor het T-shirt en één voor de korte broek. Deze meetwaarde is handig om lijsten te bouwen die zich richten op klanten die specifieke items of items in specifieke categorieën hebben gekocht (of niet hebben gekocht). Je kunt de meetwaarde Product besteld ook gebruiken als trigger voor flow om e-mails te versturen over gerelateerde producten die natuurlijk bij elkaar passen, maar die sommige klanten nog niet hebben gekocht.

• Categorieën
  De categorieën waartoe het bestelde product behoort, bijv. Shirts, Heren of Uitverkoop.
• Naam
  De naam van het gekochte product, bijv. Rood T-shirt voor heren.
• ProductId
  De id van je product zoals deze in je winkel is ingesteld, bijv. 2022, 2023, 2024.
• Aantal
  Het aantal van een besteld product.
• SKU
  De SKU van het product zoals ingesteld in je winkel.
• Variatieoptie: kleur
  De kleur van het product, indien beschikbaar, bijvoorbeeld rood of blauw.
• Optie voor variatie: Size
  De grootte van het product, indien beschikbaar, bijvoorbeeld Medium of Large.

Bestelling Afgerond

Deze meetwaarde registreert een gebeurtenis wanneer de bestelling van een klant wordt verzonden. De gebeurtenis in Klaviyo bevat het trackingnummer voor alle zendingen, zodat je deze meetwaarde kunt gebruiken als trigger voor verzendbevestigingsmails. Een andere veelgebruikte e-mail op basis van de meetwaarde Fulfilled Order is de productreview-e-mail, waarin je klanten vraagt om een review achter te laten voor items die ze onlangs hebben gekocht. Door de meetwaarde Fulfilled Order te gebruiken, kun je deze e-mails timen op basis van wanneer iemand zijn/haar bestelling ontvangt, zodat je je geen zorgen hoeft te maken dat je ze een e-mail stuurt voordat ze hun pakket hebben ontvangen. Je kunt gebeurtenissen Fulfilled Order filteren en targeten op basis van de volgende criteria:

• IsDiscounted
  Of er een korting op een bestelling is toegepast, bijv. true of false.
• ItemNames
  De namen van de items die in deze gebeurtenis zijn gekocht.

Is begonnen met afrekenen

Deze meetwaarde registreert elke keer een gebeurtenis wanneer iemand een checkout start en zijn e-mailadres heeft ingevuld. Het belangrijkste gebruik van deze meetwaarde is het versturen van e-mails voor winkelwagen verlaten. Met Klaviyo kun je eenvoudig een e-mailflow instellen om een winkelwagenherinnering te versturen als iemand is begonnen met afrekenen maar na een paar uur nog geen bestelling heeft geplaatst. De gebeurtenis Started Checkout bevat alle informatie over iemands winkelwagen, zodat je de producten in hun winkelwagen kunt tonen, evenals afbeeldingen van die producten. Voor meer gevorderde gebruikers kun je twee flows voor winkelwagen verlaten instellen: één voor nieuwe klanten met een kortingscode, en één voor terugkerende kopers zonder kortingscode. Je kunt gebeurtenissen Started Checkout filteren en targeten op basis van de volgende criteria:

• IsDiscounted
  Of er een korting op een bestelling is toegepast, bijv. true of false.
• ItemNames
  De namen van de items die in deze gebeurtenis zijn gekocht.

klantgegevens

Naast de meetwaarden die Klaviyo vanuit Spree synchroniseert, zijn er ook klanteigenschappen die aan elk Klaviyo-profiel worden toegevoegd. Je kunt deze eigenschappen gebruiken in segmenten en flows. Hier zijn de eigenschappen die automatisch worden gesynchroniseerd vanuit Spree:

• E-mail
• Voornaam
• Achternaam
• Plaats
• Staat/regio
• Postcode
• Land
• Telefoonnummer

Resultaat

Je hebt nu je Klaviyo-account geïntegreerd met Spree, tracking op locatie geïnstalleerd en je gesynchroniseerde gegevens bekeken.