Guida pratica
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.
- 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:
Nella pagina del dominio in Email APIDomains, trova il riquadro Custom Subdomains. Inserisci un prefisso in Tracking Subdomain, ad esempio links, e seleziona Save.
Chiama Aggiorna un dominio con tracking_key. Puoi anche passarlo quando crei il dominio.
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
-
Aggiungi il record CNAME. Presso il provider DNS, crea questo record:
Tipo Host Destinazione CNAME go(o il tuo sottodominio di tracciamento)go.emailitmail.comPer
acme.com, il risultato è:go.acme.com. CNAME go.emailitmail.com.Se invii da un sottodominio come
mail.acme.com, l’host ègo.mailnella zonaacme.com. -
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 crea il record come DNS only al posto tuo.
-
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. -
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 con
"track_loads": truee"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.
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
-
Invia un’email di prova dal dominio con almeno un link, ad esempio con Compose nella pagina Emails.
-
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. -
Apri e fai clic. Apri l’email e fai clic sul link. La pagina dell’email in Email APIEmails elenca l’apertura in Loads e il clic in Clicks, e lo stato passa a
loadede poi aclicked.
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. |