Naar hoofdinhoud

KoppelingenKlaviyo

Klaviyo koppelen aan je website.

Klaviyo is e-mail en sms voor webshops, gebouwd op gedrag: wat iemand bekeek, in zijn mandje liet liggen of kocht. Wij zetten die gebeurtenissen vanaf je eigen site door, zodat de reeksen op echte data draaien.

Vertrouwd door

200+ bedrijven en webshops

DuxDux
HappyBedHappyBed
Swim EssentialsSwim Essentials
Washin7Washin7
VouwwagenspecialistVouwwagenspecialist
Fit PrepsFit Preps
Verzijden ClinicsVerzijden Clinics
Fysio MoovFysio Moov
Rund & KipRund & Kip
MörgennMörgenn

Wat het oplevert

Wat een koppeling met Klaviyo je oplevert.

Gedrag in plaats van gokwerk. Bekeken producten, achtergelaten mandjes en aankopen komen als gebeurtenis binnen.

Twee soorten sleutels. De private sleutel blijft op de server; alleen wat in de browser hoort, gebeurt in de browser.

Rechten per sleutel. Een sleutel die alleen hoeft te lezen, krijgt ook alleen leesrechten.

Technisch

De koppeling in het kort.

Vorm van de koppeling
De API met twee routes: de serverkant met een private sleutel, en een clientkant met alleen een openbaar bedrijfs-id voor wat in de browser gebeurt
Authenticatie
Een private sleutel met rechten, in de Authorization-header. De rechten zet je bij het aanmaken en zijn daarna niet meer aan te vullen
Richting
Beide kanten op
Verversing
Per aanroep, met een korte en een lange limiet per account
Wij bouwen het op
WordPress, Next.js, Maatwerk

Waar het misgaat

  • De rechten van een sleutel zet je één keer. Klaviyo kent alleen-lezen, volledig en een eigen selectie, en je kunt er achteraf niets aan toevoegen. Vergeet je een recht, dan maak je een nieuwe sleutel. Geef daarom per koppeling een eigen sleutel met alleen wat hij gebruikt, in plaats van één sleutel met alles overal te hergebruiken.
  • Er zijn twee soorten aanroepen en dat onderscheid is de hele beveiliging. De serverkant werkt met je private sleutel en mag alles wat die sleutel mag; de clientkant werkt met een openbaar bedrijfs-id en is bedoeld voor wat in de browser gebeurt. Zet nooit een private sleutel in een pagina, ook niet tijdelijk om iets te testen: hij staat dan in de broncode en in de geschiedenis van iedereen die op die pagina is geweest.
  • Er zijn twee limieten tegelijk: een korte voor pieken en een lange voor het uithoudingsvermogen, en ze verschillen per onderdeel. Bij overschrijding volgt een 429. Dat raakt vooral een eerste import van een bestaand bestand, en dat is precies het moment waarop iemand denkt dat de koppeling stuk is.
  • Toestemming is geen technische instelling. Een profiel aanmaken is niet hetzelfde als iemand aanmelden voor commerciële e-mail. Leg vast wanneer en waarvoor iemand zich heeft aangemeld en stuur dat mee; zonder dat staat er een lijst die je niet mag gebruiken.

Bron: documentatie van Klaviyo, Boston

Wat is Klaviyo?

Klaviyo is e-mail- en sms-marketing voor webshops. Het verschil met een gewoon nieuwsbriefpakket is dat het draait op gedrag: welke producten iemand bekeek, wat er in het mandje bleef liggen, wat hij eerder kocht en hoe lang dat geleden is.

Daarop bouw je reeksen die vanzelf lopen: een herinnering aan een achtergelaten mandje, een verzoek om een review, een aanbod voor wie een tijd niet is geweest. Die reeksen zijn precies zo goed als de gegevens die binnenkomen, en dat is waar de koppeling over gaat.

Hoe de koppeling werkt

Klaviyo heeft twee ingangen. De serverkant werkt met een private sleutel en is bedoeld voor alles wat je vanaf je eigen server doet: profielen bijwerken, gebeurtenissen wegschrijven, lijsten beheren. De clientkant werkt met een openbaar bedrijfs-id en is bedoeld voor wat in de browser van de bezoeker gebeurt.

Dat onderscheid is niet cosmetisch. De private sleutel hoort nooit in een pagina te staan; wat je in de browser doet, doe je met het openbare id.

De API werkt met filters, sortering en paginering met een verwijzing naar de volgende pagina in plaats van een paginanummer. Er gelden twee limieten tegelijk, een korte en een lange, per account.

Welke gebeurtenissen je wilt doorsturen

Begin klein en bouw uit. De drie die bijna altijd het meeste opleveren zijn: een product bekeken, een product in het mandje gelegd en een bestelling geplaatst.

Daarmee kun je de reeksen bouwen die het verschil maken, en je hebt er geen tientallen gebeurtenissen voor nodig. Wat je daarna toevoegt hangt af van je winkel: een maat die weer op voorraad is, een abonnement dat afloopt, een review die is geplaatst.

Belangrijk is dat elke gebeurtenis aan hetzelfde profiel hangt. Dat lukt alleen als je consequent hetzelfde kenmerk meestuurt, meestal het e-mailadres; anders krijg je drie profielen van dezelfde persoon en drie keer dezelfde mail.

Wat er in de browser hoort en wat op de server

Dit is de vraag waar de meeste Klaviyo-koppelingen op stuklopen, en het antwoord is eenvoudig.

In de browser hoort wat alleen daar bekend is: dat iemand een pagina bekijkt, dat hij een formulier invult. Daar gebruik je het openbare id voor, en meer heb je niet nodig.

Op de server hoort alles wat waar moet zijn: een bestelling, een betaling, een annulering. Die gegevens mag je niet uit de browser laten komen, want daar kan mee geknoeid worden en een advertentieblokkeerder kan ze tegenhouden.

Wij bouwen het zo dat de belangrijke gebeurtenissen vanaf de server gaan. Dat is dezelfde redenering als bij server-side meten, en het scheelt precies de gaten die je pas ziet als de omzet in Klaviyo niet klopt met je webshop.

Bijgewerkt op

Specialist voor koppelingen

Daan van den NosterumDaanAdvertising & Data085 83 30 533daan@klubb.nl

Veelgestelde vragen

Kan ik gebeurtenissen van mijn eigen site naar Klaviyo sturen?

Ja. Bekeken producten, achtergelaten mandjes en bestellingen komen als gebeurtenis binnen bij het juiste profiel, zodat je reeksen daarop kunnen draaien.

Mag de Klaviyo-sleutel in mijn website staan?

De private sleutel niet, ook niet tijdelijk. Die blijft op de server. Voor wat in de browser gebeurt is er een openbaar bedrijfs-id, en dat is precies waar het voor bedoeld is.

Waarom sturen jullie bestellingen vanaf de server?

Omdat dat de enige plek is waar ze zeker kloppen. Vanuit de browser kan een blokkeerder ze tegenhouden en kan ermee worden geknoeid; dan klopt je omzet in Klaviyo niet met je webshop.

Krijg ik dubbele profielen?

Niet als elke gebeurtenis hetzelfde kenmerk meestuurt, meestal het e-mailadres. Zonder die afspraak ontstaan er meerdere profielen van dezelfde persoon, die dan ook meerdere keren dezelfde mail krijgt.

Werkt een Klaviyo-koppeling ook op WooCommerce of Shopify?

Ja. Er bestaan kant-en-klare koppelingen voor de bekende platformen; wij bouwen erop als je eigen site of je eigen bestelproces daar niet in past, en zetten de belangrijke gebeurtenissen vanaf de server door.

Let’s work together.

Reeksen die draaien op wat er echt gebeurt.