# Tracciamento di aperture e clic

> Come Emailit traccia le aperture con un pixel e i clic con link riscritti sul tuo dominio, quanto sono accurati i dati e come attivare o disattivare il tracciamento.

Emailit può registrare quando i destinatari aprono le tue email e cliccano sui loro link. Il tracciamento usa un nome host sul tuo dominio, come `go.acme.com`, quindi i destinatari non vedono mai un host di tracciamento condiviso. Questa pagina spiega come funziona il tracciamento, i suoi limiti e come controllarlo.

## Come funziona

Il tracciamento funziona solo quando il dominio di invio ha un CNAME di tracciamento verificato (`go.<domain>` che punta a `go.emailitmail.com`). Senza, Emailit invia comunque la tua posta, ma senza tracciamento. Prima [configura un dominio di tracciamento personalizzato](/it/docs/tracking/custom-tracking-domain/).

**Aperture (caricamenti).** Emailit aggiunge un’immagine trasparente 1×1 alla fine del corpo HTML, caricata da `https://go.acme.com/<token>`. Quando l’app di posta del destinatario la carica, Emailit registra un caricamento e restituisce l’immagine. Le aperture si possono tracciare solo nelle email HTML.

**Clic.** Prima dell’invio, Emailit riscrive ogni link `http` e `https` nelle parti HTML e in testo semplice in `https://go.acme.com/<token>`. Quando qualcuno fa clic, Emailit registra il clic e reindirizza subito all’URL originale. Lascia invariati i link `mailto:` e `tel:`, i link relativi e i link ai domini di Emailit. Se il messaggio ha l’HTML ma non una parte in testo semplice, Emailit ne genera una dall’HTML quando aggiunge il tracciamento dei clic.

Emailit usa il termine **loaded** per le aperture, perché può vedere solo che l’immagine è stata caricata, non che una persona ha letto l’email.

## Accuratezza e privacy

Considera i dati su aperture e clic come un segnale, non come un conteggio esatto. Emailit registra ogni richiesta che arriva al tuo dominio di tracciamento e non filtra il traffico automatico.

- **Apple Mail Privacy Protection** scarica le immagini, pixel compreso, tramite i server proxy di Apple appena arriva la posta. Quei messaggi risultano caricati anche se nessuno li ha aperti, e l’indirizzo IP è di Apple.
- **I proxy delle immagini**, come quello di Gmail, scaricano e tengono in cache le immagini per conto del destinatario. L’indirizzo IP e lo user agent sono quelli del proxy, e le aperture successive potrebbero non arrivare a Emailit.
- **Le immagini bloccate** fanno sì che non venga registrata nessuna apertura, anche quando il destinatario legge l’email.
- **Gli scanner di sicurezza** dei sistemi di posta aziendali seguono i link per controllarli prima che il destinatario veda il messaggio. Questi compaiono come clic, spesso pochi secondi dopo la consegna.

I clic sono un segnale di engagement più affidabile delle aperture. Per le decisioni sulla deliverability, guarda le tendenze su molti messaggi invece dei singoli eventi.

Il tracciamento registra l’indirizzo IP e lo user agent di ogni apertura e di ogni clic. In molte aree geografiche, le leggi sulla privacy ti obbligano a informare i destinatari del tracciamento, ad esempio nell’informativa sulla privacy, e alcune richiedono il consenso. Se non ti servono questi dati, lascia il tracciamento disattivato.

## Attiva il tracciamento

### Impostazioni predefinite del dominio

Ogni dominio ha due interruttori nel riquadro **Tracking** della sua pagina in **Email API → Domains**: **Track loads** e **Track clicks**. Sono disattivati per i nuovi domini e restano disabilitati finché il CNAME di tracciamento non risulta **OK**.

Gli interruttori impostano il valore predefinito per ogni email inviata dal dominio tramite API e SMTP. Via SMTP, le impostazioni predefinite del dominio sono l’unico modo per controllare il tracciamento.

Con l’API, chiama [Aggiorna un dominio](/it/docs/api-reference/domains/update/) con `track_loads` e `track_clicks`. Attivarne uno prima che il CNAME sia verificato restituisce `422`.

### Impostazione per singola email

Il campo `tracking` di [Invia un’email](/it/docs/api-reference/emails/send/) sostituisce le impostazioni predefinite del dominio per quel messaggio:

| Valore | Aperture | Clic |
| --- | --- | --- |
| Omesso | Predefinito del dominio | Predefinito del dominio |
| `true` | Attivo | Attivo |
| `false` | Disattivato | Disattivato |
| `{ "loads": true, "clicks": false }` | Attivo | Disattivato |
| `{ "clicks": true }` | Disattivato | Attivo |

Nella forma a oggetto, una chiave omessa conta come disattivata. Il valore predefinito del dominio non la sostituisce.

```bash
curl https://api.emailit.com/v2/emails \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your receipt",
    "html": "<p>Thanks for your order.</p>",
    "tracking": { "loads": false, "clicks": true }
  }'
```

Se il CNAME di tracciamento del dominio non è verificato, Emailit disattiva il tracciamento per il messaggio invece di rifiutarlo. L’oggetto `tracking` nella risposta mostra cosa è stato effettivamente applicato.

Le email delle campagne richiedono sempre il tracciamento di aperture e clic, quindi vengono tracciate ogni volta che il CNAME di tracciamento del dominio di invio è verificato. Le email di prova di una campagna non vengono tracciate.

## Eventi

Ogni apertura e ogni clic crea un evento, non solo il primo. Lo stato dell’email passa a `loaded` dopo la prima apertura e a `clicked` dopo il primo clic.

| Evento | Quando viene generato |
| --- | --- |
| [`email.loaded`](/it/docs/webhooks/events/email/loaded/) | Il pixel di tracciamento è stato caricato. |
| [`email.clicked`](/it/docs/webhooks/events/email/clicked/) | È stato cliccato un link tracciato. |

Entrambi i payload includono l’indirizzo IP e lo user agent della richiesta, l’email a cui appartengono e il contatto corrispondente, se esiste. `email.clicked` include anche il link. Ecco il `data.object` di un evento `email.clicked`:

```json
{
  "id": "click_7Tn4Lp9Kd2Rv",
  "object": "click",
  "email_id": "em_5Vb2Nq8Xc1Jm",
  "email": {
    "id": "em_5Vb2Nq8Xc1Jm",
    "rcpt_to": "ada@example.com",
    "mail_from": "hello@acme.com",
    "subject": "Your receipt",
    "created_at": "2026-10-01T09:12:44Z",
    "campaign": null,
    "meta": { "order_id": "1042" }
  },
  "link": {
    "id": "link_9Wd3Ks6Mf4Ht",
    "url": "https://acme.com/orders/1042"
  },
  "contact": { "id": "con_8Ry5Bv2Lq7Np", "email": "ada@example.com" },
  "ip_address": "203.0.113.24",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_5) AppleWebKit/605.1.15",
  "created_at": "2026-10-01T09:15:02Z"
}
```

`email.loaded` ha la stessa forma con `"object": "load"`, un ID che inizia con `load_` e nessun `link`. Vedi [Richieste webhook](/it/docs/webhooks/webhook-requests/) per il formato completo della richiesta.

## Dove vedere i dati di tracciamento

- **Dettagli dell’email.** Le schede **Loads** e **Clicks** nella pagina di un’email elencano ogni apertura e ogni clic con ora, indirizzo IP e, per i clic, l’URL. Vedi [Dettagli dell’email](/it/docs/logs/email-details/).
- **Analisi.** I widget **Loads** e **Clicks** mostrano l’andamento dell’engagement nel tempo. Vedi [Analisi](/it/docs/analytics/).
- **Report delle campagne.** Email caricate, cliccate e tasso di clic per ogni campagna, con i clic per link. Vedi [Report delle campagne](/it/docs/campaigns/reports/).
- **Eventi e webhook.** Ogni evento `email.loaded` ed `email.clicked` compare in **Email API → Events** e viene inviato ai webhook iscritti.

## Passaggi successivi

  - [Configura un dominio di tracciamento personalizzato](/it/docs/tracking/custom-tracking-domain/): Pubblica e verifica il CNAME di tracciamento.
  - [Configura un webhook](/it/docs/webhooks/set-up/): Ricevi gli eventi email.loaded ed email.clicked.

---
Fonte: https://emailit.com/it/docs/tracking/