Tracking linkuri Klaviyo: clicurile ca metrică personalizată

Trackingul de linkuri Klaviyo prin Elido se face pe server și merge într-o singură direcție: fiecare clic pe unul dintre linkurile tale scurte este trimis către Events API din Klaviyo ca eveniment pe o metrică personalizată numită Elido Link Click. Evenimentul poartă slugul și ID-ul linkului, țara și dispozitivul, destinația spre care a fost trimis vizitatorul și ora clicului. Metrica se creează la prima utilizare, iar o poți reprezenta grafic, filtra și folosi în rapoarte ca pe oricare alta.

Ce nu face este să pună clicul pe profilul unui abonat. Fiecare eveniment este legat de link printr-un ID anonim, deci un link pe care dau clic 4.000 de oameni apare în Klaviyo ca un singur profil anonim cu 4.000 de evenimente pe cronologie. Acest singur fapt decide pentru ce este bună integrarea. Parcurg payloadul, configurarea, ce pot face flow-urile și segmentele cu ea și cum se compară cu trackingul nativ de clicuri al Klaviyo.

Dacă linkurile tale nu sunt încă etichetate consecvent, rezolvă mai întâi asta. Articolul cornerstone despre trackingul UTM cap-coadă acoperă convenția, iar Klaviyo vede doar ce poartă linkul.

Ce trimite Elido către Klaviyo la fiecare clic

Un clic, un POST. Forwarderul apelează https://a.klaviyo.com/api/events/ cu cheia ta privată în antetul Authorization: Klaviyo-API-Key și un antet revision: 2023-02-22. Acesta este endpointul documentat în referința Create Event din Klaviyo.

Iată corpul complet, cu valori de exemplu:

{
  "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" }
        }
      }
    }
  }
}

Asta e tot. Niciun email, niciun număr de telefon, niciun câmp UTM ca proprietate separată, niciun referrer și niciun browser.

Câteva detalii contează când începi să filtrezi. destination este URL-ul pe care l-a primit efectiv acest vizitator, după orice reguli de rutare ale linkurilor smart, deci un link care trimite iPhone-urile în App Store și pe toți ceilalți în magazinul tău produce două valori de destinație. device este una dintre mobile, tablet sau desktop. Etichetele UTM există doar în șirul destination, deci filtrarea directă după utm_campaign nu este posibilă; filtrează după slug, care oricum e de obicei cheia mai curată.

Crawlerele care se anunță în user agent sunt eliminate la redirecționare și nu sunt niciodată trimise mai departe. Clicurile pe care euristicile Elido le marchează ca suspecte sunt totuși trimise, iar evenimentul nu are nicio proprietate care să spună asta.

Un profil anonim pe link și de ce

Fiecare eveniment Klaviyo trebuie să numească un profil, identificat printr-un email, un număr de telefon, un ID extern, un ID Klaviyo sau un anonymous_id. Elido trimite mereu ultimul, construit ca elido-link- plus ID-ul linkului.

Deci fiecare clic pe autumn-drop ajunge pe același profil. Primul clic îl creează, iar fiecare clic ulterior este adăugat la cronologia lui.

Asta are trei consecințe, iar a treia m-a surprins.

Prima, numărătoarea funcționează, iar persoanele rămân necunoscute. Totalul clicurilor, clicurile pe link, pe țară și pe dispozitiv funcționează. Orice "unic" numără linkuri, nu oameni.

A doua, profilul anonim nu are email sau telefon. Poate sta într-un segment, dar nu poate primi un mesaj.

A treia, clicurile din aceeași secundă se contopesc. Forwarderul nu trimite unique_id, iar referința Klaviyo spune că, fără el, deduplicarea se face după momentul evenimentului, la secundă, pentru același profil și aceeași metrică. Cum profilul este per link, două persoane care dau clic pe același link în aceeași secundă devin un singur eveniment. Pentru un link de newsletter care curge încet nu vei observa niciodată. Pentru un link dintr-un story mare de Instagram, unde clicurile sosesc câte mai multe pe secundă la vârf, numărul din Klaviyo va fi sub cel din statisticile de clicuri Elido. Partea bună: singura reîncercare a forwarderului nu poate număra dublu, pentru că un eveniment reîncercat are aceeași oră.

De ce nu un ID per vizitator? Redirecționarea nu știe cine este vizitatorul, și prefer să nu lase un cookie pe un domeniu pe care vizitatorul nu l-a ales niciodată să-l viziteze. Este același compromis pe care l-am făcut pentru trackingul linkurilor în Mixpanel, unde distinct_id este per link din același motiv.

Configurarea trackingului de linkuri Klaviyo în Elido

Configurarea înseamnă un singur câmp.

1. În Klaviyo, mergi la Settings, apoi API keys, și creează o cheie API privată. Referința Create Event listează events:write ca scope necesar. Notele de configurare din aplicația Elido menționează și profiles:write; aș începe doar cu evenimente și l-aș adăuga pe al doilea dacă Klaviyo întoarce 403.
2. În workspace-ul tău Elido, deschide Integrări, alege cardul Klaviyo și dă clic pe Conectează Klaviyo.
3. Lipește cheia în Cheie API privată și salvează. Elido o criptează în repaus și o afișează ulterior doar mascată.
4. Așteaptă cam cinci minute. Setările integrării sunt păstrate în cache pe partea de forwarding, deci primele clicuri de după salvare pot să nu fie trimise.
5. Dă clic de pe telefon pe unul dintre linkurile tale, apoi deschide Analytics > Metrics în Klaviyo și caută Elido Link Click.

Butonul Testează conexiunea trimite un eveniment de test (marcat elido_test: true) către Klaviyo și arată răspunsul Klaviyo, deci o cheie revocată sau doar pentru citire eșuează chiar acolo. Dovedește că cheia funcționează, nu că metrica ajunge pe profilul pe care îl aștepți. Dovada este apariția metricii în Klaviyo după un clic real.

Nu există un comutator per link. Fiecare clic din workspace este trimis mai departe, inclusiv pe linkurile pe care nu le-ai gândit pentru marketing. Agențiile care gestionează mulți clienți ar trebui să dea fiecărui client propriul workspace înainte să conecteze ceva.

Trackingul nativ de clicuri Klaviyo vs metrica Elido

Klaviyo urmărește deja clicurile din propriile emailuri și SMS-uri, iar pentru munca la nivel de abonat trackingul nativ câștigă. Rescrie fiecare link prin domeniul său de tracking, înregistrează Clicked Email sau Clicked SMS pe profilul destinatarului și marchează scanerele probabile cu o proprietate Bot Click pe care o poți exclude din raportare.

Metrica Elido își merită locul peste tot în rest: linkul din bio-ul de Instagram, un cod QR de pe ambalaj, un link trimis de un partener din propriul newsletter, un link din notele unui podcast. Niciunul dintre aceste clicuri nu trece prin trackerul Klaviyo. Cu forwarderul pornit, ele apar în același cont cu metricile tale de email, deci un singur dashboard Klaviyo poate pune "a dat clic pe linkul de toamnă de oriunde" lângă "a dat clic pe emailul de toamnă".

O interacțiune de urmărit. În emailurile live, Klaviyo adaugă un parametru _kx la fiecare link, ca scriptul lui onsite să poată identifica persoana care a dat clic pe site-ul tău. Dacă linkul din email este un link scurt Elido, _kx ajunge pe URL-ul scurt, iar redirecționarea Elido nu transferă parametrii de query primiți către destinație. Identificarea onsite se pierde. Regula mea: în emailurile Klaviyo, trimite direct spre propriul site și lasă Klaviyo să urmărească; folosește linkuri scurte pentru canalele pe care Klaviyo nu le poate atinge.

Cum ajungi cu clicurile pe profiluri reale de abonați

Uneori vrei totuși clicul pe o persoană. Există două moduri care funcționează azi, iar niciunul nu este forwarderul.

Cel ușor este să lași trackingul onsite al Klaviyo să facă identitatea. Trimite linkul scurt partajat către o destinație cu etichete UTM și asigură-te că JavaScript-ul Klaviyo rulează pe acea pagină. Vizitatorii deja cookie-uiți dintr-un clic anterior pe email, sau care se înscriu printr-un formular, își văd activitatea onsite atașată profilului. Clicul pe linkul scurt rămâne anonim; vizita de după el, nu. Apoi compari cele două la nivel de campanie, ceea ce este mai grosier decât pe persoană, dar este cinstit cu ce știe fiecare parte.

Cel mai greu sunt linkurile per destinatar. Pentru o listă mică și valoroasă, de exemplu o secvență B2B sau invitații VIP, creează câte un link scurt pe persoană prin API la /v1/workspaces/{workspace_id}/links și ține propriul tabel cu ID-ul linkului și emailul. Abonează-te la evenimentele linkurilor prin webhook-uri, caută emailul când sosește un clic și trimite propriul eveniment către Klaviyo cu acel email ca identificator de profil. Sunt vreo patruzeci de linii de cod și este singura cale care pune un clic Elido pe un abonat cu nume. Nu aș face-o pentru un newsletter cu 200.000 de oameni.

Dacă ce îți lipsea erau numerele de clicuri din canale mixte în Klaviyo, alege un plan și conectează un workspace, apoi trece următoarea campanie socială prin linkuri de brand.

Limitele forwarderului azi

Cinci lucruri de știut înainte ca un raport să depindă de el.

Livrarea este pe principiul best effort. Un POST eșuat este reîncercat o dată după o secundă, apoi abandonat, și nimic nu este pus în coadă pentru mai târziu.

Events API are limită de rată pe cont, la 350 de cereri pe secundă în rafale și 3.500 pe minut susținut. Bugetul este partajat cu orice altă aplicație care scrie evenimente în contul tău. Un vârf de campanie de peste aproximativ 58 de clicuri pe secundă, susținut un minut, va vedea 429, iar după singura reîncercare acele clicuri sunt pierdute din Klaviyo.

Antetul de revizie este vechi. Klaviyo dă fiecărei revizii de API doi ani înainte de retragere, iar cererile către o revizie retrasă sunt servite de următoarea cea mai veche disponibilă. Revizia 2023-02-22 a trecut de acea linie, deci azi forwarderul funcționează prin fall-forward. Funcționează. Tot aș vrea ca antetul să fie actualizat.

IP-ul vizitatorului este trimis ca proprietate a evenimentului. Așteaptă-te să fie stocat ca orice altă proprietate, deci tratează-l ca dată personală în evidențele tale de prelucrare. Ghidul rezidenței datelor în UE pentru echipele de marketing arată cum să cântărești asta.

Doar clicuri. Conversiile nu fac parte din payload, deci urmărește veniturile acolo unde se află identitatea clientului, ceea ce pentru majoritatea magazinelor înseamnă integrarea ecommerce proprie a Klaviyo.

Din același cluster pe blog

• Urmărește UTM-urile cap-coadă - convenția de etichetare de care depinde corelarea la nivel de campanie.
• Tracking de linkuri Mixpanel - același tipar de forwarder, cu aceeași identitate per link.
• Webhook-uri pentru evenimentele linkurilor - piesa de bază pentru evenimentele de clic per destinatar.
• Atribuirea clicurilor din email pentru Mailchimp, Brevo și Klaviyo - perspectiva mai largă peste platformele de email.
• Clicuri pe linkuri scurte vs sesiuni GA4 - de ce numerele de clicuri și sesiunile din analitice nu coincid niciodată.
• Monitorizarea URL-urilor în Datadog - același forwarder de clicuri, alimentând un dashboard Datadog.