Trackingdomein

Een trackingdomein is een branded hostname op je verzenddomein dat open- en kliktracking verzorgt. Herschreven links gebruiken deze hostname via HTTPS in plaats van een gedeeld domein. Anders dan het bouncedomein is het optioneel en blokkeert het nooit het verzenden.

Het record

Het trackingdomein is een CNAME onder je verzenddomein die verwijst naar onze trackinginfrastructuur in jouw regio:

Type	Host	Waarde
CNAME	links.example.com	<region>.links.bird.com

De waarde is regiospecifiek: us1.links.bird.com of eu1.links.bird.com. Kopieer hem uit Email > Domains of de domeinresource. De host is standaard links. onder je verzenddomein.

De hostname aanpassen

Kies het label wanneer je het domein registreert door tracking.name mee te geven; wij stellen de volledige hostname samen:

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

Dat registreert click.mail.acme.com als trackinghost in plaats van de standaard links.mail.acme.com. Net als het return-path hoort het bij de domeinconfiguratie van je werkruimte.

Het blokkeert het verzenden niet

Een domein met geverifieerde DKIM, return-path en DMARC kan verzenden zelfs zonder trackingrecord; capabilities.tracking wordt apart gerapporteerd van capabilities.sending. Totdat de tracking-CNAME geverifieerd is, worden opens en kliks niet via je branded host getrackt, en aan de aflevering verandert er niets.

Tracking is de AND van drie dingen, dus een geverifieerd trackingdomein alleen zet tracking niet aan:

De vlag per verzending: track_opens / track_clicks op het bericht (beide standaard true).
De domeininstelling: settings.open_tracking / settings.click_tracking (beide standaard uit; er een inschakelen zonder geconfigureerd trackingdomein geeft 409 terug). Je kunt ze aanzetten voordat de CNAME geverifieerd is; ze worden actief zodra dat het geval is.
Een geverifieerde tracking-CNAME.

Opens en kliks beginnen dus pas te stromen zodra je een trackingdomein hebt geconfigureerd en geverifieerd en de domeininstelling hebt aangezet. Zie E-mailstatistieken voor wat elke vlag met een bericht doet.

Later wijzigen

Wijzigingen aan de trackinghostname worden op dezelfde manier gefaseerd als return-path-wijzigingen: een hostname die al geverifieerd is, wordt nooit vervangen door een niet-geverifieerde. We verifiëren de nieuwe tracking-CNAME naast de actieve en promoveren hem pas wanneer het nieuwe record klopt, zodat branded tracking nooit midden in een wijziging uitvalt. Na een wissel worden de oude records gerapporteerd als deprecated en blijven getrackte links in eerder verzonden e-mail werken.

Verwijderen

Er zijn twee manieren om het te verwijderen, met een verschillend bereik:

Tracking van het domein verwijderen door het te updaten met tracking: null. Beide trackinginstellingen moeten eerst uit staan; anders geeft de update 409 terug. Het verzenden wordt niet beïnvloed, nieuwe verzendingen gebruiken geen branded tracking meer, en links in eerder verzonden e-mail blijven werken terwijl de oude records als deprecated worden gerapporteerd.
De hostname vrijgeven met het release-endpoint wanneer je hem wilt vrijmaken voor hergebruik. Een trackinghostname wordt geclaimd door één organisatie per regio, dus een andere organisatie kan hem niet registreren zolang jij hem vasthoudt. Vrijgeven verwijdert de trackingconfiguratie, schakelt beide trackinginstellingen uit en laat je claim los. Dit is de harde verwijdering: getrackte links in eerder afgeleverde berichten stoppen met werken zodra geen ander domein in je organisatie dezelfde hostname gebruikt.

Als je migreert naar een nieuwe hostname, faseer dan de wijziging in plaats van vrij te geven: wissel via een update, laat de nieuwe CNAME verifiëren en oude links blijven werken.

Volgende stappen

E-mailstatistieken: wat open- en kliktracking vastleggen, en de vlaggen per verzending
Verzenddomeinen: een domein registreren en de verificatiecyclus
Bouncedomein: de vereiste return-path-hostname
DKIM, SPF & DMARC: elk record op het domein en wat het bewijst

Gerelateerde bronnen

Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.

Bekijk de gidsGetting started with email Ontdek de mogelijkheidEmail Volg het leerpadBuild your first integration ImplementatiegidsSend your first email

Probeer de oefening en ontvang een implementatieoverzicht