Domaine de suivi

Un domaine de suivi est un nom d'hôte de marque sur votre domaine d'envoi qui gère le suivi des ouvertures et des clics. Les liens réécrits utilisent ce nom d'hôte via HTTPS au lieu d'un domaine partagé. Contrairement au domaine de rebond, il est facultatif et ne bloque jamais l'envoi.

L'enregistrement

Le domaine de suivi est un CNAME sous votre domaine d'envoi qui pointe vers notre infrastructure de suivi dans votre région :

Type	Hôte	Valeur
CNAME	links.example.com	<region>.links.bird.com

La valeur dépend de la région : us1.links.bird.com ou eu1.links.bird.com. Copiez-la depuis Email > Domains ou la ressource de domaine. L'hôte par défaut est links. sous votre domaine d'envoi.

Personnaliser le nom d'hôte

Choisissez le libellé lors de l'enregistrement du domaine en passant tracking.name ; nous composons le nom d'hôte complet :

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

Cela enregistre click.mail.acme.com comme hôte de suivi au lieu de la valeur par défaut links.mail.acme.com. Comme le return-path, il fait partie de la configuration de domaine de votre espace de travail.

Il ne bloque pas l'envoi

Un domaine dont DKIM, le return-path et DMARC sont vérifiés peut envoyer même sans aucun enregistrement de suivi ; capabilities.tracking est signalé séparément de capabilities.sending. Tant que le CNAME de suivi n'est pas vérifié, les ouvertures et les clics ne sont pas suivis via votre hôte de marque, et rien ne change côté livraison.

Le suivi est le ET logique de trois éléments, donc un domaine de suivi vérifié seul n'active pas le suivi :

L'indicateur par envoi : track_opens / track_clicks sur le message (les deux valent true par défaut).
Le paramètre du domaine : settings.open_tracking / settings.click_tracking (les deux sont désactivés par défaut ; en activer un sans domaine de suivi configuré renvoie 409). Vous pouvez les activer avant la vérification du CNAME ; ils prennent effet une fois celle-ci terminée.
Un CNAME de suivi vérifié.

Les ouvertures et les clics ne commencent donc à remonter qu'une fois le domaine de suivi configuré et vérifié et le paramètre du domaine activé. Consultez Métriques e-mail pour savoir ce que chaque indicateur fait à un message.

Le modifier ultérieurement

Les changements de nom d'hôte de suivi sont préparés de la même manière que les changements de return-path : un nom d'hôte déjà vérifié n'est jamais remplacé par un nom non vérifié. Nous vérifions le nouveau CNAME de suivi en parallèle de l'actif et ne le promouvons qu'une fois le nouvel enregistrement validé, de sorte que le suivi de marque ne se rompt jamais en cours de changement. Après la bascule, les anciens enregistrements sont signalés comme deprecated, et les liens suivis dans les e-mails déjà envoyés continuent de résoudre.

Le supprimer

Deux méthodes permettent de le supprimer, avec un rayon d'impact différent :

Retirer le suivi du domaine en le mettant à jour avec tracking: null. Les deux paramètres de suivi doivent d'abord être désactivés ; sinon la mise à jour renvoie 409. L'envoi n'est pas affecté, les nouveaux envois cessent d'utiliser le suivi de marque, et les liens dans les e-mails déjà envoyés continuent de résoudre tant que les anciens enregistrements sont signalés comme deprecated.
Libérer le nom d'hôte via le point de terminaison de libération lorsque vous souhaitez le rendre disponible pour réutilisation. Un nom d'hôte de suivi est réservé par une seule organisation par région, une autre organisation ne peut donc pas l'enregistrer tant que vous le détenez. La libération supprime la configuration de suivi, désactive les deux paramètres de suivi et abandonne votre réservation. C'est la suppression définitive : les liens suivis dans les messages déjà livrés cessent de résoudre dès qu'aucun autre domaine de votre organisation n'utilise le même nom d'hôte.

Si vous migrez vers un nouveau nom d'hôte, préparez le changement au lieu de libérer : basculez via une mise à jour, laissez le nouveau CNAME se vérifier, et les anciens liens continuent de fonctionner.

Étapes suivantes

Métriques e-mail : ce que le suivi des ouvertures et des clics enregistre, et les indicateurs par envoi
Domaines d'envoi : enregistrer un domaine et le cycle de vérification
Domaine de rebond : le nom d'hôte return-path requis
DKIM, SPF & DMARC : chaque enregistrement du domaine et ce qu'il prouve

Ressources associées

Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.

Regarder le guideGetting started with email Explorer la fonctionnalitéEmail Suivre le parcours d'apprentissageBuild your first integration Guide d'implémentationSend your first email

Essayez la pratique et obtenez un guide d'implémentation