---
title: Rastreamento
description: Conte aberturas e cliques, adicione parâmetros UTM e sirva links rastreados do seu próprio domínio.
ai:
  exclude: true
---

O BillionSend pode registrar quando um destinatário abre um e-mail ou clica em um link. O rastreamento é definido por [domínio](/docs/pt-br/concepts/domains) e vem desligado: com ele desligado, seus links e seu HTML saem intactos.

## Ligar

No painel, abra o domínio e vá à aba **Links**:

- **Rastrear cliques** reescreve cada link para passar pelo host de rastreamento, que registra o clique e leva o destinatário à sua URL original. O evento é `email.clicked`.
- **Rastrear aberturas** adiciona ao HTML uma imagem transparente de 1×1. Quando ela carrega, o evento é `email.opened`.
- **Reescrever links na parte de texto simples** rastreia também os links da versão em texto simples. Exige o rastreamento de cliques.

Pela API, use `click_tracking` e `open_tracking` no domínio:

```bash
curl -X PATCH https://api.billionsend.com/domains/$DOMAIN_ID \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "click_tracking": true, "open_tracking": true }'
```

Observações:

- Só links `http` e `https` são rastreados. Links `mailto:` e `tel:`, e o link de descadastro, ficam como estão.
- Cada evento aparece na linha do tempo do e-mail e pode ser enviado a um [webhook](/docs/pt-br/concepts/webhooks).
- E-mails enviados de uma [caixa de entrada](/docs/pt-br/inboxes) de pessoa nunca são rastreados.

## Parâmetros UTM

Defina `utm_source`, `utm_medium` e `utm_campaign` na aba **Links**, e o BillionSend os adiciona a todo link rastreado que ainda não os tenha. Em um valor, `{{broadcast_name}}` representa o nome da transmissão. Em um e-mail transacional, que não tem transmissão, um valor que o usa é deixado de fora. Os parâmetros UTM valem para links rastreados, então o rastreamento de cliques precisa estar ligado.

## Quão confiáveis são as aberturas

Uma abertura é um indício, não uma contagem exata.

- **Pré-carregamentos não são aberturas.** O Apple Mail baixa todas as imagens em segundo plano, o Gmail pode carregar imagens com a caixa de entrada aberta, e scanners de segurança buscam imagens segundos depois da entrega. Isso é registrado como **pré-carregado**. Aparece na linha do tempo e em uma linha própria abaixo da taxa de abertura, mas nunca conta como abertura e nunca envia `email.opened`. Um webhook pode optar por receber `email.prefetched`.
- **Um clique conta como abertura.** Se alguém clica em um link, essa pessoa viu o e-mail. Quando chega um clique sem abertura ainda, o BillionSend registra a abertura também. Para destinatários no Apple Mail, essa costuma ser a única abertura que você verá.
- **Cliques de máquina não são cliques.** Scanners seguem todos os links de uma mensagem logo após a entrega. O BillionSend os reconhece e não os conta.
- **As aberturas são subcontadas** quando o destinatário bloqueia imagens, quando o e-mail não tem parte HTML, ou quando o Gmail corta uma mensagem acima de cerca de 102 KB.

Os cliques são o sinal mais confiável. Para e-mails puramente transacionais, como recibos e redefinições de senha, considere deixar o rastreamento de abertura desligado.

## Host de rastreamento

Os links rastreados e a imagem de abertura são servidos por um host de rastreamento:

- **Host compartilhado.** O padrão é `t.billiondns.com`, compartilhado por todas as equipes. Está disponível em todos os planos e é a única opção no Free.
- **Seu próprio subdomínio.** Sirva de `links.example.com` ou de qualquer nome do seu domínio. Os links combinam com o seu domínio de envio, o que ajuda na confiança. Exige um plano pago.

### Configurar seu próprio subdomínio

1. Na aba **Links** do domínio, digite um rótulo como `links`. Pela API, envie `tracking_subdomain` em `POST /domains` ou `PATCH /domains/{id}`. Uma string vazia o remove.
2. Adicione o CNAME que a aba **DNS** mostra: `links.example.com` apontando para `cname.billiondns.com`. No Cloudflare, deixe como **somente DNS** (nuvem cinza); caso contrário ele não pode ser verificado.
3. Espere alguns minutos. O certificado HTTPS é emitido automaticamente assim que o CNAME resolve. Se o seu domínio tem registros CAA, eles precisam permitir Let's Encrypt e Google Trust Services.

O subdomínio passa de **Pendente** a **Ativo** (`tracking_status` no domínio). Até lá, os links usam o host compartilhado, e o domínio aparece como **Parcial**: verificado para envio, host próprio ainda não ativo. Se não ativar em 72 horas, aparece como **Falhou** com o motivo em `tracking_error`. Corrija o CNAME e clique em **Tentar de novo**, ou envie o mesmo rótulo de novo.

Bom saber:

- O rótulo não pode ser igual ao subdomínio de return-path do domínio.
- Bloqueadores de anúncios bloqueiam nomes de host de rastreamento. Use um rótulo diferente para o subdomínio de [descadastro](/docs/pt-br/concepts/unsubscribes), para que o link de descadastro não seja bloqueado junto. O mesmo rótulo também funciona, e então um só CNAME serve aos dois.
- Seu host serve só os links do seu domínio. Se você trocar o subdomínio ou excluir o domínio, os links já enviados pelo host antigo deixam de funcionar.
- Equipes Free não podem definir um novo subdomínio próprio: a resposta é `403 plan_limit_reached`. Um subdomínio que você já definiu continua funcionando depois de um downgrade.

E-mails no seu próprio host de rastreamento também pontuam melhor nos [Insights de entregabilidade](/docs/pt-br/concepts/deliverability-insights).

## Planos

| | Free | Starter, Pro e Scale |
| --- | --- | --- |
| Rastreamento de abertura e de cliques | Sim | Sim |
| Parâmetros UTM | Sim | Sim |
| Host de rastreamento | Só o host compartilhado | Host compartilhado ou seu próprio subdomínio |
