Sign inGet started

跟踪域名

跟踪域名是你的发送域名上的一个品牌主机名,用于打开和点击跟踪。重写后的链接通过 HTTPS 使用此主机名,而非共享域名。与退信域名不同,它是可选的,不会阻止发送。

DNS 记录

跟踪域名是发送域名下的一条 CNAME 记录,解析到你所在区域的跟踪基础设施:
类型主机
CNAMElinks.example.com<region>.links.bird.com
值因区域而异:us1.links.bird.comeu1.links.bird.com。从 Email > Domains 或域名资源中复制。主机默认为发送域名下的 links.

自定义主机名

注册域名时通过传入 tracking.name 来选择标签;我们会拼接完整的主机名:
const domain = await bird.domains.create({
  domain: "mail.acme.com",
  tracking: { name: "click" },
});
这会将 click.mail.acme.com 注册为跟踪主机,而非默认的 links.mail.acme.com。与 return-path 一样,它属于你的工作区域名配置。

它不会阻止发送

已验证 DKIM、return-path 和 DMARC 的域名即使没有任何跟踪记录也可以发送;capabilities.trackingcapabilities.sending 分开报告。在跟踪 CNAME 验证通过之前,打开和点击不会通过你的品牌主机进行跟踪,投递不受任何影响。
跟踪是三项条件的运算,因此仅有已验证的跟踪域名并不会开启跟踪:
  • 每次发送标志:消息上的 track_opens / track_clicks(两者默认为 true)。
  • 域名设置:settings.open_tracking / settings.click_tracking(两者默认关闭;在未配置跟踪域名时启用会返回 409)。你可以在 CNAME 验证通过前开启这些设置;它们会在验证通过后生效。
  • 已验证的跟踪 CNAME。
因此,只有在配置并验证了跟踪域名 并且 开启了域名设置之后,打开和点击数据才会开始流入。参见邮件指标了解每个标志对消息的影响。

后续更改

跟踪主机名的更改与 return-path 更改采用相同的暂存方式:已验证的主机名不会被未验证的主机名替换。我们会在现有记录旁同时验证新的跟踪 CNAME,只有新记录通过验证后才会提升为活跃记录,因此品牌跟踪在更改过程中不会中断。替换完成后,旧记录报告为 deprecated,先前已发送邮件中的跟踪链接继续可解析。

移除跟踪域名

有两种移除方式,影响范围不同:
  • 从域名移除跟踪,通过使用 tracking: null 更新域名。两项跟踪设置必须先关闭,否则更新会返回 409。发送不受影响,新发送的邮件停止使用品牌跟踪,先前已发送邮件中的链接继续可解析,旧记录报告为 deprecated
  • 释放主机名,使用释放端点来释放主机名以便重新使用。跟踪主机名在每个区域内由一个组织持有,其他组织在你持有期间无法注册。释放操作会移除跟踪配置、关闭两项跟踪设置并放弃你的持有权。这是硬性移除:一旦你的组织中没有其他域名使用相同的主机名,先前已投递邮件中的跟踪链接将停止解析。
如果你要迁移到新的主机名,请使用暂存更改而非释放:通过更新进行替换,等待新 CNAME 验证通过,旧链接会继续正常工作。

后续步骤