跟踪域名
DNS 记录
跟踪域名是发送域名下的一条 CNAME 记录,解析到你所在区域的跟踪基础设施:
| 类型 | 主机 | 值 |
|---|---|---|
| CNAME | links.example.com | <region>.links.bird.com |
值因区域而异:us1.links.bird.com 或 eu1.links.bird.com。从 Email > Domains 或域名资源中复制。主机默认为发送域名下的 links.。
自定义主机名
注册域名时通过传入 tracking.name 来选择标签;我们会拼接完整的主机名:
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" }
}'这会将 click.mail.acme.com 注册为跟踪主机,而非默认的 links.mail.acme.com。与 return-path 一样,它属于你的工作区域名配置。
它不会阻止发送
已验证 DKIM、return-path 和 DMARC 的域名即使没有任何跟踪记录也可以发送;capabilities.tracking 与 capabilities.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 验证通过,旧链接会继续正常工作。
后续步骤
- 邮件指标:打开和点击跟踪记录的内容,以及每次发送标志
- 发送域名:注册域名与验证生命周期
- 退信域名:必需的 return-path 主机名
- DKIM、SPF 和 DMARC:域名上的所有记录及其证明内容