Sign inGet started

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:
TipoHostValor
CNAMElinks.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" },
});
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