Rastreamento de aberturas e cliques

O rastreamento é configurado por domínio e vem desativado por padrão.

Configuração	O que faz	Evento de webhook
`open_tracking`	Insere um pixel de rastreamento 1x1 no corpo HTML.	`email.opened`
`click_tracking`	Reescreve os links do corpo HTML para que os cliques sejam registrados antes do redirecionamento.	`email.clicked`

Node.js
cURL

import { SpacePost } from "@spacepost/node";

const spacepost = new SpacePost(process.env.SPACEPOST_API_KEY);

const { error } = await spacepost.domains.update({
  id: "0192e1c4-0000-7000-8000-000000000001",
  openTracking: true,
  clickTracking: true,
});
if (error) console.error(error);

curl -X PATCH https://api.spacepost.dev/domains/$DOMAIN_ID \
  -H "Authorization: Bearer $SPACEPOST_API_KEY" -H "Content-Type: application/json" \
  -d '{ "open_tracking": true, "click_tracking": true }'

A alteração vale para os e-mails enviados depois dela. Os dois campos são opcionais; envie apenas o que você quer alterar.

Considerações

As aberturas são aproximadas. O Mail Privacy Protection da Apple e alguns scanners de segurança carregam imagens automaticamente, inflando as aberturas. O Gmail armazena imagens em cache. Trate as aberturas como um sinal aproximado, nunca como prova de que uma pessoa leu o e-mail.
Os cliques são mais confiáveis, mas os scanners de segurança também podem clicar nos links antecipadamente.
Privacidade. O rastreamento registra o endereço IP e o user agent no payload do evento. Divulgue isso na sua política de privacidade e considere deixar o rastreamento de aberturas desativado em e-mails transacionais sensíveis (redefinição de senha, recibos).
As partes em texto simples nunca são rastreadas. O rastreamento afeta apenas o HTML.
Entregabilidade. A reescrita de links altera as URLs que os destinatários veem. Alguns filtros de spam não gostam disso em e-mails transacionais; se você notar uma queda na entregabilidade, desative o rastreamento de cliques nesse domínio e use um subdomínio separado para e-mails de marketing.

Um evento email.opened ou email.clicked define o last_event do e-mail, mas nunca o faz retroceder de um estado mais grave, como bounced.