# Rastreamento de aberturas e cliques

> Como o Emailit rastreia aberturas com um pixel e cliques com links reescritos no seu próprio domínio, qual é a precisão dos dados e como ativar ou desativar o rastreamento.

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](/pt/docs/tracking/custom-tracking-domain/) 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](/pt/docs/api-reference/domains/update/) 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](/pt/docs/api-reference/emails/send/) substitui os padrões do domínio naquela mensagem:

| Valor | Aberturas | Cliques |
| --- | --- | --- |
| Omitido | Padrão do domínio | Padrão do domínio |
| `true` | Ativado | Ativado |
| `false` | Desativado | Desativado |
| `{ "loads": true, "clicks": false }` | Ativado | Desativado |
| `{ "clicks": true }` | Desativado | Ativado |

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

```bash
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.

| Evento | Quando é disparado |
| --- | --- |
| [`email.loaded`](/pt/docs/webhooks/events/email/loaded/) | O pixel de rastreamento foi carregado. |
| [`email.clicked`](/pt/docs/webhooks/events/email/clicked/) | Um link rastreado foi clicado. |

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`:

```json
{
  "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](/pt/docs/webhooks/webhook-requests/) 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](/pt/docs/logs/email-details/).
- **Análises.** Os widgets **Loads** e **Clicks** mostram o engajamento ao longo do tempo em gráficos. Consulte [Análises](/pt/docs/analytics/).
- **Relatórios de campanha.** Carregamentos, cliques e taxa de cliques por campanha, com os cliques por link. Consulte [Relatórios de campanha](/pt/docs/campaigns/reports/).
- **Eventos e webhooks.** Cada evento `email.loaded` e `email.clicked` aparece em **Email API → Events** e é enviado aos webhooks inscritos nele.

## Próximos passos

  - [Domínio de rastreamento personalizado](/pt/docs/tracking/custom-tracking-domain/): Publique e verifique o CNAME de rastreamento.
  - [Configurar webhooks](/pt/docs/webhooks/set-up/): Receba os eventos email.loaded e email.clicked.

---
Fonte: https://emailit.com/pt/docs/tracking/