Klaviyo koppelen aan je webshop

Met de add-on Klaviyo stuurt je webshop bestellingen, klantprofielen en nieuwsbriefaanmeldingen automatisch door naar Klaviyo, het platform voor e-mail- en SMS-marketing. Dit artikel laat zien hoe je die koppeling legt. Reken op ongeveer een kwartier.


Voordat je begint

  • Je hebt een eigen Klaviyo-account. Dat sluit je rechtstreeks bij Klaviyo af; het zit niet bij de add-on in.
  • De add-on Klaviyo is geactiveerd in je backoffice onder "Add-ons".
  • Je mag in Klaviyo API-sleutels aanmaken.


Ben je nieuw bij Klaviyo? Doorloop dan eerst hun eigen startgids: Getting started en de setup wizard. Vooral het instellen van je afzenderdomein en je huisstijl doe je maar één keer en maakt alles daarna makkelijker. De interface van Klaviyo is Engelstalig.


Let op: Klaviyo vraagt in die wizard om een webshopplatform te koppelen, zoals Shopify of WooCommerce. Shoptrader staat daar niet tussen — de koppeling loopt via deze add-on. Sla die stap dus over.


In Klaviyo: sleutels en lijst ophalen

Stap 1 – Maak een private API-sleutel aan

Met deze sleutel stuurt je webshop bestellingen en profielen naar Klaviyo. Behandel hem als een wachtwoord en deel hem niet.

  • Ga in Klaviyo naar "Settings > General > API keys".
  • Klik bij Private API Keys op "Create Private API Key".
  • Geef de sleutel een herkenbare naam, bijvoorbeeld Shoptrader webshop.
  • Kies bij Select Access Level voor "Custom Key" en zet in de scope-tabel rechts alleen deze vier om: Accounts op Read Access, en Events, Profiles en Subscriptions op Full Access. De rest laat je op No Access staan.
  • Klik op "Create" en kopieer de sleutel. Die begint met pk_.


Let op: een Full Access Key werkt ook, maar geeft je webshop meer rechten in je Klaviyo-account dan nodig is. Kies dus voor een Custom Key met alleen de vier scopes hierboven.


Meer uitleg bij Klaviyo: API-sleutels beheren en een private API-sleutel aanmaken.


Stap 2 – Noteer je publieke Site-ID

Op diezelfde pagina "Settings > General > API keys" staat bovenaan het blok Public API Key / site ID. In de kolom Public API Key staat een korte code van een paar tekens, bijvoorbeeld AbC123. Kopieer die.

Deze code is openbaar en mag in de broncode van je website staan; hij geeft geen toegang tot je Klaviyo-gegevens.


Stap 3 – Kies de lijst voor nieuwsbriefaanmeldingen

Klanten die bij het afrekenen het nieuwsbriefvinkje aanzetten, komen automatisch op een lijst in Klaviyo. Die lijst wijs je zelf aan.

  • Ga naar "Audience > Lists & segments". Gebruik een bestaande lijst of maak er met "Create" een nieuwe aan.
  • Open de lijst en klik op het tabblad "Settings".
  • Onder Details vind je bij List name and ID het List ID, met een kopieerknop ernaast. Kopieer die code.


Let op: kijk ook even bij "Settings > Consent". Nieuwe lijsten staan standaard op Double opt-in: wie zich aanmeldt krijgt eerst een bevestigingsmail van Klaviyo en staat pas ná die bevestiging op de lijst. Dat is netjes en door Klaviyo aanbevolen, maar verklaart wel waarom een klant niet meteen in je lijst verschijnt. Wil je dat wel, kies dan Single opt-in.


In je backoffice: de koppeling instellen

Stap 4 – Vul de sleutels in en test de verbinding

  • Ga naar "Add-ons", open Klaviyo en activeer de add-on.
  • Open de instellingen van de add-on en vul onder API-koppeling de Private API-sleutel uit stap 1 en de Publieke Site-ID (company ID) uit stap 2 in.
  • Klik op "Opslaan".
  • Klik daarna pas op "Test verbinding".


Klopt alles, dan verschijnt de melding "Verbinding gelukt" met de naam van je Klaviyo-account erachter. Zie je daar een andere naam dan verwacht, dan hoort de sleutel bij een ander Klaviyo-account.


Let op: de knop test de opgeslagen sleutel, niet wat je zojuist hebt ingetypt. Sla dus eerst op en test daarna, anders krijg je de melding dat je eerst een private API-sleutel moet invullen en opslaan.


Stap 5 – Stel privacy en consent in

Vul onder Privacy & consent het Klaviyo list-ID uit stap 3 in en sla op.

Laat de optie "Alleen profielen met nieuwsbrief-consent syncen" aan staan, tenzij je bewust anders wilt. Met deze optie aan gaan alleen klanten die het nieuwsbriefvinkje hebben aangezet naar Klaviyo. Dat past bij wat de privacywetgeving van je vraagt, én het scheelt geld: Klaviyo rekent af per profiel in je account. Alle klanten doorsturen maakt je Klaviyo-factuur onnodig hoog en levert je adressen op die je toch niet mag mailen.


Wat de koppeling automatisch doorstuurt

  • Een klant plaatst een bestelling: het event Placed Order, met de gekochte artikelen en het orderbedrag.
  • Een klant begint met afrekenen: het event Started Checkout — de basis voor je verlaten-winkelwagenflow. Dit event gaat één keer per winkelwagen per bezoek weg, zodat je klant niet bij elke stap opnieuw een flow binnenloopt.
  • Er wordt een nieuw account aangemaakt: een profiel met naam, e-mailadres en land.
  • Een klant zet het nieuwsbriefvinkje aan: een abonnement op de lijst die je bij stap 3 koos.
  • Een bezoeker bekijkt je webshop: onsite tracking en je Klaviyo-aanmeldformulieren, via het script dat de add-on in je webshop plaatst.


Controleren of het werkt

  • Klik in de backoffice op "Test verbinding"; je ziet de naam van je Klaviyo-account.
  • Plaats een testbestelling in je webshop en zet daarbij het nieuwsbriefvinkje aan.
  • Kijk in Klaviyo bij "Analytics > Metrics" of Placed Order en Started Checkout binnenkomen.
  • Zoek in "Audience > Profiles" op het e-mailadres van je testbestelling.
  • Controleer of dat profiel op je lijst staat. Staat de lijst op double opt-in, dan moet de bevestigingsmail eerst bevestigd zijn.


Aan de slag in Klaviyo

De koppeling levert de gegevens; het versturen doe je in Klaviyo zelf. De drie dingen waar de meeste webshops mee beginnen:

  • Aanmeldformulier — onder "Website > Sign-up forms". Een pop-up of balk die aanmeldingen verzamelt. Dit werkt zodra het script van de add-on in je webshop staat.
  • Flows — onder "Flows". Automatische mails op basis van gedrag: een welkomstmail voor nieuwe aanmeldingen, een verlaten-winkelwagenmail op Started Checkout, of een bedank- of reviewmail op Placed Order.
  • Campagnes — onder "Campaigns". De losse nieuwsbrief die je zelf verstuurt.


De volledige documentatie van Klaviyo vind je op help.klaviyo.com.


Hulp nodig bij het inrichten van Klaviyo?

Shoptrader zorgt voor de koppeling: dat de gegevens uit je webshop goed in Klaviyo terechtkomen. Hoe je Klaviyo daarna inricht — welke flows je bouwt, hoe je je klanten segmenteert, hoe je mails eruitzien en wat je erin schrijft — valt buiten onze support. Daar kunnen wij je inhoudelijk niet bij helpen.

Zoek je daar professionele begeleiding bij, dan raden we SDIM aan. Dat is onze eigen SEO-partner en zij hebben kennis van Klaviyo.


Let op

  • De verbinding mislukt. Controleer of je de private sleutel hebt geplakt en niet de Site-ID, of de sleutel in Klaviyo nog actief is, en of de scopes uit stap 1 goed staan.
  • De aanmeldformulieren van Klaviyo verschijnen niet in je webshop. Controleer of bij Publieke Site-ID echt de korte code uit stap 2 staat — niet je private sleutel en niet een langere code met streepjes. Het script wordt meegebouwd in de JavaScript van je webshop; dat kan even duren voordat het live staat. Blijft het weg, neem dan contact op met de supportafdeling.
  • Er komen geen profielen binnen in Klaviyo. Waarschijnlijk staat "Alleen profielen met nieuwsbrief-consent syncen" aan. Alleen klanten die het nieuwsbriefvinkje aanzetten worden dan doorgestuurd. Dat is bewust zo.
  • Je klant krijgt twee mails over zijn verlaten winkelwagen. Dan staat de add-on Abandoned Cart Saver nog aan naast je Klaviyo-flow. Zet er één van de twee uit.
  • Kosten. De add-on betaal je aan Shoptrader. Je Klaviyo-abonnement staat daar los van en loopt op met het aantal profielen in je account.