Tracking dei link Klaviyo: i click sui link brevi come metrica personalizzata

Il tracking dei link Klaviyo tramite Elido è lato server e funziona in una sola direzione: ogni click su uno dei tuoi link brevi viene inviato all'Events API di Klaviyo come evento su una metrica personalizzata chiamata Elido Link Click. L'evento contiene lo slug e l'ID del link, il paese e il dispositivo, la destinazione a cui è stato inviato il visitatore e l'ora del click. La metrica viene creata al primo utilizzo e puoi visualizzarla in grafici, filtrarli e creare report come per qualsiasi altra metrica.

Quello che non fa è inserire il click nel profilo di un iscritto. Ogni evento è associato al link tramite un ID anonimo, quindi un link cliccato da 4.000 persone compare in Klaviyo come un unico profilo anonimo con 4.000 eventi nella sua timeline. Questo unico fatto determina a cosa serve davvero l'integrazione. Passerò in rassegna il payload, la configurazione, cosa possono farci flow e segmenti e il confronto con il tracking nativo dei click di Klaviyo.

Se i tuoi link non hanno ancora tag coerenti, sistemalo prima. Il cornerstone sul tracking degli UTM end to end illustra la convenzione, e Klaviyo vede solo ciò che il link contiene.

Cosa invia Elido a Klaviyo a ogni click

Un click, una POST. Il forwarder chiama https://a.klaviyo.com/api/events/ con la tua chiave privata nell'header Authorization: Klaviyo-API-Key e un header revision: 2023-02-22. Questo è l'endpoint documentato nella referenza Create Event di Klaviyo.

Ecco il body completo, con valori di esempio:

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

Questo è tutto. Nessuna email, nessun numero di telefono, nessun campo UTM come proprietà separate, nessun referrer e nessun browser.

Alcuni dettagli diventano importanti quando inizi a filtrare. destination è l'URL che questo visitatore ha effettivamente ricevuto, dopo eventuali regole di routing degli smart link, quindi un link che invia gli iPhone all'App Store e tutti gli altri al tuo shop produce due valori di destinazione. device è uno tra mobile, tablet e desktop. I tag UTM esistono solo nella stringa destination, quindi non è possibile filtrare direttamente su utm_campaign; filtra invece su slug, che di solito è comunque la chiave più pulita.

I crawler che si identificano nel proprio user agent vengono eliminati al redirect e non vengono mai inoltrati. I click che le euristiche di Elido segnalano come sospetti vengono comunque inviati e l'evento non contiene una proprietà che lo indichi.

Un profilo anonimo per link, e perché

Ogni evento Klaviyo deve indicare un profilo, identificato da un'email, un numero di telefono, un ID esterno, un ID Klaviyo o un anonymous_id. Elido invia sempre l'ultimo, costruito come elido-link- più l'ID del link.

Quindi ogni click su autumn-drop va allo stesso profilo. Il primo click lo crea e tutti i successivi vengono aggiunti alla sua timeline.

Questo comporta tre conseguenze, e la terza mi ha sorpresa.

Primo, i conteggi funzionano ma le persone restano sconosciute. Funzionano i click totali e i click per link, paese e dispositivo. Qualsiasi cosa sia "unica" conta i link, non gli esseri umani.

Secondo, il profilo anonimo non ha email né telefono. Può trovarsi in un segmento, ma non può ricevere un messaggio.

Terzo, i click nello stesso secondo vengono accorpati. Il forwarder non invia unique_id e la referenza di Klaviyo dice che, senza questo valore, esegue la deduplicazione sull'ora dell'evento fino al secondo, per lo stesso profilo e la stessa metrica. Poiché il profilo è per link, due persone che cliccano lo stesso link nello stesso secondo diventano un unico evento. Per un link in una newsletter che riceve click lentamente non te ne accorgerai mai. Per un link in una grande storia Instagram, dove nei momenti di punta arrivano diversi click al secondo, il conteggio Klaviyo sarà inferiore a quello nelle tue analisi dei click Elido. Il vantaggio: l'unico retry del forwarder non può contare due volte, perché un evento ritentato ha la stessa ora.

Perché non usare un ID per visitatore? Il redirect non sa chi sia il visitatore e preferirei che non depositasse un cookie su un dominio che il visitatore non ha scelto di visitare. È lo stesso compromesso che abbiamo adottato per il tracking dei link Mixpanel, dove distinct_id è per link per lo stesso motivo.

Configurare il tracking dei link Klaviyo in Elido

La configurazione richiede un solo campo.

1. In Klaviyo, vai su Settings, poi API keys, e crea una chiave API privata. La referenza Create Event indica events:write come ambito necessario. Le note sulla configurazione nell'app di Elido menzionano anche profiles:write; inizierei solo con events e aggiungerei il secondo se Klaviyo restituisce errori 403.
2. Nel tuo workspace Elido, apri Integrations, scegli la scheda Klaviyo e fai click su Connect Klaviyo.
3. Incolla la chiave in Private API Key e salva. Elido la cifra a riposo e in seguito la mostra sempre e solo mascherata.
4. Attendi circa cinque minuti. Le impostazioni dell'integrazione vengono messe in cache sul lato del forwarding, quindi i primi click dopo il salvataggio potrebbero non essere inviati.
5. Clicca uno dei tuoi link dal telefono, poi apri Analytics > Metrics in Klaviyo e cerca Elido Link Click.

Il pulsante Test connection invia a Klaviyo un evento di test (contrassegnato con elido_test: true) e mostra la risposta di Klaviyo, quindi una chiave revocata o di sola lettura fallisce subito. Dimostra che la chiave funziona, non che la metrica arrivi al profilo previsto. La comparsa della metrica in Klaviyo dopo un click reale è la prova.

Non esiste un interruttore per singolo link. Ogni click nel workspace viene inoltrato, inclusi i link che non avevi destinato al marketing. Le agenzie che gestiscono molti clienti dovrebbero assegnare a ciascun cliente il proprio workspace prima di collegare qualsiasi cosa.

Tracking nativo dei click Klaviyo e metrica Elido a confronto

Klaviyo traccia già i click nelle proprie email e nei propri SMS e, per le attività a livello di iscritto, il tracking nativo è superiore. Riscrive ogni link attraverso il proprio dominio di tracking, registra Clicked Email o Clicked SMS sul profilo del destinatario e contrassegna i probabili scanner con una proprietà Bot Click che puoi escludere dai report.

La metrica di Elido è utile in tutti gli altri casi: il link nella bio Instagram, un codice QR sulla confezione, un link che un partner invia dalla propria newsletter, un link nelle note di un podcast. Nessuno di questi click passa dal tracker di Klaviyo. Con il forwarder attivo, compaiono nello stesso account delle tue metriche email, quindi una dashboard Klaviyo può mettere "ha cliccato il link autunnale da qualsiasi canale" accanto a "ha cliccato l'email autunnale".

Fai attenzione a un'interazione. Nelle email reali, Klaviyo aggiunge un parametro _kx a ogni link affinché il suo script onsite possa identificare chi ha cliccato sul tuo sito. Se il link nella tua email è un link breve Elido, _kx arriva sull'URL breve e il redirect di Elido non trasferisce i parametri di query in ingresso alla destinazione. L'identificazione onsite va persa. La mia regola: nelle email Klaviyo, collega direttamente il tuo sito e lascia che sia Klaviyo a fare il tracking; usa i link brevi per i canali che Klaviyo non può raggiungere.

Portare i click sui veri profili degli iscritti

A volte vuoi associare il click a una persona. Oggi funzionano due metodi e nessuno dei due è il forwarder.

Il più semplice è lasciare che il tracking onsite di Klaviyo gestisca l'identità. Invia il link breve condiviso a una destinazione con tag UTM e assicurati che il JavaScript di Klaviyo venga eseguito su quella pagina. I visitatori che hanno già un cookie derivante da un click precedente su un'email, o che si iscrivono tramite un modulo, vedono la propria attività onsite associata al profilo. Il click sul link breve resta anonimo; la visita successiva no. Poi confronti i due dati a livello di campagna: è meno preciso che a livello di persona, ma rappresenta onestamente ciò che ciascun lato conosce.

Il metodo più impegnativo consiste nell'usare link per destinatario. Per una lista piccola e di alto valore, come una sequenza B2B o inviti VIP, crea un link breve per persona tramite l'API all'indirizzo /v1/workspaces/{workspace_id}/links e conserva una tua tabella che associ l'ID del link all'email. Iscriviti agli eventi dei link tramite webhook, cerca l'email quando arriva un click e invia il tuo evento a Klaviyo usando quell'email come identificatore del profilo. Sono forse quaranta righe di codice ed è l'unico percorso che associa un click Elido a un iscritto identificato. Io non lo farei per una newsletter da 200.000 persone.

Se ti mancavano i conteggi dei click da canali misti dentro Klaviyo, scegli un piano e collega un workspace, poi fai passare la tua prossima campagna social da link brandizzati.

Limiti attuali del forwarder

Cinque cose da sapere prima di basare un report su di esso.

La consegna è best effort. Una POST non riuscita viene ritentata una volta dopo un secondo, poi eliminata, e non viene messa in coda per un invio successivo.

L'Events API ha un limite di velocità per account: 350 richieste al secondo nei picchi e 3.500 al minuto in modo costante. Questo budget è condiviso con ogni altra app che scrive eventi nel tuo account. Un picco di campagna superiore a circa 58 click al secondo, mantenuto per un minuto, riceverà errori 429 e, dopo l'unico retry, quei click saranno persi in Klaviyo.

L'header di revisione è vecchio. Klaviyo concede a ogni revisione API due anni prima del ritiro e le richieste a una revisione ritirata vengono gestite dalla più vecchia revisione ancora disponibile. La revisione 2023-02-22 ha superato quel limite, quindi oggi il forwarder funziona tramite fall-forward. Funziona. Vorrei comunque che l'header venisse aggiornato.

L'IP del visitatore viene inviato come proprietà dell'evento. Considera che venga memorizzato come qualsiasi altra proprietà e trattalo quindi come dato personale nei tuoi registri dei trattamenti. La guida alla residenza dei dati UE per i team di marketing spiega come valutarlo.

Solo click. Le conversioni non fanno parte del payload, quindi traccia i ricavi dove si trova l'identità del cliente, che per la maggior parte degli shop è l'integrazione ecommerce nativa di Klaviyo.

Correlati sul blog

• Tracciare gli UTM end to end - la convenzione di tagging da cui dipende il collegamento a livello di campagna.
• Tracking dei link Mixpanel - lo stesso modello di forwarder, con la stessa identità per link.
• Webhook per gli eventi dei link - il componente di base per gli eventi di click per destinatario.
• Attribuzione dei click email per Mailchimp, Brevo e Klaviyo - la visione più ampia tra le piattaforme email.
• Click sui link brevi e sessioni GA4 a confronto - perché i conteggi dei click e le sessioni di analisi non coincidono mai.
• Monitoraggio degli URL con Datadog - lo stesso forwarder dei click, che alimenta una dashboard Datadog.