> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Identificare i visitatori

> Collega una visita al sito web a un contatto e usa il comportamento di navigazione nei segmenti.

![La timeline di un contatto filtrata su Web, con una sessione web e le sue visualizzazioni di pagina](https://www.notifuse.com/docs/assets/screenshots/web_analytics/contact_timeline_web.png)

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**.

```javascript
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.

```javascript Node.js
import { createHmac } from 'crypto'

function webIdentifyHmac(email, workspaceSecretKey) {
  return createHmac('sha256', workspaceSecretKey)
    .update('wa_identify:' + email)
    .digest('hex')
}
```

```go Go
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`.

> [!WARNING]
>
> 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**.

> [!NOTE]
>
> 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.

> [!WARNING]
>
> 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](https://www.notifuse.com/it/docs/features/contacts.md) per come si combinano le condizioni.

> [!NOTE]
>
> 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](https://www.notifuse.com/it/docs/web-analytics/goals.md#using-web-goals-in-segments).

## 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.

> [!WARNING]
>
> 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](https://www.notifuse.com/docs/api-reference.md)
