Come configurare l'ID di prima parte
Cosa imparerai
Scopri come configurare First-Party ID per migliorare la tua capacità di identificare i visitatori di ritorno. L’ID proprietario utilizza un cookie lato server per estendere l’identificazione, aiutandoti a riconoscere più acquirenti di ritorno, attribuire più eventi sul sito e alimentare un’automazione marketing più mirata
Se scegli di attivare First Party ID, ti consigliamo vivamente di ripubblicare gli avvisi sui cookie per i clienti e di rivedere i termini di servizio e/o l’informativa sulla privacy, per assicurarti che i clienti siano informati sui processi di riidentificazione. Il cookie di Klaviyo scadrà, ma First-Party ID offre la riidentificazione tramite una funzionalità di cookie lato server che ti consente di aggiornare il cookie di Klaviyo direttamente dal tuo dominio.
Per saperne di più su informativa sulla privacy, Informativa sui cookie e consenso nell'articolo Comprendere i cookie in Klaviyo .
Come funziona l’ID di prima parte?
Il tracciamento standard di Klaviyo imposta un cookie chiamato __kla_id nel browser di chi visita il sito usando JavaScript (leggi di più qui). Su browser come Safari e Firefox, le protezioni della privacy limitano la durata di quel cookie. Una volta scaduto, Klaviyo non può più riconoscere la persona che visita il sito come profilo noto finché non si verifica un altro evento di identificazione.
First-Party ID risolve questo problema eseguendo un worker Cloudflare su un sottodominio del tuo dominio. Questo worker imposta un cookie a lunga durata, impostato dal server, chiamato __kle_id. Quando __kla_id esistente scade, Klaviyo utilizza __kle_id per aggiornarlo, identificando di nuovo il visitatore e attribuendo la sessione attiva sul sito al profilo noto corretto. Se il worker non è disponibile, Klaviyo torna in modo fluido al comportamento standard di __kla_id (Javascript di Klaviyo), quindi non si perdono dati.
- Nota: First-Party ID non identifica visitatori completamente nuovi. Un acquirente deve già avere un profilo Klaviyo, creato tramite un’iscrizione, un clic tracciato su un’e-mail o un altro evento di identificazione, prima che First-Party ID possa ri-identificarlo in una visita di ritorno.
Durata del cookie
Quando un visitatore viene identificato, il cookie di Klaviyo (__kla_id) viene impostato per durare fino a 2 anni, ma la sua durata varia in base alle politiche sulla durata dei cookie di ciascun browser, che dipendono da come il cookie viene impostato nel browser. __kla_id in genere viene impostato tramite il Javascript di Klaviyo, che inserisce il cookie lato client. Se ID esteso o ID di prime parti sono abilitati, il cookie di Klaviyo viene impostato rispettivamente lato client e lato server. Scopri di più su come abilitare queste funzionalità di Klaviyo per aiutare a identificare di nuovo gli utenti. Scopri come configurare l'ID esteso.
La durata standard del cookie __kla_id — per quanto tempo rimane attivo prima che First-Party ID debba aggiornarlo — varia in base al browser. Puoi trovare informazioni più dettagliate in questo CookieStatus.
- La durata dei cookie varia in base al browser e dipende dal fatto che il cookie sia impostato lato client tramite JavaScript o lato server. La tabella seguente mostra entrambe le opzioni.
Browser | Standard __kla_id (inserita lato client – JS + ID esteso) | Con ID di prima parte (impostato dal server) |
|---|---|---|
Safari | 24 ore (l’URL contiene parametri di query o frammenti + se Klaviyo è un tracker noto); altrimenti 7 giorni | Fino a 7 giorni |
Brave | Se è attiva la modalità "Shields Down" di Brave, 7 giorni; altrimenti, il cookie di Klaviyo viene bloccato da Brave | Se è attiva la modalità "Shields Down" di Brave, 7 giorni; altrimenti, il cookie di Klaviyo viene bloccato da Brave |
Firefox | Limite di durata: 45 giorni; tuttavia, Firefox elimina i cookie tramite controlli giornalieri di classificazione dei tracker | Limite di durata: 45 giorni; tuttavia, Firefox elimina i cookie tramite controlli giornalieri di classificazione dei tracker |
Chrome | 400 giorni | Fino a 400 giorni |
Edge | Fino a due anni (impostazione di Klaviyo, non una limitazione di Edge) | Fino a due anni (impostazione di Klaviyo, non una limitazione di Edge) |
La limitazione di 24 ore di Safari si applica nello specifico quando il cookie viene inserito lato client, l’URL contiene parametri di query o frammenti e Safari considera Klaviyo un tracker noto. In condizioni normali, il limite di Safari per i cookie proprietari impostati tramite JS è di 7 giorni.
Abilitare l'ID di prima parte
First-Party ID richiede un sottodominio dedicato del tuo dominio che punti all’account Cloudflare di Klaviyo. Klaviyo fornisce i record DNS necessari.
- Fai clic sul menu dell'account in basso a sinistra del tuo account Klaviyo.
- Seleziona "Impostazioni" dal menu.

- Vai alla scheda Dati
- Nella sezione First-Party ID, fai clic su “Configura”.
- Conferma che il dominio precompilato sia corretto. In caso contrario, inserisci il dominio radice (ad es. example.com) del tuo negozio e fai clic su avanti.

- Per configurare il sottodominio, puoi scegliere di usare Entri per fornire alcuni dettagli e farlo configurare automaticamente per te. In alternativa, puoi scegliere di configurare manualmente il sottodominio tramite le impostazioni del tuo provider DNS.

- Se selezioni Entri
- Fai clic su Connetti con Entri e Continua

- Entri rileverà automaticamente il provider DNS del tuo dominio e chiederà alcuni dettagli, inclusi i dettagli di accesso. Segui le istruzioni sullo schermo e Entri aggiungerà automaticamente il sottodominio ai tuoi record DNS.

- Selezionando manual
- Copia e incolla il record CNAME visualizzato sullo schermo nel tuo provider DNS.

- Fai clic su Verifica

- La configurazione è ora completata e il sistema Klaviyo impiegherà fino a 48 ore per verificare che il sottodominio stia iniziando a ricevere correttamente il traffico. Riceverai un’e-mail quando il sottodominio avrà terminato la verifica e First-party ID sarà in esecuzione.
Ogni dominio può essere collegato a un solo account Klaviyo alla volta: non può essere riutilizzato per altri account del portfolio, anche se condividono lo stesso URL. Klaviyo invierà un’e-mail quando lo stato del tuo sottodominio cambia (ad es. da In attesa di DNS ad Attivo, o se viene rilevato un errore). Una volta attivo, il JavaScript di Klaviyo inizierà automaticamente a chiamare il worker sul tuo sottodominio.
Stati dello stato del sottodominio
Stato nell'app | Stato dell’e-mail | Cosa significa |
|---|---|---|
Verifica in corso | N/D | Klaviyo ha creato la configurazione del sottodominio e sta aspettando che i tuoi record DNS vengano aggiunti e rilevati. |
Attivo | Una volta attivo, riceverai un’e-mail che ti informa che First-Party ID è configurato. | La configurazione è completata. L’ID di prima parte è attivo e Klaviyo.js chiama il tuo worker a ogni caricamento della pagina. |
Operazione non riuscita | Se qualcosa non va a buon fine, riceverai un'e-mail che ti avviserà. | Questo può verificarsi per alcuni motivi, tra cui l'impossibilità di connettersi al tuo sottodominio. L'e-mail conterrà istruzioni su come risolvere il problema. |
Inattivo | Verrà inviata un’e-mail per avvisarti di controllare il DNS. | Questo può verificarsi se in precedenza eri attivo, ma non riceviamo più traffico dal tuo dominio. Verifica che sia configurato correttamente seguendo i passaggi sopra per controllare il tuo provider DNS, provare a connetterti al sottodominio oppure provare a disattivare e riattivare First Party ID. |
Lo stato del sottodominio risulta non riuscito
Uno stato Errore significa che Cloudflare ha rilevato un problema con la configurazione del tuo sottodominio. Cause comuni:
- Il record CNAME è mancante o punta alla destinazione sbagliata.
- Il record DNS è stato aggiunto, ma non si è propagato del tutto (in rari casi può richiedere fino a 48 ore).
- La destinazione CNAME fornita da Klaviyo è stata inserita in modo errato.
Per risolvere: a seconda del problema, riceverai un'e-mail con istruzioni relative a quel problema. In genere dovrai verificare che i record DNS corrispondano esattamente a quanto mostrato nel flusso di configurazione, quindi fai clic su Riconfigura nelle impostazioni di First-Party ID. Se il problema persiste, contatta l'assistenza Klaviyo.
Suggerimento: se la configurazione rimane bloccata su DNS in sospeso per più di 60 minuti, verifica che il record CNAME si sia propagato utilizzando uno strumento come dnschecker.org. I tempi di propagazione DNS variano in base al provider.
Disattivazione dell'ID di prima parte
Per disattivare l'ID di prima parte:
- Fai clic sul menu dell'account in basso a sinistra del tuo account Klaviyo.
- Seleziona "Impostazioni" dal menu.
- Vai alla scheda Dati.
- Nella sezione First-Party ID, fai clic sul pulsante “Disattiva”.

La disattivazione di First-Party ID interrompe immediatamente l’aggiornamento di __kla_id da parte del worker. L’account torna al tracciamento standard dei cookie JavaScript di Klaviyo. La configurazione del sottodominio viene mantenuta se lo riattivi in un secondo momento.
Misurare l'impatto dell'ID di prima parte
Per vedere l'impatto di First-Party ID sulla capacità del brand di identificare chi visita il sito, puoi sfruttare l'evento Active on Site.
- Vai a Analytics —> Metrica —> Attivo sul sito.
- Aggiungi il filtro By —> ssc_refresh.
Questo mostra il numero di eventi Active on Site aggiuntivi acquisiti grazie a First Party ID. Gli eventi First Party ID hanno un valore di 1,0 (ovvero true), mentre gli eventi acquisiti con il tracciamento cookie standard di Klaviyo o con Extended ID hanno un valore di 0,0 (ovvero false).

L’ID First-Party è attivo, ma non vedo la proprietà ssc_refresh in Attivo sul sito
Il flag ssc_refresh viene impostato solo sugli eventi acquisiti dopo una reidratazione del worker andata a buon fine. Se nessun visitatore è tornato sul sito dopo la scadenza di __kla_id, non si sono ancora verificati eventi ssc_refresh.
Come funziona l’attribuzione First-Party ID
Klaviyo tiene traccia degli eventi onsite "attribuiti", ovvero sessioni in cui First-Party ID ha identificato di nuovo correttamente un acquirente di ritorno dopo la scadenza di __kla_id. Un evento attribuito significa:
- Il visitatore aveva già un profilo Klaviyo (creato tramite registrazione, clic su e-mail, invio del modulo, ecc.).
- Il loro cookie __kla_id è scaduto tra una visita e l’altra.
- Sono tornati sul tuo sito e il worker ha restituito l’identità archiviata da __kle_id.
- Klaviyo ha ripristinato __kla_id e ha applicato il tag alla sessione con ssc_refresh = 1,0.
- Il flag ssc_refresh viene impostato esattamente nel momento in cui il worker reidrata correttamente __kla_id. È in quel momento che viene registrata l’attribuzione.
- Tutti gli eventi onsite successivi in quella sessione (visualizzazioni di pagina, aggiunte al carrello, ecc.) vengono attribuiti al profilo noto.
Una persona che visita il sito e che è stata identificata ieri, non tramite l'ID di prima parte, e torna oggi (mentre il suo __kla_id è ancora valido) non mostrerà un evento di attribuzione dell'ID di prima parte: il worker non era necessario per la nuova identificazione durante quella visita.
Domande frequenti sulla configurazione di First-Party ID
Risposte a ciò che i clienti chiedono più spesso mentre avvii First-Party ID:
- First Party ID usa il fingerprinting e può identificare di nuovo un utente su più dispositivi?
- First-Party ID non utilizza fingerprinting, identificatori probabilistici, indirizzi IP, dati del dispositivo, ID clic o stringhe user agent.
- La ri-identificazione su più dispositivi o browser non è supportata.
- First party ID si integra con le CAPI?
- First-Party ID non si integra con le API di conversione (CAPI).
- Puoi usare più di un dominio su un account Klaviyo con First Party ID?
- Ogni dominio può essere assegnato a First-Party ID in un solo account Klaviyo. Se lo stesso URL viene condiviso tra più account portfolio (ad esempio, una vetrina US e una CA sullo stesso dominio), puoi attivare First-Party ID solo su uno di essi.
- Quanto tempo richiede la configurazione DNS?
- Di solito bastano solo pochi minuti dopo l’aggiunta del record CNAME, ma possono volerci fino a 48 ore a seconda del provider DNS. Se rimani in Pending DNS per più di 60 minuti, conferma la propagazione con uno strumento come dnschecker.org.
- Posso usare lo stesso dominio su più di un account Klaviyo?
- No. Un dominio può essere assegnato a First-Party ID solo su un singolo account Klaviyo e non può essere riutilizzato su altri account del portfolio, anche se due account condividono lo stesso URL (ad esempio, uno store US e uno CA sullo stesso dominio).
- Devo aggiornare l'informativa sulla privacy prima di abilitare First-Party ID?
- Se scegli di attivare First Party ID, è vivamente consigliato inviare di nuovo le informative sui cookie ai clienti e rivedere i termini di servizio e/o l’informativa sulla privacy per assicurarti che i clienti siano informati sui processi di ri-identificazione. Il cookie di Klaviyo scadrà, ma First-Party ID offre la riidentificazione tramite una funzionalità di cookie lato server che ti consente di aggiornare il cookie di Klaviyo direttamente dal tuo dominio.
- Leggi di più su informativa sulla privacy,informativa sui cookie e consenso nell’articolo Comprendere i cookie in Klaviyo .
- Ho ancora bisogno di Extended ID se configuro First-Party ID?
- I due lavorano insieme, invece di sostituirsi a vicenda. ID di prima parte ha la priorità quando entrambi sono attivati e ID esteso continua a intercettare le persone che visitano il sito che l'ID di prima parte non ha ancora raggiunto.
- Questo interromperà il tracciamento se qualcosa va storto durante la configurazione?
- No. Se il worker non è raggiungibile, Klaviyo torna automaticamente al comportamento standard di __kla_id. Non si perde alcun dato.
- Quanto tempo dopo l’attivazione vedrò gli eventi attribuiti a First-Party ID?
- Dipende dal mix di browser del traffico. First-Party ID può aggiornare __kla_id solo dopo la scadenza di un cookie esistente e quando la persona che visita il sito ritorna, quindi ricontrolla tra 3 settimane per un segnale iniziale e poi di nuovo tra circa 2 mesi per un impatto più consolidato.
- Ho appena abilitato l'ID di prima parte. Perché non vedo ancora nessun evento attribuito?
- È previsto. First-Party ID può aggiornare __kla_id solo una volta scaduto l’__kla_id esistente di un visitatore e quando torna sul sito. La tempistica dipende dal browser. Ricontrolla tra 3 settimane per un segnale iniziale, in particolare dal traffico Safari. L’attribuzione si sviluppa gradualmente man mano che i cookie esistenti scadono e gli acquirenti tornano.
- Ho abilitato Extended ID e ho attivato First-Party ID. Perché gli eventi attribuiti a First-Party ID sono inferiori rispetto agli eventi attribuiti a Extended ID?
- È previsto, soprattutto nelle prime settimane. L'ID esteso potrebbe aver aggiornato di recente __kla_id per molti acquirenti, il che significa che quei cookie hanno ancora del tempo rimanente sul loro TTL prima che l'ID di prima parte possa subentrare.
- La pipeline per ottenere un'attribuzione First-Party ID richiede tre elementi in sequenza: evento di identificazione → scadenza di __kla_id → visita di ritorno. Stiamo ancora aspettando che queste scadenze vengano elaborate.
- Nel tempo, l’attribuzione dovrebbe cambiare: gli eventi attribuiti a Extended ID tenderanno a diminuire man mano che First-Party ID cresce. Il segnale chiave da monitorare: gli eventi attribuiti a First-Party ID dovrebbero crescere più di quanto diminuiscono gli eventi attribuiti a Extended ID, a conferma di una nuova identificazione netta e non di un semplice spostamento.
Risorse aggiuntive
- Come impostare il tracciamento dei cookie per l'ID esteso
Scopri come configurare l'ID esteso per acquisire e monitorare in modo conforme le interazioni degli iscritti con il tuo brand più a lungo. L'ID esteso è una funzionalità del grafico delle identità di prima parte che ti consente di monitorare e conservare i cookie fino a 1 anno. In questo modo, puoi identificare queste interazioni e questi comportamenti più a lungo, per eseguire il targeting, creare segmenti e automatizzare i messaggi di marketing.
- Come funzionano i cookie in Klaviyo
Scopri di più su come Klaviyo utilizza i cookie come parte del nostro tracciamento web per raccogliere informazioni e contribuire a migliorare il tasso di conversione e le prestazioni delle e-mail. Questo articolo spiega i cookie specifici che utilizziamo e il loro scopo, così che tu possa capire come vengono tracciati i clienti. Queste informazioni ti aiutano a capire come Klaviyo raccoglie i dati e in che modo questo può influire sulla privacy dei clienti e sulle leggi in materia di conformità.