Guia prático
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.
- 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 emgo.acme.com.
Escolher o subdomínio de rastreamento
O nome de host de rastreamento é <tracking subdomain>.<sending domain>. Para usar algo diferente de go:
Na página do domínio em Email APIDomains, encontre o card Custom Subdomains. Digite um prefixo em Tracking Subdomain, por exemplo links, e selecione Save.
Chame Atualizar um domínio com tracking_key. Você também pode passá-lo ao criar o domínio.
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
-
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.comPara
acme.com, o resultado é:go.acme.com. CNAME go.emailitmail.com.Se você envia de um subdomínio como
mail.acme.com, o host égo.mailna zonaacme.com. -
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 cria o registro como DNS only para você.
-
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. -
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 com
"track_loads": truee"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.
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
-
Envie um e-mail de teste do domínio com pelo menos um link, por exemplo com Compose na página Emails.
-
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. -
Abra e clique. Abra o e-mail e clique no link. A página do e-mail em Email APIEmails lista a abertura em Loads e o clique em Clicks, e o status muda para
loadede depois paraclicked.
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. |