Domínio de rastreamento

Um domínio de rastreamento é um hostname personalizado no seu domínio de envio que serve o rastreamento de aberturas e cliques. Os links reescritos usam esse hostname via HTTPS em vez de um domínio compartilhado. Diferente do domínio de bounce, ele é opcional e nunca bloqueia o envio.

O registro

O domínio de rastreamento é um CNAME sob o seu domínio de envio que resolve para a nossa infraestrutura de rastreamento na sua região:

Tipo	Host	Valor
CNAME	links.example.com	<region>.links.bird.com

O valor é específico por região: us1.links.bird.com ou eu1.links.bird.com. Copie-o em Email > Domains ou no recurso de domínio. O host padrão é links. sob o seu domínio de envio.

Personalizando o hostname

Escolha o label ao registrar o domínio passando tracking.name; nós compomos o 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"
  }
}
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" }
  }'

Isso registra click.mail.acme.com como host de rastreamento em vez do padrão links.mail.acme.com. Assim como o return-path, ele pertence à configuração de domínio do seu espaço de trabalho.

Não bloqueia o envio

Um domínio com DKIM verificado, return-path e DMARC pode enviar mesmo sem nenhum registro de rastreamento; capabilities.tracking é reportado separadamente de capabilities.sending. Até que o CNAME de rastreamento seja verificado, aberturas e cliques não são rastreados pelo seu host personalizado, e nada muda na entrega.

O rastreamento é o AND de três coisas, então um domínio de rastreamento verificado sozinho não ativa o rastreamento:

A flag por envio: track_opens / track_clicks na mensagem (ambas com padrão true).
A configuração do domínio: settings.open_tracking / settings.click_tracking (ambas com padrão off; ativar uma sem domínio de rastreamento configurado retorna 409). Você pode ativá-las antes do CNAME ser verificado; elas passam a valer assim que ele for.
Um CNAME de rastreamento verificado.

Então aberturas e cliques só começam a fluir depois que você configura e verifica um domínio de rastreamento e ativa a configuração do domínio. Consulte Métricas de e-mail para saber o que cada flag faz na mensagem.

Alterando depois

Alterações no hostname de rastreamento são preparadas da mesma forma que alterações no return-path: um hostname já verificado nunca é substituído por um não verificado. Verificamos o novo CNAME de rastreamento junto com o ativo e o promovemos somente quando o novo registro é aprovado, então o rastreamento personalizado nunca quebra durante a troca. Após uma troca, os registros antigos são reportados como deprecated, e links rastreados em e-mails enviados anteriormente continuam resolvendo.

Removendo

Dois caminhos o removem, com raios de impacto diferentes:

Remova o rastreamento do domínio atualizando-o com tracking: null. Ambas as configurações de rastreamento precisam estar desativadas primeiro; caso contrário, a atualização retorna 409. O envio não é afetado, novos envios param de usar rastreamento personalizado, e links em e-mails enviados anteriormente continuam resolvendo enquanto os registros antigos são reportados como deprecated.
Libere o hostname com o endpoint de liberação quando quiser liberá-lo para reutilização. Um hostname de rastreamento é reivindicado por uma organização por região, então outra organização não pode registrá-lo enquanto você o detém. A liberação remove a configuração de rastreamento, desativa ambas as configurações de rastreamento e remove sua reivindicação. Esta é a remoção definitiva: links rastreados em mensagens entregues anteriormente param de resolver quando nenhum outro domínio na sua organização usa o mesmo hostname.

Se você está migrando para um novo hostname, prepare a troca em vez de liberar: troque via atualização, deixe o novo CNAME verificar, e os links antigos continuam funcionando.

Próximos passos

Métricas de e-mail: o que o rastreamento de aberturas e cliques registra, e as flags por envio
Domínios de envio: registrando um domínio e o ciclo de vida de verificação
Domínio de bounce: o hostname de return-path obrigatório
DKIM, SPF & DMARC: todos os registros no domínio e o que cada um comprova

Recursos relacionados

Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.

Assista ao guiaGetting started with email Explore a funcionalidadeEmail Siga o percurso de aprendizagemBuild your first integration Guia de implementaçãoSend your first email

Experimente na prática e obtenha um resumo de implementação