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

# Tracciamento email

> Registra quando i contatti aprono le tue email e cliccano i loro link, e lascia che ogni contatto accetti o rifiuti questo tracciamento.

## Panoramica

Notifuse può registrare due cose sulle email che invia:

- **Aperture**: all'email viene aggiunta un'immagine invisibile (un pixel di tracciamento), che registra quando l'email viene aperta.
- **Click**: i link passano da un reindirizzamento che registra ogni clic prima di portare il contatto alla pagina.

Ciascuno si attiva separatamente nelle impostazioni del workspace, e ogni contatto può accettare o rifiutare ciascuno dei due. I link mantengono i loro [parametri UTM](https://www.notifuse.com/it/docs/features/broadcast-campaigns.md#utm-tracking) qualunque sia la scelta sul tracciamento.

## Impostazioni del workspace

In **Impostazioni → Generale**, pannello **Tracciamento email**:

- **Aperture** e **Click** attivano o disattivano ciascun tipo di tracciamento per tutto il workspace. Quando uno è disattivato, nessuna email lo contiene, qualunque cosa abbiano scelto i contatti.
- **Contatti senza consenso registrato** decide cosa succede per un contatto che non ha mai fatto una scelta: **Traccia** (il valore predefinito) o **Non tracciare**.

La scelta del contatto prevale sempre su questa impostazione. Alcune autorità, come il Garante italiano e la CNIL francese, ritengono che il tracciamento di aperture e clic richieda il consenso. Se questo vale per te, scegli **Non tracciare**: verranno tracciati solo i contatti che hanno accettato.

## La scelta del contatto

Ogni contatto ha quattro campi:

| Campo                         | Descrizione                                                                                                          |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `tracking_opens_consent`      | `granted`, `denied`, oppure `null` se sconosciuto                                                                    |
| `tracking_clicks_consent`     | `granted`, `denied`, oppure `null` se sconosciuto                                                                    |
| `tracking_consent_updated_at` | Quando una scelta è cambiata l'ultima volta. Lo imposta Notifuse quando un valore cambia, a meno che non lo invii tu |
| `tracking_consent_source`     | Da dove viene il cambiamento: `api`, `console`, `import`, `notification_center`, `email_link` o `subscribe_form`     |

Un'email a un contatto è tracciata per le aperture quando il workspace traccia le aperture e la scelta del contatto lo consente: `granted`, oppure sconosciuta con **Traccia** selezionato. I clic seguono la stessa regola.

La scelta si può impostare:

- **Con l'API**: `contacts.upsert`, `contacts.import`, il `contact` dell'API transazionale e l'endpoint di iscrizione. Senza un `tracking_consent_source`, un cambiamento fatto con una API Key registra `api` e un'importazione registra `import`; un modulo di iscrizione inviato senza API Key registra sempre `subscribe_form`.
- **Nella console**: nella pagina del contatto, quando crei o modifichi un contatto, e nelle importazioni CSV (colonne associate a _Consenso al tracciamento delle aperture_ e _Consenso al tracciamento dei clic_, valori `granted` o `denied`).
- **Dal contatto**, nel [centro notifiche](https://www.notifuse.com/it/docs/features/notification-center.md#email-tracking).

Invia `null` per riportare una scelta a sconosciuta. Una richiesta che non contiene questi campi mantiene la scelta salvata.

### Usare la scelta

- **Elenco dei contatti**: filtra per ciascuna scelta, `unknown` compreso, e mostra una colonna _Consenso al tracciamento_. Le esportazioni CSV includono i quattro campi.
- **Segmenti**: i quattro campi sono campi del contatto; usa _non è impostato_ per una scelta sconosciuta.
- **Automazioni**: un trigger _Contatto aggiornato_ può essere limitato a un cambiamento dell'una o dell'altra scelta.
- **Webhook**: i payload dei contatti contengono i quattro campi, e un cambiamento viene registrato nella cronologia del contatto.

## Quando un contatto cambia idea

La scelta viene applicata quando un'email viene inviata, e verificata di nuovo quando arriva un'apertura o un clic. Se un contatto rifiuta il tracciamento dopo l'invio di un'email, la sua apertura o il suo clic su quell'email non vengono registrati; il link lo porta comunque alla pagina.

## Clic sui link

Ogni email registra quali dei suoi link sono stati cliccati. La prima volta che un contatto clicca ciascun link di un'email, la
cronologia del contatto riceve una voce `email.link_clicked` con l'indirizzo del link, accanto alla voce `email.clicked` del
primo clic sull'email. Questa voce può [avviare un'automazione](https://www.notifuse.com/it/docs/features/automations.md#link-click-triggers) e aggiorna subito
i segmenti che filtrano su un link cliccato. Non conta nell'utilizzo mensile di eventi.

Non viene scritta alcuna voce per:

- un clic su un link già cliccato in quell'email (un link cliccato prima dell'aggiornamento alla 44.0 riceve la sua voce al
  clic successivo);
- un link che Notifuse non può verificare: i link nelle email inviate prima della versione 42.2 e i link la cui firma non corrisponde;
- un link il cui indirizzo supera i 2.048 caratteri, o un link oltre i primi 50 link diversi cliccati in
  un'email;
- i link che non sono `http` o `https`, come `mailto:` e `tel:`, e i link alla tua stessa istanza Notifuse, come
  i link di disiscrizione, del centro notifiche e della versione web. Notifuse li riconosce dal tuo endpoint API, dal dominio
  personalizzato del workspace o dall'host raggiunto dal clic (anche quello inoltrato da un reverse proxy), su qualsiasi porta.
  Sono compresi anche i link al tuo blog quando è servito sul tuo dominio personalizzato, e i link a un altro sito servito
  sullo stesso nome host della tua istanza Notifuse, anche su un'altra porta.

Aperture e clic su un'email il cui contatto è stato eliminato non vengono registrati; il link porta comunque il lettore alla pagina.

## Statistiche

I tassi di apertura e di clic si calcolano sulle email tracciate, non su tutte le email inviate. Quando alcune email non sono state tracciate, il tooltip del tasso dice quante lo sono state (_su 1.200 tracciate_); un tasso senza email tracciate mostra `-`. Questo vale per le statistiche dei broadcast, i risultati dei test A/B, i tassi di clic per link e la dashboard di analisi.

Le email inviate prima della versione 43 contano come tracciate, quindi i loro tassi non cambiano.

## Test A/B

Il vincitore automatico viene scelto in base al tasso di apertura o di clic sui destinatari tracciati di ogni variante. Una variante senza destinatari tracciati non può vincere; quando nessuna variante ne ha, scegli tu il vincitore.

Quando il workspace non traccia i contatti senza consenso registrato, nei risultati contano solo i contatti che hanno accettato. La tabella delle varianti mostra un avviso in arancione quando meno della metà dei destinatari di una variante è stata tracciata, e il tooltip di ogni tasso indica il numero di destinatari tracciati.

## Disattivare il tracciamento per una sola email

- **Broadcast**: seleziona **Non tracciare aperture e clic per questo broadcast** nel passaggio _Web Analytics_ (`tracking_mode: "no_tracking"` nell'API). I parametri UTM restano, e il vincitore di un test A/B va scelto a mano.
- **Notifiche transazionali**: scegli **Nessun tracciamento di aperture o clic, mantieni gli UTM** (`no_tracking`), oppure **Disattivato per questa notifica** (`disabled`), che lascia intatti anche i link, senza parametri UTM, per i link che non devono cambiare, come i link di accesso.

## Link nei template

Due variabili permettono ai contatti di fare la loro scelta da un'email:

- `{{ tracking_preferences_url }}` apre la finestra del tracciamento email nel centro notifiche.
- `{{ tracking_optout_url }}` chiede al contatto di confermare, poi rifiuta sia il tracciamento delle aperture sia quello dei clic (origine `email_link`). Nulla viene registrato finché il contatto non conferma, perché gli scanner di sicurezza email aprono i link da soli.

```html
<a href="{{ tracking_preferences_url }}">Choose what we track</a>
```

Notifuse non riscrive mai questi due link per il tracciamento.
