Hoe integreren met Spree

Wat je leert

Leer hoe je Spree kunt integreren met Klaviyo. Na het voltooien van deze stappen kun je e-mail personaliseren en targeten op basis van de aankopen en websiteactiviteit van elke klant. Hier zijn de gegevens die we synchroniseren van Spree:

• Verkoop- en ordergegevens, inclusief welke producten zijn gekocht, productafbeeldingen, variatiedetails en toegepaste kortingen
• klantgegevens zoals voor- en achternaam, locatie en hoe ze je zaak hebben gevonden
• Vervulde ordergegevens

Voeg de Spree integraties toe in Klaviyo

1. Selecteer in Klaviyo het tabblad Integraties.
2. Klik op 'Apps verkennen', zoek naarSpree en klik op de kaart. Klik vervolgens op Installeren.
3. Op de volgende pagina moet je je zaak URL en een Spree API-sleutel / Versleuteld wachtwoord opgeven. Je kunt deze API-sleutel genereren in je Spree admin door te navigeren naar Gebruikers, een account te kiezen en vervolgens API-sleutel genereren te selecteren.
4. terug in Klaviyo, plak je zaak URL en API-sleutel/versleuteld wachtwoord in de vakjes.
   
5. Als je een versiegebonden Spree API (v1) gebruikt, vink dan het bijbehorende vakje aan.
6. Klik op Verbinden met Spree. 
7. Als je klanten die ervoor kiezen om e-mail te ontvangen van je Spree zaak wilt toevoegen aan een lijst in Klaviyo, vink dan het vakje Nieuwe Spree klant toevoegen aan een Klaviyo lijst op de volgende pagina aan. Nadat je dit vakje hebt aangevinkt, selecteer je een lijst waaraan nieuwe opt-ins worden toegevoegd.
8. Als je klaar bent, klik je op Installatie voltooien. Je zou dan een succesbericht moeten zien dat aangeeft dat je succesvol hebt geïntegreerd.

Klaviyo onsite tracking installeren

Om onsite tracking te installeren, die bestaat uit twee gebeurtenissen - actief op site en Bekeken product, zoek je eerst je openbare API-sleutel. inloggen op je Klaviyo account en ga naar accountnaam > Instellingen > API-sleutel. Je publieke sleutel is zes tekens lang. Kopieer deze sleutel veilig voor gebruik in de volgende stap. 

Er zijn twee soorten onsite tracking die je kunt gebruiken:

• actief op Site
  Deze meetwaarde wordt bijgehouden wanneer een identificeerbare browser uw website bezoekt
• Bekeken product
  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 te beginnen met tracking actief op Site activiteit, voeg je het volgende stukje code toe aan je hoofdzaak template zodat het op alle pagina's staat. Je moet dit fragment plaatsen bij andere analysescripts die je gebruikt of vlak voor de afsluitende </body </body>tag > .
2. Zorg ervoor dat je Publieke API -sleutel vervangt door je Klaviyo account's Publieke API-sleutel:

   <script type="text/javascript" async="" src="https://static.Klaviyo.com/onsite/js/Klaviyo.js?company_id=PUBLIC_API_KEY"></script>
   < script type="text/javascript"> 
    //Initialiseer het Klaviyo object bij het laden van de pagina
   !functie(){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]=argumenten[w];var t="functie"==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>

3. Afhankelijk van het type sjabloon dat je voor je website gebruikt, zijn de {% if user.is_logged_in %} en {{ user.email }} syntaxis waarschijnlijk anders. Met de beschikbare taal template wil je controleren of de persoon die de huidige pagina bekijkt ingelogd is. Zo ja, dan moet je hun e-mail en naam uitvoeren, indien beschikbaar. Als je geen naamgegevens hebt, verwijder dan deze twee regels en de laatste komma na de regel e-mail $e-mail.
4. Met deze Klaviyo tracking code kun je een activiteit op Sitemeetwaardevolgen, zodat je gegevens over sitebezoeken en bezoekersgedrag kunt zien en gebruiken. Via deze meetwaarde zal Klaviyo de onsite activiteit bijhouden voor bekende browsers.
5. Om te testen of je onsite tracking goed is ingesteld, ga je naar een pagina in je zaak en voeg je ?utm_email=e-mail@example.com toe aan het einde van de URL, waarbij je e-mail@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 dat de activiteit op je site bijhoudt. 

"Bekeken product" tracking

Als je een flow voor websiteverlaters wilt instellen of segmenten wilt maken op basis van productgegevens, dan moet je JavaScript event tracking toevoegen voor een Viewed Product meetwaarde.

1. Voeg op je productpagina template het volgende fragment toe:

   <script type="text/javascript"> 
    var Klaviyo = window.Klaviyo || [];
    Klaviyo.track("Bekeken Product", {
       Title: '{{ product.name }}',
    ItemId: {{ product.id }},
    Categorieën: {{ category in product.categories|json }}, // De lijst van categorieën is een array van strings.
       ImageUrl: '{{ product.image_url }}',
    Url: '{{ product.permalink }}',
    Metadata: {
    Merk: '{{ product.brand }}',
    Prijs: {{ product.price }},
    OnSale: {{ product.on_sale }},
    NormalePrijs: {{ product.regular_price }},
    SalePrijs: {{ product.sale_price }}
    }
    });
   </script>

2. Het bovenstaande fragment gebruikt de {{ }} placeholder syntaxis die anders kan zijn voor jouw Spree zaak. Het belangrijkste is dat productvelden dynamisch worden weergegeven op basis van welke productpagina je bekijkt.
3. Nadat Viewed Product tracking is geconfigureerd voor je site, zouden de gegevens van Viewed Product moeten beginnen te verschijnen in je Klaviyo account wanneer bekende bezoekers door je productpagina's bladeren.

Hoe onsite tracking werkt

Als je Klaviyo onsite tracking aan je site toevoegt, kunnen we alleen de browse-activiteit van "bekende browsers" volgen - dat wil zeggen browsers die ten minste één keer eerder zijn bezocht en betrokken. Er zijn twee belangrijke manieren waarop we een websitebezoeker kunnen identificeren voor onsite tracking:

• Als iemand op een bepaald moment via een Klaviyo E-mail naar je website heeft geklikt
• Als iemand zich op een bepaald moment heeft aangemeld/ingeschreven via een Klaviyo formulier

Klaviyo zal anonieme browsers niet volgen.

in de gaten houden de Klaviyo sync 

Om je integraties te controleren:

1. Klik op de analyses dropdown in Klaviyo en selecteer meetwaarde. Hier kun je filteren om alle Spree meetwaarde te bekijken.
2. Zoek Spree's Geplaatste Ordermeetwaardeen klik op het pictogram Activity Feed. Als je integratie is begonnen met het synchroniseren van gegevens, zul je hier geplaatste bestellingen zien verschijnen.
3. We synchroniseren automatisch alle historische bestelgegevens. Om dit te controleren kun je het aantal gebeurtenissen 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 geplaatste orders bekijkt, kun je met je muis over het gegevenspunt van gisteren gaan of in de tabel met gegevens onder de grafiek kijken om te zien hoeveel orders er gisteren zijn gemeld.
4. Vergelijk dat getal met de zaak op Spree van gisteren en je zou moeten zien dat ze precies overeenkomen. Als dat niet het geval is, is het probleem waarschijnlijk dat de tijdzone van je Klaviyo account niet overeenkomt met de ingestelde tijdzone van Spree.
5. Controleer uw tijdzone-instellingen in Klaviyo:
   • Klik linksonder op je accountnaam.
   • Selecteer en klik op Instellingen > Organization.
   • Scroll naar beneden naar Tijdzone.
6. Zodra deze historische synchronisatie is voltooid, zie je een lichtgroene rand rond je Spree integraties in het tabblad integraties.

gegevens gesynchroniseerd van Spree

Hieronder vind je een lijst met meetwaarden die Spree synchroniseert met Klaviyo. Je kunt alle Spree meetwaarde bekijken die in je account zijn gesynchroniseerd onder analyses > meetwaarde. 

Bestelling geplaatst 

Deze meetwaarde registreert een gebeurtenis telkens wanneer iemand een bestelling plaatst en deze succesvol betaalt. Het komt overeen met bestellingen in Spree die compleet zijn, wat betekent dat een klant het hele afrekenproces heeft voltooid. Met deze meetwaarde kun je eenvoudig dynamische lijsten van mensen maken op basis van het aantal bestellingen dat ze hebben geplaatst of hun levenslange waarde. Je kunt ook een e-mail maken om klanten te bedanken voor hun eerste aankoop. Je kunt Geplaatste bestellingen filteren en targeten op basis van de volgende criteria:

• IsDiscounted
  Of op een bestelling korting is toegepast, bijvoorbeeld waar of onwaar.
• ItemNames
  De namen van de producten die in dit evenement zijn gekocht.

Product besteld

Deze meetwaarde is vergelijkbaar met de Meetwaarde Geplaatste Bestelling, maar er wordt een gebeurtenis geregistreerd voor elk artikel dat iemand bestelt. Als iemand bijvoorbeeld een t-shirt en een korte broek heeft gekocht, zou dit in Klaviyo verschijnen als één geplaatste bestelling en twee bestelde productgebeurtenissen, één voor het t-shirt en één voor de korte broek. Deze meetwaarde is handig voor het maken van lijsten die gericht zijn op klanten die specifieke items of items in specifieke categorieën hebben gekocht (of niet hebben gekocht). Je kunt de Besteld product meetwaarde ook gebruiken als trigger voor flow om e-mail te sturen over gerelateerde producten die natuurlijk bij elkaar passen, maar sommige klanten nog niet hebben gekocht.

• Categorieën
  De categorieën waartoe het bestelde product behoort, bijv. Overhemden, Heren of Uitverkoop.
• Naam
  De naam van het gekochte product, bijv. Rood T-shirt voor mannen.
• ProductId
  De id van je product zoals die is ingesteld in je zaak, bijvoorbeeld 2022, 2023, 2024.
• Hoeveelheid
  De hoeveelheid van een besteld product.
• SKU
  De SKU van het product zoals die is ingesteld in je zaak.
• variatie Optie: Kleur
  De kleur van het product, indien beschikbaar, bijvoorbeeld Rood of Blauw.
• variatie Optie: Maat
  De maat van het product, indien beschikbaar, bijvoorbeeld Medium of Large.

Afgeronde bestelling

Deze meetwaarde registreert een gebeurtenis wanneer een bestelling van een klant wordt verzonden. De gebeurtenis in Klaviyo bevat het tracking nummer voor eventuele zendingen, zodat je deze meetwaarde kunt gebruiken als trigger voor de verzendbevestigingsmail. Een andere veelgebruikte e-mail op basis van de Fulfilled Order meetwaarde is de product review e-mail, waarin je klanten vraagt om een review achter te laten voor items die ze onlangs hebben gekocht. Met de Fulfilled Order meetwaarde kun je deze e-mails timen op basis van wanneer iemand zijn 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 van Vervulde orders filteren en targeten op basis van de volgende criteria:

• IsDiscounted
  Of op een bestelling korting is toegepast, bijvoorbeeld waar of onwaar.
• ItemNames
  De namen van de items die in dit evenement zijn gekocht.

Afrekenen gestart

Deze meetwaarde registreert een gebeurtenis telkens wanneer iemand een afrekening start en zijn e-mailadres heeft ingevoerd. Het primaire gebruik voor deze meetwaarde is het versturen van winkelwagen verlaten e-mail. Met Klaviyo kun je eenvoudig een e-mail flow instellen om een winkelwagenherinnering te sturen als iemand is gaan afrekenen maar na een paar uur nog geen bestelling heeft geplaatst. De gebeurtenis Afrekenen gestart bevat alle informatie over iemands winkelwagentje, zodat je de producten in zijn winkelwagentje kunt laten zien, evenals afbeeldingen van die producten. Voor meer geavanceerde gebruikers kun je twee winkelwagen verlaten stromen instellen -- een voor klanten die voor het eerst een winkelwagen verlaten met een kortingscode, en een voor terugkerende kopers zonder kortingscode. Je kunt Gestart afrekenen gebeurtenissen filteren en targeten op basis van de volgende criteria:

• IsDiscounted
  Of op een bestelling korting is toegepast, bijvoorbeeld waar of onwaar.
• ItemNames
  De namen van de items die in dit evenement zijn gekocht.

klantgegevens

Naast de meetwaarde Klaviyo syncs van Spree zijn er ook klant eigenschappen die worden toegevoegd aan elk Klaviyo profiel. Je kunt deze eigenschappen gebruiken in segmenten en stromen. Dit zijn de eigenschappen die automatisch worden gesynchroniseerd vanuit Spree:

• E-mail
• Voornaam
• Achternaam
• City
• Staat/regio
• Zip Code
• Country
• Telefoonnummer

Resultaat

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

Extra hulpbronnen

• Hoe vaak integraties referentie synchroniseren
• Heb je meer hulp nodig bij het integreren met Klaviyo? afrekenen Klaviyo's Agentschap partner