Per impostazione predefinita Web Analytics è anonimo: conta le visite senza sapere chi le ha fatte. Quando identifichi un visitatore, le sue visite compaiono sulla timeline del suo contatto e i segmenti possono usare il suo comportamento.
Dato che /track è un endpoint pubblico, un indirizzo da solo non prova nulla. Per questo l’identificazione è sempre firmata.
identify()
Chiama identify quando sai chi è il visitatore, con l’indirizzo e una firma calcolata sul tuo server.
NotifuseAnalytics.identify('alice@example.com', '<hmac from your server>')
Entrambi gli argomenti sono obbligatori: senza di essi la promise di identify viene rifiutata invece di fallire in silenzio, e lo stesso accade con un indirizzo oltre i 255 caratteri o una firma oltre i 64 byte. Un indirizzo firmato in modo errato invece fallisce in silenzio: il server scarta l’identità e registra la visita come anonima.
Calcolare la firma
La firma è un HMAC-SHA256, codificato in esadecimale, calcolato sulla stringa wa_identify: seguita dall’indirizzo email, con la chiave segreta del tuo workspace come chiave.
import { createHmac } from 'crypto'
function webIdentifyHmac(email, workspaceSecretKey) {
return createHmac('sha256', workspaceSecretKey)
.update('wa_identify:' + email)
.digest('hex')
}func webIdentifyHMAC(email, workspaceSecretKey string) string {
mac := hmac.New(sha256.New, []byte(workspaceSecretKey))
mac.Write([]byte("wa_identify:" + email))
return hex.EncodeToString(mac.Sum(nil))
}Firma l’indirizzo esattamente come lo passi a identify: la firma viene verificata prima che l’indirizzo sia normalizzato, quindi Alice@Example.com va firmato come Alice@Example.com.
Attenzione
Non calcolare mai la firma nel browser. La firma esiste perché chiunque può inviare dati all’endpoint di tracciamento, e una chiave segreta inclusa nella pagina la rende del tutto inutile.
Il prefisso wa_identify: distingue questa firma da quella dei tuoi link di disiscrizione, così una firma presa da un’email inoltrata non può identificare un visitatore, e una presa dalla tua pagina non può modificare le iscrizioni di qualcuno.
clearIdentity() fa sì che i battiti successivi non portino più l’identità. Non rende anonimo ciò che è già stato registrato.
Identificare dai link nelle email
Notifuse può aggiungere un’identità firmata ai link delle email tracciate, così un destinatario che ne clicca uno viene riconosciuto all’arrivo senza alcun codice sul tuo sito.
L’opzione è disattivata per impostazione predefinita. Attiva Identifica i destinatari delle email in Impostazioni → Web Analytics.
Nota
A differenza di identify(), che il tuo server chiama con il tuo segreto, questa credenziale viene generata da Notifuse per ogni destinatario di ogni invio tracciato. Per questo ha una sua impostazione e non si attiva insieme alle web analytics.
L’identità è un parametro nf_id cifrato che scade 7 giorni dopo essere stato generato. Viene aggiunto solo ai link il cui host è tra i tuoi domini consentiti, quindi i link a terzi nella stessa email non lo contengono mai. Il tracker lo legge all’arrivo e lo rimuove dall’URL.
Un invio non lo contiene mai quando la notifica ha il tracciamento disattivato esplicitamente, oppure (con l’API transazionale) quando il messaggio ha un destinatario in CC o BCC, perché altrimenti l’identità finirebbe a qualcuno che non è il contatto.
Attenzione
Disattivare il tracciamento dei clic non rimuove l’identità. Senza un reindirizzamento in cui inserirlo, il parametro viene scritto direttamente sul tuo link. Per eliminarlo devi disattivare il tracciamento per la notifica, oppure disattivare l’identificazione dai link email.
Disattivare l’impostazione impedisce solo la generazione di nuove credenziali. Un nf_id già presente nel browser di un visitatore continua a identificarlo fino alla scadenza, fino a 7 giorni dopo.
Cosa registra l’identificazione
Quando un visitatore viene identificato, quella visita e tutto ciò che vi è già stato registrato vengono attribuiti al contatto:
- Sulle righe di analytics: l’indirizzo del contatto, così Contact Email diventa una dimensione e Identified Contacts una misura.
- Sulla timeline del contatto: una voce per ogni pagina visualizzata e una che riassume la visita, più gli eventuali obiettivi come eventi personalizzati.
Se l’indirizzo non corrisponde ancora a un contatto, ne viene creato uno con la lingua e il fuso orario segnalati dalla visita, più il paese ricavato dall’IP del visitatore quando la geolocalizzazione è attiva. Un valore che Notifuse non può salvare, come una lingua non supportata o un fuso orario non riconosciuto, viene omesso. Un contatto esistente non viene mai modificato da una visita, e un contatto creato in questo modo non viene aggiunto a nessuna lista.
Nella scheda del contatto
La scheda Visite web di un contatto elenca le sue visite identificate, dalla più recente: quando, per quanto tempo, quante pagine, da dove è arrivato e con quale dispositivo. Espandi una visita per vedere il suo percorso pagina per pagina, con gli obiettivi raggiunti lungo la strada. Sopra la lista, un riepilogo mostra la prima visita identificata, gli obiettivi raggiunti e le pagine più viste, e Apri in web analytics apre la dashboard filtrata sul contatto.
La scheda compare solo ai membri che possono leggere le web analytics, e solo mentre le web analytics sono attive.
Segmenti
Il comportamento sul web è disponibile come condizioni di attività in un segmento:
| Condizione | Filtra su |
|---|---|
| Visualizza pagina web | Percorso, tempo sulla pagina, profondità di scorrimento, numero della pagina nella visita, tipo di ingresso |
| Visita il sito web | Pagina di ingresso, pagina di uscita, pagine visualizzate, durata della visita, profondità di scorrimento, obiettivi raggiunti, valore degli obiettivi, dominio del referrer, UTM source / medium / campaign, canale, gruppo di canali, dispositivo, browser, sistema operativo, paese |
Così “ha visualizzato /pricing almeno due volte negli ultimi 30 giorni” o “è arrivato da una campagna newsletter e ha raggiunto almeno un obiettivo” sono normali condizioni di segmento. Vedi Contatti per come si combinano le condizioni.
Nota
La navigazione non attiva mai un’automazione. Visualizzazioni di pagina e visite vengono registrate e si possono usare nei segmenti, ma solo gli obiettivi arrivano alle automazioni, tramite il trigger custom_event, con il nome normalizzato dell’obiettivo. Gli obiettivi hanno un tipo dichiarato, quindi sono raggiungibili anche tramite la condizione Obiettivo degli eventi personalizzati. Vedi Obiettivi.
Privacy
- Non viene impostato alcun cookie, e nessun identificatore segue un visitatore da un sito all’altro.
- Gli indirizzi IP servono a ricavare una posizione e non vengono mai salvati.
- Una visita anonima resta anonima. Nulla la collega a posteriori a un contatto identificato in una sessione successiva.
- Eliminare un contatto rimuove il suo indirizzo ovunque fosse salvato: le righe di analytics, le voci della sua timeline e gli eventi personalizzati creati dai suoi obiettivi web. Il traffico resta come anonimo, quindi i totali storici non cambiano.
Attenzione
Un visitatore il cui browser conserva ancora una credenziale viene identificato di nuovo (e ricreato come contatto) alla visita successiva, anche dopo che lo hai eliminato. Per impedirlo in modo definitivo, smetti di chiamare identify() per quell’indirizzo, e disattiva l’identificazione dai link email se la credenziale proviene da un link. Un nf_id generato prima che tu disattivassi l’impostazione continua a funzionare fino alla scadenza.
Note
- L’identificazione ha un limite di frequenza per indirizzo e per IP di origine. La creazione di un nuovo contatto a partire da un’identificazione ha inoltre un limite per workspace.
- Superare un limite fa perdere l’identità su quel battito, mai la visita.
- Ogni passaggio di proiezione scrive al massimo 100 visualizzazioni di pagina per visita, tenendo le più recenti. Una visita lunga proiettata in più passaggi può lasciare più di 100 voci di visualizzazione di pagina sulla timeline.
- Gli obiettivi più vecchi di 24 ore non vengono aggiunti a una timeline, quindi una visita offline riprodotta in seguito non attiva automazioni con un giorno di ritardo.
- Riferimento API
