Dominio de seguimiento
Un dominio de seguimiento es un hostname de marca en tu dominio de envío que sirve el seguimiento de aperturas y clics. Los enlaces reescritos usan este hostname a través de HTTPS en lugar de un dominio compartido. A diferencia del dominio de rebote, es opcional y nunca bloquea el envío.
El registro
El dominio de seguimiento es un CNAME bajo tu dominio de envío que resuelve a nuestra infraestructura de seguimiento en tu región:
| Tipo | Host | Valor |
|---|---|---|
| CNAME | links.example.com | <region>.links.bird.com |
El valor es específico de la región: us1.links.bird.com o eu1.links.bird.com. Cópialo desde Email > Domains o el recurso de dominio. El host predeterminado es links. bajo tu dominio de envío.
Personalizar el hostname
Elige la etiqueta al registrar el dominio pasando tracking.name; nosotros componemos el hostname completo:
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"
}
}
JSONcurl -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" }
}'Eso registra click.mail.acme.com como host de seguimiento en lugar del predeterminado links.mail.acme.com. Al igual que el return-path, pertenece a la configuración de dominio de tu espacio de trabajo.
No bloquea el envío
Un dominio con DKIM, return-path y DMARC verificados puede enviar incluso sin ningún registro de seguimiento; capabilities.tracking se reporta por separado de capabilities.sending. Hasta que el CNAME de seguimiento se verifique, las aperturas y clics no se rastrean a través de tu host de marca, y nada cambia en la entrega.
El seguimiento es el AND de tres cosas, así que un dominio de seguimiento verificado por sí solo no activa el seguimiento:
- El indicador por envío: track_opens / track_clicks en el mensaje (ambos predeterminados en true).
- La configuración del dominio: settings.open_tracking / settings.click_tracking (ambos predeterminados en off; habilitar uno sin un dominio de seguimiento configurado devuelve 409). Puedes activarlos antes de que el CNAME se verifique; surten efecto una vez que lo hace.
- Un CNAME de seguimiento verificado.
Así que las aperturas y clics empiezan a fluir solo cuando has configurado y verificado un dominio de seguimiento y activado la configuración del dominio. Consulta Métricas de correo electrónico para ver qué hace cada indicador en un mensaje.
Cambiarlo después
Los cambios de hostname de seguimiento se procesan igual que los cambios de return-path: un hostname ya verificado nunca se reemplaza por uno no verificado. Verificamos el nuevo CNAME de seguimiento junto al activo y lo promovemos solo cuando el nuevo registro pasa la comprobación, de modo que el seguimiento de marca nunca se interrumpe durante el cambio. Después de un intercambio, los registros antiguos se reportan como deprecated, y los enlaces rastreados en correos enviados previamente siguen resolviendo.
Eliminarlo
Dos vías lo eliminan, con diferente radio de impacto:
- Eliminar el seguimiento del dominio actualizándolo con tracking: null. Ambas configuraciones de seguimiento deben estar desactivadas primero; de lo contrario, la actualización devuelve 409. El envío no se ve afectado, los nuevos envíos dejan de usar seguimiento de marca, y los enlaces en correos enviados previamente siguen resolviendo mientras los registros antiguos se reportan como deprecated.
- Liberar el hostname con el endpoint de liberación cuando quieras dejarlo disponible para reutilización. Un hostname de seguimiento lo reclama una organización por región, así que otra organización no puede registrarlo mientras tú lo retengas. Liberarlo elimina la configuración de seguimiento, desactiva ambas configuraciones de seguimiento y abandona tu reclamación. Esta es la eliminación definitiva: los enlaces rastreados en mensajes entregados previamente dejan de resolver una vez que ningún otro dominio en tu organización usa el mismo hostname.
Si estás migrando a un nuevo hostname, procesa el cambio en lugar de liberar: intercámbialo mediante actualización, deja que el nuevo CNAME se verifique y los enlaces antiguos seguirán funcionando.
Próximos pasos
- Métricas de correo electrónico: qué registran el seguimiento de aperturas y clics, y los indicadores por envío
- Dominios de envío: registrar un dominio y el ciclo de vida de verificación
- Dominio de rebote: el hostname de return-path obligatorio
- DKIM, SPF & DMARC: cada registro en el dominio y qué demuestra
Recursos relacionados
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.
Ver la guíaGetting started with emailExplorar la funcionalidadEmailSeguir la ruta de aprendizajeBuild your first integrationGuía de implementaciónSend your first email
Prueba el ejercicio y obtén un resumen de implementación