# Configura un dominio di tracciamento personalizzato

> Pubblica il CNAME di tracciamento del dominio di invio, verificalo e attiva il tracciamento di aperture e clic, così link e pixel usano il tuo nome host in HTTPS.

In Emailit il tracciamento di aperture e clic usa sempre un nome host sul tuo dominio, come `go.acme.com`. Questa guida mostra come pubblicare il record CNAME per quel nome host, verificarlo e attivare il tracciamento.

## Prima di iniziare

- Aggiungi e verifica il dominio di invio. Vedi [Aggiungi un dominio](/it/docs/domains/add-a-domain/).
- Assicurati di poter modificare i record DNS del dominio.
- Scegli un nome host che non sia usato per nient’altro. Il valore predefinito è `go`, che dà `go.acme.com`.

## Scegli il sottodominio di tracciamento

Il nome host di tracciamento è `<tracking subdomain>.<sending domain>`. Per usare qualcosa di diverso da `go`:

**Pannello**

  Nella pagina del dominio in **Email API → Domains**, trova il riquadro **Custom Subdomains**. Inserisci un prefisso in **Tracking Subdomain**, ad esempio `links`, e seleziona **Save**.

**API**

  Chiama [Aggiorna un dominio](/it/docs/api-reference/domains/update/) con `tracking_key`. Puoi anche passarlo quando [crei il dominio](/it/docs/api-reference/domains/create/).

```bash
curl https://api.emailit.com/v2/domains/acme.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tracking_key": "links" }'
```

Il prefisso può contenere lettere minuscole, cifre e trattini, fino a 63 caratteri, e deve iniziare e finire con una lettera o una cifra. Modificarlo riporta il record di tracciamento a **Not checked**, quindi pubblica un CNAME per il nuovo nome host e controlla di nuovo i DNS.

## Pubblica e verifica il CNAME

1. **Aggiungi il record CNAME.** Presso il provider DNS, crea questo record:

   | Tipo | Host | Destinazione |
   | --- | --- | --- |
   | CNAME | `go` (o il tuo sottodominio di tracciamento) | `go.emailitmail.com` |

   Per `acme.com`, il risultato è:

```txt
go.acme.com.   CNAME   go.emailitmail.com.
```

   Se invii da un sottodominio come `mail.acme.com`, l’host è `go.mail` nella zona `acme.com`.

2. **Disattiva il proxy su Cloudflare.** Se i DNS sono su Cloudflare, imposta lo stato del proxy del record su **DNS only** (nuvola grigia). Un record con proxy restituisce gli indirizzi IP di Cloudflare invece del CNAME, e il tracciamento non può essere verificato né servire le richieste. La [configurazione con Cloudflare](/it/docs/domains/cloudflare/) crea il record come DNS only al posto tuo.

3. **Controlla i DNS.** Nella pagina del dominio, seleziona **Check DNS**. Il badge di stato nel riquadro **Tracking** passa a **OK** quando il CNAME punta a `go.emailitmail.com`.

4. **Attiva il tracciamento.** Nel riquadro **Tracking**, attiva **Track loads**, **Track clicks** o entrambi. Gli interruttori restano disabilitati finché il CNAME non risulta **OK**.

   Con l’API, chiama [Aggiorna un dominio](/it/docs/api-reference/domains/update/) con `"track_loads": true` e `"track_clicks": true`.

Questi interruttori impostano il valore predefinito per la posta inviata dal dominio. Puoi sostituirlo per una singola email con il campo `tracking` quando invii tramite l’API. Vedi [Tracciamento di aperture e clic](/it/docs/tracking/#turn-tracking-on).

## HTTPS

Tutti i link e i pixel di tracciamento usano `https://`. Emailit emette e rinnova automaticamente il certificato per il tuo nome host di tracciamento, la prima volta che riceve una richiesta per quel nome host. Non devi caricare un certificato né modificare nient’altro.

## Verifica che funzioni

1. **Invia un’email di prova** dal dominio con almeno un link, ad esempio con **Compose** nella pagina **Emails**.

2. **Controlla i link.** Nel messaggio ricevuto, passa il puntatore su un link. Deve iniziare con `https://go.acme.com/`, non con il tuo URL originale.

3. **Apri e fai clic.** Apri l’email e fai clic sul link. La pagina dell’email in **Email API → Emails** elenca l’apertura in **Loads** e il clic in **Clicks**, e lo stato passa a `loaded` e poi a `clicked`.

## Risoluzione dei problemi

| Sintomo | Soluzione |
| --- | --- |
| Il tracciamento risulta **Missing** | Il CNAME non è pubblicato sull’host previsto. Controlla con `dig +short CNAME go.acme.com @1.1.1.1`. Una causa frequente è inserire il nome completo dove il provider si aspetta solo `go`. |
| Il tracciamento risulta **Invalid** | Il CNAME punta altrove, oppure il record ha il proxy attivo su Cloudflare. Fallo puntare a `go.emailitmail.com` e impostalo su **DNS only**. |
| **Track loads** e **Track clicks** sono disattivati | Il CNAME non è ancora verificato. Dopo averlo pubblicato, seleziona **Check DNS**. |
| Le email arrivano con i link originali | Il tracciamento è disattivato per il dominio, il messaggio è stato inviato con `"tracking": false`, oppure il record di tracciamento non risultava **OK** all’ultimo controllo DNS. Emailit invia senza tracciamento invece di non riuscire. |
| I link mostrano un avviso sul certificato | Il CNAME è stato creato da pochi istanti. Attendi un minuto e riprova. Se persiste, controlla che il record non abbia il proxy attivo. |
| Esiste già un CNAME su `go` | Scegli un altro sottodominio di tracciamento, come `links` o `t`, e pubblica lì il CNAME. |

## Vedi anche

  - [Tracciamento di aperture e clic](/it/docs/tracking/): Come funziona il tracciamento e quanto è accurato.
  - [Record DNS per i domini di invio](/it/docs/domains/dns-records/): Tutti i record di un dominio di invio.

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