Klaviyo-linktracking: klikken op korte links als aangepaste metric

Klaviyo-linktracking via Elido gebeurt serverside en loopt één kant op: elke klik op een van je korte links wordt naar de Events API van Klaviyo gepost als gebeurtenis op een aangepaste metric genaamd Elido Link Click. De gebeurtenis bevat de slug en ID van de link, het land en het apparaat, de bestemming waarheen de bezoeker is gestuurd en het kliktijdstip. De metric wordt bij eerste gebruik aangemaakt, en je kunt hem uitzetten in een grafiek, filteren en er rapporten op bouwen zoals bij elke andere.

Wat hij niet doet, is de klik op het profiel van een abonnee zetten. Elke gebeurtenis is via een anonieme ID aan de link gekoppeld, dus een link waarop 4.000 mensen klikten, verschijnt in Klaviyo als één anoniem profiel met 4.000 gebeurtenissen op de tijdlijn. Dat ene feit bepaalt waar de integratie goed voor is. Ik loop door de payload, de opzet, wat flows en segmenten ermee kunnen en hoe het zich verhoudt tot de native kliktracking van Klaviyo.

Zijn je links nog niet consistent getagd, los dat dan eerst op. De hoeksteen over UTM's van begin tot eind volgen behandelt de conventie, en Klaviyo ziet alleen wat de link meedraagt.

Wat Elido bij elke klik naar Klaviyo stuurt

Eén klik, één POST. De forwarder roept https://a.klaviyo.com/api/events/ aan met je privésleutel in de header Authorization: Klaviyo-API-Key en een header revision: 2023-02-22. Dit is het endpoint uit de referentie Create Event van Klaviyo.

Dit is de volledige body, met voorbeeldwaarden:

{
  "data": {
    "type": "event",
    "attributes": {
      "time": "2026-09-21T09:14:22Z",
      "properties": {
        "workspace_id": 12,
        "link_id": 4711,
        "slug": "autumn-drop",
        "country": "DE",
        "device": "mobile",
        "destination": "https://shop.example/autumn?utm_source=instagram",
        "ip": "203.0.113.24"
      },
      "metric": {
        "data": {
          "type": "metric",
          "attributes": { "name": "Elido Link Click" }
        }
      },
      "profile": {
        "data": {
          "type": "profile",
          "attributes": { "anonymous_id": "elido-link-4711" }
        }
      }
    }
  }
}

Dat is alles. Geen e-mailadres, geen telefoonnummer, geen UTM-velden als aparte eigenschappen, geen referrer en geen browser.

Een paar details doen ertoe zodra je gaat filteren. destination is de URL die deze bezoeker daadwerkelijk kreeg, na de routeringsregels van slimme links, dus een link die iPhones naar de App Store stuurt en iedereen anders naar je winkel, levert twee bestemmingswaarden op. device is mobile, tablet of desktop. UTM-tags bestaan alleen binnen de string destination, dus rechtstreeks filteren op utm_campaign kan niet; filter op slug, wat meestal toch de nettere sleutel is.

Crawlers die zich in hun user-agent melden, worden bij de redirect weggegooid en nooit doorgestuurd. Klikken die de eigen heuristiek van Elido als verdacht markeert, worden nog wel verstuurd, en de gebeurtenis heeft geen eigenschap die dat aangeeft.

Eén anoniem profiel per link, en waarom

Elke Klaviyo-gebeurtenis moet een profiel noemen, geïdentificeerd door een e-mailadres, een telefoonnummer, een extern ID, een Klaviyo-ID of een anonymous_id. Elido stuurt altijd de laatste, opgebouwd als elido-link- plus de link-ID.

Elke klik op autumn-drop gaat dus naar hetzelfde profiel. De eerste klik maakt het aan en elke volgende wordt aan de tijdlijn toegevoegd.

Dit heeft drie gevolgen, en het derde verraste mij.

Ten eerste werken aantallen en blijven mensen onbekend. Totaal aantal klikken, klikken per link, per land en per apparaat werken allemaal. "Uniek" telt links, niet mensen.

Ten tweede heeft het anonieme profiel geen e-mailadres of telefoonnummer. Het kan in een segment zitten, maar kan geen bericht ontvangen.

Ten derde vallen klikken in dezelfde seconde samen. De forwarder stuurt geen unique_id, en de referentie van Klaviyo zegt dat het zonder die ontdubbelt op het tijdstip van de gebeurtenis, tot op de seconde, voor hetzelfde profiel en dezelfde metric. Omdat het profiel per link is, worden twee mensen die binnen dezelfde seconde op dezelfde link klikken één gebeurtenis. Bij een nieuwsbrieflink die druppelsgewijs binnenkomt, merk je dat nooit. Bij een link in een grote Instagram-story, waar de klikken op het hoogtepunt met meerdere per seconde binnenkomen, ligt de telling in Klaviyo lager dan die in je klikanalytics van Elido. Het voordeel: de ene nieuwe poging van de forwarder kan niet dubbel tellen, omdat een opnieuw verstuurde gebeurtenis hetzelfde tijdstip heeft.

Waarom geen ID per bezoeker? De redirect weet niet wie de bezoeker is, en ik zie liever niet dat hij een cookie zet op een domein dat de bezoeker nooit bewust heeft bezocht. Het is dezelfde afweging als bij Mixpanel-linktracking, waar distinct_id om dezelfde reden per link is.

Klaviyo-linktracking instellen in Elido

De opzet is één veld.

1. Ga in Klaviyo naar Settings, dan API keys, en maak een privé-API-sleutel. De referentie Create Event noemt events:write als de benodigde scope. De installatienotities in de app van Elido noemen ook profiles:write; ik zou beginnen met alleen gebeurtenissen en de tweede toevoegen als Klaviyo 403's teruggeeft.
2. Open in je Elido-werkruimte Integraties, kies de Klaviyo-kaart en klik op Connect Klaviyo.
3. Plak de sleutel in Private API Key en sla op. Elido versleutelt hem in rust en toont hem daarna alleen nog gemaskeerd.
4. Wacht ongeveer vijf minuten. Integratie-instellingen worden aan de kant van de forwarder gecachet, dus de eerste klikken na het opslaan worden misschien niet verstuurd.
5. Klik vanaf een telefoon op een van je eigen links, open dan Analytics > Metrics in Klaviyo en zoek naar Elido Link Click.

De knop Test connection post één testgebeurtenis (gemarkeerd met elido_test: true) naar Klaviyo en toont het antwoord van Klaviyo, dus een ingetrokken of alleen-lezen sleutel faalt direct daar. Het bewijst dat de sleutel werkt, niet dat de metric op het verwachte profiel terechtkomt. Het bewijs is dat de metric na een echte klik in Klaviyo verschijnt.

Er is geen schakelaar per link. Elke klik in de werkruimte wordt doorgestuurd, ook op links die je nooit voor marketing bedoelde. Bureaus met veel klanten geven elke klant het best een eigen werkruimte voordat ze iets koppelen.

Native kliktracking van Klaviyo versus de Elido-metric

Klaviyo houdt klikken in zijn eigen e-mails en sms'jes al bij, en voor werk op abonneeniveau wint die native tracking. Hij herschrijft elke link via zijn trackingdomein, legt Clicked Email of Clicked SMS vast op het profiel van de ontvanger en markeert vermoedelijke scanners met een eigenschap Bot Click die je uit rapportage kunt sluiten.

De metric van Elido verdient zijn plek overal elders: de link in je Instagram-bio, een QR-code op een verpakking, een link die een partner vanuit zijn eigen nieuwsbrief stuurt, een link in de shownotes van een podcast. Geen van die klikken loopt via de tracker van Klaviyo. Met de forwarder aan verschijnen ze in hetzelfde account als je e-mailmetrics, zodat één Klaviyo-dashboard "klikte overal op de herfstlink" naast "klikte op de herfstmail" kan zetten.

Eén wisselwerking om op te letten. In live e-mails voegt Klaviyo aan elke link een parameter _kx toe, zodat zijn onsite-script de klikker op je website kan identificeren. Is de link in je e-mail een Elido-korte link, dan komt _kx op de korte URL terecht, en de redirect van Elido neemt binnenkomende queryparameters niet mee naar de bestemming. De onsite-identificatie gaat verloren. Mijn regel: link in Klaviyo-e-mails rechtstreeks naar je eigen site en laat Klaviyo het volgen; gebruik korte links voor de kanalen die Klaviyo niet bereikt.

Klikken op echte abonneeprofielen krijgen

Soms wil je de klik wel op een persoon hebben. Er zijn twee manieren die vandaag werken, en geen van beide is de forwarder.

De makkelijke is Klaviyo's onsite-tracking de identiteit te laten doen. Stuur de gedeelde korte link naar een bestemming met UTM-tags en zorg dat het JavaScript van Klaviyo op die pagina draait. Bezoekers die al een cookie hebben van een eerdere e-mailklik of zich via een formulier aanmelden, krijgen hun onsite-activiteit aan hun profiel gekoppeld. De klik op de korte link blijft anoniem; het bezoek erna niet. Je vergelijkt de twee dan op campagneniveau, wat grover is dan per persoon, maar eerlijk is over wat elke kant weet.

De zwaardere is links per ontvanger. Maak voor een kleine lijst met hoge waarde, zoals een B2B-sequentie of VIP-uitnodigingen, via de API op /v1/workspaces/{workspace_id}/links één korte link per persoon en houd je eigen tabel bij van link-ID naar e-mailadres. Abonneer je op linkgebeurtenissen via webhooks, zoek het e-mailadres op wanneer er een klik binnenkomt en post je eigen gebeurtenis naar Klaviyo met dat e-mailadres als profielidentificatie. Het is misschien veertig regels code, en het is de enige route die een Elido-klik op een abonnee met naam zet. Voor een nieuwsbrief van 200.000 mensen zou ik het niet doen.

Als je klikaantallen over gemengde kanalen in Klaviyo hebt gemist, kies dan een abonnement en koppel een werkruimte en laat je volgende socialcampagne via gebrandmerkte links lopen.

Beperkingen van de forwarder vandaag

Vijf dingen om te weten voordat een rapport ervan afhangt.

Aflevering is best effort. Een mislukte POST wordt na een seconde eenmaal opnieuw geprobeerd en daarna weggegooid, en niets wordt voor later in de wachtrij gezet.

De Events API heeft een rate limit per account, met 350 verzoeken per seconde in pieken en 3.500 per minuut doorlopend. Dat budget deel je met elke andere app die gebeurtenissen naar je account schrijft. Een campagnepiek boven ongeveer 58 klikken per seconde, een minuut volgehouden, krijgt 429's, en na de ene nieuwe poging zijn die klikken uit Klaviyo verdwenen.

De revisieheader is oud. Klaviyo geeft elke API-revisie twee jaar voor ze wordt stopgezet, en verzoeken aan een stopgezette revisie worden afgehandeld door de eerstvolgende oudste beschikbare. De revisie 2023-02-22 is voorbij die grens, dus vandaag werkt de forwarder via fall-forward. Het werkt wel. Ik zou de header toch graag verhoogd zien.

Het IP-adres van de bezoeker wordt als gebeurtenis-eigenschap verstuurd. Verwacht dat het wordt opgeslagen zoals elke andere eigenschap, dus behandel het als persoonsgegeven in je verwerkingsregister. De gids over dataopslag in de EU voor marketingteams legt uit hoe je dat weegt.

Alleen klikken. Conversies zitten niet in de payload, dus volg omzet waar de klantidentiteit leeft, en voor de meeste winkels is dat de eigen e-commerceintegratie van Klaviyo.

Verwant op de blog

• UTM's van begin tot eind volgen - de tagconventie waar de koppeling op campagneniveau van afhangt.
• Mixpanel-linktracking - hetzelfde forwarderpatroon, met dezelfde identiteit per link.
• Webhooks voor linkgebeurtenissen - de bouwsteen voor klikgebeurtenissen per ontvanger.
• Toewijzing van e-mailklikken voor Mailchimp, Brevo en Klaviyo - het bredere beeld over e-mailplatforms heen.
• Klikken op korte links versus GA4-sessies - waarom klikaantallen en analyticssessies nooit overeenkomen.
• Datadog-URL-monitoring - dezelfde klikforwarder, die een Datadog-dashboard voedt.