# Configurar um domínio de rastreamento personalizado

> Publique o CNAME de rastreamento do seu domínio de envio, verifique-o e ative o rastreamento de aberturas e cliques para que os links e os pixels usem o seu próprio nome de host via HTTPS.

No Emailit, o rastreamento de aberturas e cliques sempre funciona em um nome de host no seu próprio domínio, como `go.acme.com`. Este guia mostra como publicar o registro CNAME desse nome de host, verificá-lo e ativar o rastreamento.

## Antes de começar

- Adicione e verifique o domínio de envio. Consulte [Adicionar um domínio](/pt/docs/domains/add-a-domain/).
- Confirme que você pode editar os registros DNS do domínio.
- Escolha um nome de host que não seja usado para mais nada. O padrão é `go`, que resulta em `go.acme.com`.

## Escolher o subdomínio de rastreamento

O nome de host de rastreamento é `<tracking subdomain>.<sending domain>`. Para usar algo diferente de `go`:

**Painel**

  Na página do domínio em **Email API → Domains**, encontre o card **Custom Subdomains**. Digite um prefixo em **Tracking Subdomain**, por exemplo `links`, e selecione **Save**.

**API**

  Chame [Atualizar um domínio](/pt/docs/api-reference/domains/update/) com `tracking_key`. Você também pode passá-lo ao [criar o domínio](/pt/docs/api-reference/domains/create/).

```bash
curl https://api.emailit.com/v2/domains/acme.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tracking_key": "links" }'
```

O prefixo pode conter letras minúsculas, dígitos e hífens, com até 63 caracteres, e precisa começar e terminar com uma letra ou um dígito. Alterá-lo redefine o registro de rastreamento para **Not checked**, então publique um CNAME para o novo nome de host e verifique o DNS de novo.

## Publicar e verificar o CNAME

1. **Adicione o registro CNAME.** No seu provedor de DNS, crie este registro:

   | Tipo | Host | Destino |
   | --- | --- | --- |
   | CNAME | `go` (ou o seu subdomínio de rastreamento) | `go.emailitmail.com` |

   Para `acme.com`, o resultado é:

```txt
go.acme.com.   CNAME   go.emailitmail.com.
```

   Se você envia de um subdomínio como `mail.acme.com`, o host é `go.mail` na zona `acme.com`.

2. **Desative o proxy no Cloudflare.** Se o seu DNS estiver no Cloudflare, defina o status de proxy do registro como **DNS only** (nuvem cinza). Um registro com proxy retorna os endereços IP do Cloudflare em vez do CNAME, e o rastreamento não consegue verificar nem atender às requisições. A [configuração com o Cloudflare](/pt/docs/domains/cloudflare/) cria o registro como DNS only para você.

3. **Verifique o DNS.** Na página do domínio, selecione **Check DNS**. O selo de status no card **Tracking** muda para **OK** quando o CNAME aponta para `go.emailitmail.com`.

4. **Ative o rastreamento.** No card **Tracking**, ative **Track loads**, **Track clicks** ou os dois. As opções ficam bloqueadas até o CNAME mostrar **OK**.

   Pela API, chame [Atualizar um domínio](/pt/docs/api-reference/domains/update/) com `"track_loads": true` e `"track_clicks": true`.

Essas opções definem o padrão dos e-mails do domínio. Você pode substituí-las em um único e-mail com o campo `tracking` ao enviar pela API. Consulte [Rastreamento de aberturas e cliques](/pt/docs/tracking/#turn-tracking-on).

## HTTPS

Todos os links e pixels de rastreamento usam `https://`. O Emailit emite e renova automaticamente o certificado do seu nome de host de rastreamento na primeira vez que recebe uma requisição para ele. Você não precisa enviar um certificado nem mudar mais nada.

## Confirmar que funcionou

1. **Envie um e-mail de teste** do domínio com pelo menos um link, por exemplo com **Compose** na página **Emails**.

2. **Confira os links.** Na mensagem recebida, passe o cursor sobre um link. Ele deve começar com `https://go.acme.com/`, e não com a sua URL original.

3. **Abra e clique.** Abra o e-mail e clique no link. A página do e-mail em **Email API → Emails** lista a abertura em **Loads** e o clique em **Clicks**, e o status muda para `loaded` e depois para `clicked`.

## Solução de problemas

| Sintoma | Solução |
| --- | --- |
| O rastreamento mostra **Missing** | O CNAME não está publicado no host esperado. Confira com `dig +short CNAME go.acme.com @1.1.1.1`. Uma causa comum é digitar o nome completo quando o provedor espera só `go`. |
| O rastreamento mostra **Invalid** | O CNAME aponta para outro lugar ou o registro está com proxy no Cloudflare. Aponte-o para `go.emailitmail.com` e defina-o como **DNS only**. |
| **Track loads** e **Track clicks** estão acinzentados | O CNAME ainda não foi verificado. Selecione **Check DNS** depois de publicá-lo. |
| Os e-mails chegam com os links originais | O rastreamento está desativado no domínio, a mensagem foi enviada com `"tracking": false` ou o registro de rastreamento não estava **OK** na última verificação de DNS. O Emailit envia sem rastreamento em vez de falhar. |
| Os links mostram um aviso de certificado | O CNAME acabou de ser criado. Espere um minuto e tente de novo. Se persistir, confira se o registro não está com proxy. |
| Já existe um CNAME em `go` | Escolha outro subdomínio de rastreamento, como `links` ou `t`, e publique o CNAME nele. |

## Veja também

  - [Rastreamento de aberturas e cliques](/pt/docs/tracking/): Como o rastreamento funciona e qual é a precisão dele.
  - [Registros DNS](/pt/docs/domains/dns-records/): Todos os registros de um domínio de envio.

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