Rastreamento de aberturas e cliques

O Emailit pode registrar quando os destinatários abrem os seus e-mails e clicam nos links deles. O rastreamento funciona em um nome de host no seu próprio domínio, como go.acme.com, então os destinatários nunca veem um host de rastreamento compartilhado. Esta página explica como o rastreamento funciona, os limites dele e como controlá-lo.

Como funciona

O rastreamento só funciona quando o domínio de envio tem um CNAME de rastreamento verificado (go.<domain> apontando para go.emailitmail.com). Sem ele, o Emailit continua enviando os seus e-mails, só que sem rastreamento. Configure um domínio de rastreamento personalizado antes.

Aberturas (carregamentos). O Emailit adiciona uma imagem transparente de 1×1 ao final do corpo HTML, carregada de https://go.acme.com/<token>. Quando o app de e-mail do destinatário a carrega, o Emailit registra um carregamento e retorna a imagem. As aberturas só podem ser rastreadas em e-mails HTML.

Cliques. Antes do envio, o Emailit reescreve todos os links http e https das partes HTML e de texto simples para https://go.acme.com/<token>. Quando alguém clica, o Emailit registra o clique e redireciona imediatamente para a URL original. Ele não altera os links mailto: e tel:, os links relativos nem os links para os domínios do próprio Emailit. Se a mensagem tiver HTML, mas não tiver uma parte em texto simples, o Emailit gera uma a partir do HTML ao adicionar o rastreamento de cliques.

O Emailit usa a palavra loaded (carregado) para as aberturas, porque só consegue ver que a imagem foi carregada, não que uma pessoa leu o e-mail.

Precisão e privacidade

Trate os dados de aberturas e cliques como um sinal, não como uma contagem exata. O Emailit registra todas as requisições que chegam ao seu domínio de rastreamento e não filtra o tráfego automatizado.

• O Apple Mail Privacy Protection baixa as imagens, incluindo o pixel, pelos servidores proxy da Apple assim que o e-mail chega. Essas mensagens aparecem como carregadas mesmo que ninguém as tenha aberto, e o endereço IP é da Apple.
• Proxies de imagens, como o do Gmail, buscam e guardam em cache as imagens em nome do destinatário. O endereço IP e o user agent são do proxy, e as aberturas repetidas podem não chegar ao Emailit.
• Imagens bloqueadas fazem com que nenhuma abertura seja registrada, mesmo quando o destinatário lê o e-mail.
• Scanners de segurança de sistemas de e-mail corporativos seguem os links para verificá-los antes de o destinatário ver a mensagem. Eles aparecem como cliques, muitas vezes poucos segundos após a entrega.

Os cliques são um sinal de engajamento mais confiável que as aberturas. Para decisões de entregabilidade, observe as tendências em muitas mensagens em vez de eventos isolados.

O rastreamento registra o endereço IP e o user agent de cada abertura e clique. Em muitas regiões, a legislação de privacidade exige que você informe os destinatários sobre o rastreamento, por exemplo na sua política de privacidade, e algumas exigem consentimento. Se você não precisa dos dados, deixe o rastreamento desativado.

Ativar o rastreamento

Padrões do domínio

Cada domínio tem duas opções no card Tracking da página dele em Email API›Domains: Track loads e Track clicks. Elas vêm desativadas nos domínios novos e ficam bloqueadas até o CNAME de rastreamento mostrar OK.

As opções definem o padrão de todos os e-mails enviados do domínio pela API e por SMTP. No SMTP, os padrões do domínio são a única forma de controlar o rastreamento.

Pela API, chame Atualizar um domínio com track_loads e track_clicks. Ativar qualquer um dos dois antes de o CNAME ser verificado retorna 422.

Substituição por e-mail

O campo tracking de Enviar um e-mail substitui os padrões do domínio naquela mensagem:

Na forma de objeto, uma chave omitida conta como desativada. O padrão do domínio não a preenche.

curl https://api.emailit.com/v2/emails \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your receipt",
    "html": "<p>Thanks for your order.</p>",
    "tracking": { "loads": false, "clicks": true }
  }'

Se o CNAME de rastreamento do domínio não estiver verificado, o Emailit desativa o rastreamento da mensagem em vez de rejeitá-la. O objeto tracking da resposta mostra o que foi realmente aplicado.

Os e-mails de campanha sempre pedem o rastreamento de aberturas e cliques, então são rastreados sempre que o CNAME de rastreamento do domínio de envio está verificado. Os envios de teste de uma campanha não são rastreados.

Eventos

Cada abertura e cada clique geram um evento, não apenas o primeiro. O status do e-mail passa para loaded depois da primeira abertura e para clicked depois do primeiro clique.

Os dois payloads incluem o endereço IP e o user agent da requisição, o e-mail a que pertencem e o contato correspondente, se existir. email.clicked também inclui o link. Este é o data.object de um evento email.clicked:

{
  "id": "click_7Tn4Lp9Kd2Rv",
  "object": "click",
  "email_id": "em_5Vb2Nq8Xc1Jm",
  "email": {
    "id": "em_5Vb2Nq8Xc1Jm",
    "rcpt_to": "ada@example.com",
    "mail_from": "hello@acme.com",
    "subject": "Your receipt",
    "created_at": "2026-10-01T09:12:44Z",
    "campaign": null,
    "meta": { "order_id": "1042" }
  },
  "link": {
    "id": "link_9Wd3Ks6Mf4Ht",
    "url": "https://acme.com/orders/1042"
  },
  "contact": { "id": "con_8Ry5Bv2Lq7Np", "email": "ada@example.com" },
  "ip_address": "203.0.113.24",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_5) AppleWebKit/605.1.15",
  "created_at": "2026-10-01T09:15:02Z"
}

email.loaded tem o mesmo formato, com "object": "load", um ID que começa com load_ e sem link. Consulte Requisições de webhook para o formato completo da requisição.

Onde ver os dados de rastreamento

• Detalhes do e-mail. As abas Loads e Clicks na página de um e-mail listam cada abertura e cada clique com o horário, o endereço IP e, nos cliques, a URL. Consulte Detalhes do e-mail.
• Análises. Os widgets Loads e Clicks mostram o engajamento ao longo do tempo em gráficos. Consulte Análises.
• Relatórios de campanha. Carregamentos, cliques e taxa de cliques por campanha, com os cliques por link. Consulte Relatórios de campanha.
• Eventos e webhooks. Cada evento email.loaded e email.clicked aparece em Email API›Events e é enviado aos webhooks inscritos nele.

Próximos passos