Tracking domain

Un tracking domain è un hostname brandizzato sul tuo dominio di invio che gestisce il tracciamento di aperture e clic. I link riscritti usano questo hostname su HTTPS al posto di un dominio condiviso. A differenza del bounce domain, è opzionale e non blocca mai l'invio.

Il record

Il tracking domain è un CNAME sotto il tuo dominio di invio che risolve verso la nostra infrastruttura di tracciamento nella tua regione:

Tipo	Host	Valore
CNAME	links.example.com	<region>.links.bird.com

Il valore è specifico per regione: us1.links.bird.com o eu1.links.bird.com. Copialo da Email > Domains o dalla risorsa dominio. L'host predefinito è links. sotto il tuo dominio di invio.

Personalizzare l'hostname

Scegli l'etichetta quando registri il dominio passando tracking.name; l'hostname completo viene composto automaticamente:

const domain = await bird.domains.create({
  domain: "mail.acme.com",
  tracking: { name: "click" },
});

domain = client.domains.create(
    domain="mail.acme.com",
    tracking={"name": "click"},
)

domain, err := client.Domains.Create(context.Background(), bird.DomainCreateParams{
	Domain:   "mail.acme.com",
	Tracking: &bird.DomainTrackingConfig{Name: "click"},
})

$domain = $bird->domains->create(
    (new DomainCreate())
        ->setDomain('mail.acme.com')
        ->setTracking((new DomainTrackingConfig())->setName('click')),
);

bird email domains create mail.acme.com --body-file - <<'JSON'
{
  "domain": "mail.acme.com",
  "tracking": {
    "name": "click"
  }
}
JSON

curl -s https://us1.platform.bird.com/v1/email/domains \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "mail.acme.com",
    "tracking": { "name": "click" }
  }'

Questo registra click.mail.acme.com come host di tracciamento al posto del valore predefinito links.mail.acme.com. Come il return-path, appartiene alla configurazione del dominio del tuo spazio di lavoro.

Non blocca l'invio

Un dominio con DKIM, return-path e DMARC verificati può inviare anche senza alcun record di tracciamento; capabilities.tracking viene riportato separatamente da capabilities.sending. Finché il CNAME di tracciamento non viene verificato, aperture e clic non vengono tracciati attraverso il tuo host brandizzato, e nulla cambia nella consegna.

Il tracciamento è l'AND di tre elementi, quindi un tracking domain verificato da solo non attiva il tracciamento:

Il flag per singolo invio: track_opens / track_clicks sul messaggio (entrambi predefiniti a true).
L'impostazione del dominio: settings.open_tracking / settings.click_tracking (entrambi predefiniti a off; abilitarne uno senza un tracking domain configurato restituisce 409). Puoi attivarli prima che il CNAME venga verificato; diventano effettivi una volta completata la verifica.
Un CNAME di tracciamento verificato.

Quindi aperture e clic iniziano a fluire solo dopo aver configurato e verificato un tracking domain e attivato l'impostazione del dominio. Consulta Metriche email per capire cosa fa ciascun flag a un messaggio.

Modificarlo in seguito

Le modifiche all'hostname di tracciamento vengono preparate allo stesso modo di quelle al return-path: un hostname già verificato non viene mai sostituito da uno non verificato. Il nuovo CNAME di tracciamento viene verificato in parallelo a quello attivo e promosso solo quando il nuovo record supera il controllo, così il tracciamento brandizzato non si interrompe mai durante il cambio. Dopo lo scambio, i vecchi record vengono riportati come deprecated e i link tracciati nelle email già inviate continuano a risolversi.

Rimuoverlo

Due percorsi lo rimuovono, con diverso raggio d'impatto:

Rimuovere il tracciamento dal dominio aggiornandolo con tracking: null. Entrambe le impostazioni di tracciamento devono essere disattivate prima; altrimenti l'aggiornamento restituisce 409. L'invio non viene influenzato, i nuovi invii smettono di usare il tracciamento brandizzato e i link nelle email già inviate continuano a risolversi mentre i vecchi record vengono riportati come deprecated.
Rilasciare l'hostname con l'endpoint di rilascio quando vuoi liberarlo per il riutilizzo. Un hostname di tracciamento è rivendicato da una sola organizzazione per regione, quindi un'altra organizzazione non può registrarlo finché lo detieni. Il rilascio rimuove la configurazione di tracciamento, disattiva entrambe le impostazioni di tracciamento e annulla la tua rivendicazione. Questa è la rimozione definitiva: i link tracciati nei messaggi già consegnati smettono di risolversi se nessun altro dominio nella tua organizzazione usa lo stesso hostname.

Se stai migrando verso un nuovo hostname, prepara il cambio invece di rilasciare: effettua lo scambio tramite aggiornamento, lascia che il nuovo CNAME venga verificato e i vecchi link continueranno a funzionare.

Prossimi passi

Metriche email: cosa registrano il tracciamento di aperture e clic, e i flag per singolo invio
Domini di invio: registrare un dominio e il ciclo di vita della verifica
Bounce domain: l'hostname return-path obbligatorio
DKIM, SPF & DMARC: tutti i record sul dominio e cosa dimostrano

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Guarda la guidaGetting started with email Esplora la funzionalitàEmail Segui il percorso di apprendimentoBuild your first integration Guida all'implementazioneSend your first email

Prova l'esercitazione e ottieni un brief di implementazione