Tracking-Domain

Eine Tracking-Domain ist ein gebrandeter Hostname auf Ihrer Sending-Domain, der Open- und Click-Tracking bereitstellt. Umgeschriebene Links verwenden diesen Hostname über HTTPS anstelle einer geteilten Domain. Anders als die Bounce-Domain ist sie optional und blockiert niemals den Versand.

Der Eintrag

Die Tracking-Domain ist ein CNAME unter Ihrer Sending-Domain, der auf unsere Tracking-Infrastruktur in Ihrer Region verweist:

Typ	Host	Wert
CNAME	links.example.com	<region>.links.bird.com

Der Wert ist regionsspezifisch: us1.links.bird.com oder eu1.links.bird.com. Kopieren Sie ihn aus Email > Domains oder der Domain-Ressource. Der Host ist standardmäßig links. unter Ihrer Sending-Domain.

Den Hostnamen anpassen

Wählen Sie das Label bei der Registrierung der Domain, indem Sie tracking.name übergeben; wir setzen den vollständigen Hostnamen zusammen:

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" }
  }'

Das registriert click.mail.acme.com als Tracking-Host anstelle des Standards links.mail.acme.com. Wie der Return-Path gehört er zur Domain-Konfiguration Ihres Workspace.

Er blockiert den Versand nicht

Eine Domain mit verifiziertem DKIM, Return-Path und DMARC kann auch ganz ohne Tracking-Eintrag senden; capabilities.tracking wird getrennt von capabilities.sending gemeldet. Bis der Tracking-CNAME verifiziert ist, werden Öffnungen und Klicks nicht über Ihren gebrandeten Host erfasst, und an der Zustellung ändert sich nichts.

Tracking ist die UND-Verknüpfung dreier Dinge – eine verifizierte Tracking-Domain allein aktiviert das Tracking also nicht:

Das Flag pro Versand: track_opens / track_clicks auf der Nachricht (beide standardmäßig true).
Die Domain-Einstellung: settings.open_tracking / settings.click_tracking (beide standardmäßig aus; wird eine aktiviert, ohne dass eine Tracking-Domain konfiguriert ist, wird 409 zurückgegeben). Sie können diese einschalten, bevor der CNAME verifiziert ist; sie greifen, sobald er es ist.
Ein verifizierter Tracking-CNAME.

Öffnungen und Klicks fließen also erst, wenn Sie eine Tracking-Domain konfiguriert und verifiziert und die Domain-Einstellung aktiviert haben. Siehe E-Mail-Metriken für die Wirkung jedes Flags auf eine Nachricht.

Nachträgliches Ändern

Änderungen am Tracking-Hostnamen werden genauso gestaffelt wie Return-Path-Änderungen: Ein bereits verifizierter Hostname wird nie durch einen unverifizierten ersetzt. Wir verifizieren den neuen Tracking-CNAME parallel zum aktiven und stufen ihn erst hoch, wenn der neue Eintrag die Prüfung besteht – so bricht gebrandetes Tracking nie mitten im Wechsel ab. Nach einem Tausch werden die alten Einträge als deprecated gemeldet, und getrackte Links in zuvor gesendeten E-Mails lösen weiterhin auf.

Entfernen

Zwei Wege entfernen sie, mit unterschiedlicher Tragweite:

Tracking von der Domain entfernen, indem Sie sie mit tracking: null aktualisieren. Beide Tracking-Einstellungen müssen vorher aus sein; andernfalls gibt das Update 409 zurück. Der Versand ist nicht betroffen, neue Sends verwenden kein gebrandetes Tracking mehr, und Links in zuvor gesendeten E-Mails lösen weiterhin auf, während die alten Einträge als deprecated gemeldet werden.
Den Hostnamen freigeben über den Release-Endpunkt, wenn Sie ihn zur Wiederverwendung freigeben möchten. Ein Tracking-Hostname ist pro Region an eine Organisation gebunden, sodass eine andere Organisation ihn nicht registrieren kann, solange Sie ihn halten. Die Freigabe entfernt die Tracking-Konfiguration, schaltet beide Tracking-Einstellungen aus und gibt Ihren Anspruch auf. Das ist die harte Entfernung: Getrackte Links in zuvor zugestellten Nachrichten lösen nicht mehr auf, sobald keine andere Domain in Ihrer Organisation denselben Hostnamen verwendet.

Wenn Sie auf einen neuen Hostnamen migrieren, staffeln Sie den Wechsel statt freizugeben: Tauschen Sie per Update, lassen Sie den neuen CNAME verifizieren, und alte Links funktionieren weiterhin.

Nächste Schritte

E-Mail-Metriken: was Open- und Click-Tracking erfassen und die Flags pro Versand
Sending-Domains: eine Domain registrieren und der Verifizierungszyklus
Bounce-Domain: der erforderliche Return-Path-Hostname
DKIM, SPF & DMARC: alle Einträge auf der Domain und was sie nachweisen