> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Rastreamento de emails

> Registre quando os contatos abrem os seus emails e clicam nos links, e deixe cada contato aceitar ou recusar esse rastreamento.

## Visão geral

O Notifuse pode registrar duas coisas sobre os emails que envia:

- **Aberturas**: uma imagem invisível (um pixel de rastreamento) é adicionada ao email e registra quando ele é aberto.
- **Cliques**: os links passam por um redirecionamento que registra cada clique antes de levar o contato à página.

Cada um é ativado separadamente nas configurações do workspace, e cada contato pode aceitar ou recusar cada um deles. Os links mantêm os seus [parâmetros UTM](https://www.notifuse.com/pt/docs/features/broadcast-campaigns.md#utm-tracking) qualquer que seja a escolha de rastreamento.

## Configurações do workspace

Em **Configurações → Geral**, no painel **Rastreamento de e-mails**:

- **Aberturas** e **Cliques** ativam ou desativam cada tipo de rastreamento para o workspace inteiro. Quando um deles está desativado, nenhum email o traz, seja qual for a escolha dos contatos.
- **Contatos sem consentimento registrado** define o que acontece com um contato que nunca fez uma escolha: **Rastrear** (o padrão) ou **Não rastrear**.

A escolha do próprio contato sempre prevalece sobre essa configuração. Algumas autoridades de proteção de dados, como o Garante italiano e a CNIL francesa, entendem que o rastreamento de aberturas e cliques exige consentimento. Se for o seu caso, escolha **Não rastrear**: assim, só os contatos que aceitaram são rastreados.

## A escolha do contato

Cada contato tem quatro campos:

| Campo                         | Descrição                                                                                                       |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `tracking_opens_consent`      | `granted`, `denied` ou `null` quando desconhecido                                                               |
| `tracking_clicks_consent`     | `granted`, `denied` ou `null` quando desconhecido                                                               |
| `tracking_consent_updated_at` | Quando uma escolha mudou pela última vez. Definido pelo Notifuse quando um valor muda, a menos que você o envie |
| `tracking_consent_source`     | De onde veio a mudança: `api`, `console`, `import`, `notification_center`, `email_link` ou `subscribe_form`     |

Um email para um contato tem as aberturas rastreadas quando o workspace rastreia aberturas e a escolha do contato permite: `granted`, ou desconhecida com **Rastrear** selecionado. Os cliques seguem a mesma regra.

A escolha pode ser definida:

- **Pela API**: `contacts.upsert`, `contacts.import`, o `contact` da API transacional e o endpoint de inscrição. Sem um `tracking_consent_source`, uma mudança feita com uma chave API registra `api` e uma importação registra `import`; um formulário de inscrição enviado sem chave API sempre registra `subscribe_form`.
- **No console**: na página do contato, ao criar ou editar um contato, e nas importações CSV (colunas mapeadas para _Consentimento ao rastreamento de aberturas_ e _Consentimento ao rastreamento de cliques_, valores `granted` ou `denied`).
- **Pelo contato**, na [central de notificações](https://www.notifuse.com/pt/docs/features/notification-center.md#email-tracking).

Envie `null` para voltar uma escolha a desconhecida. Uma solicitação que omite os campos mantém a escolha registrada.

### Usar a escolha

- **Lista de contatos**: filtre por cada escolha, `unknown` incluído, e mostre uma coluna _Consentimento ao rastreamento_. As exportações CSV incluem os quatro campos.
- **Segmentos**: os quatro campos são campos do contato; use _não está definido_ para uma escolha desconhecida.
- **Automacoes**: um gatilho _contato atualizado_ pode ser limitado a uma mudança de qualquer uma das duas escolhas.
- **Webhooks**: os payloads de contato trazem os quatro campos, e cada mudança é registrada na linha do tempo do contato.

## Quando um contato muda de ideia

A escolha é aplicada quando um email é enviado e verificada de novo quando chega uma abertura ou um clique. Se um contato recusa o rastreamento depois do envio de um email, a abertura ou o clique dele nesse email não é registrado; o link continua levando à página.

## Cliques em links

Cada email registra quais dos seus links foram clicados. Na primeira vez que um contato clica em cada link de um email, a
linha do tempo do contato recebe uma entrada `email.link_clicked` com o endereço do link, ao lado da entrada `email.clicked` do
primeiro clique no email. Essa entrada pode [iniciar uma automação](https://www.notifuse.com/pt/docs/features/automations.md#link-click-triggers) e atualiza
na hora os segmentos que filtram por um link clicado. Ela não conta no uso mensal de eventos.

Nenhuma entrada é gravada para:

- um clique num link já clicado naquele email (um link clicado antes da atualização para a 44.0 recebe a sua entrada no
  próximo clique);
- um link que o Notifuse não consegue verificar: links em emails enviados antes da versão 42.2 e links cuja assinatura não confere;
- um link cujo endereço tenha mais de 2.048 caracteres, ou um link além dos 50 primeiros links diferentes clicados num
  email;
- links que não são `http` nem `https`, como `mailto:` e `tel:`, e links para a sua própria instância do Notifuse, como
  os links de cancelamento de inscrição, da central de notificações e da versão web. O Notifuse os reconhece pelo seu endpoint da API, pelo
  domínio personalizado do workspace ou pelo host a que o clique chegou (inclusive um encaminhado por um proxy reverso), em qualquer porta.
  Isso também vale para links para o seu blog quando ele é servido no seu domínio personalizado, e para links para outro site servido
  no mesmo nome de host da sua instância do Notifuse, mesmo em outra porta.

As aberturas e os cliques num email cujo contato foi excluído não são registrados; o link continua levando o leitor à página.

## Estatísticas

As taxas de abertura e de cliques são calculadas sobre os emails rastreados, não sobre todos os emails enviados. Quando parte dos emails não foi rastreada, a dica da taxa diz quantos foram (_de 1.200 rastreados_); uma taxa sem nenhum email rastreado mostra `-`. Isso vale para as estatísticas dos broadcasts, os resultados dos testes A/B, as taxas de cliques por link e o dashboard de análise.

Os emails enviados antes da versão 43 contam como rastreados, então as taxas deles não mudam.

## Testes A/B

O vencedor automático é escolhido pela taxa de abertura ou de cliques entre os destinatários rastreados de cada variação. Uma variação sem nenhum destinatário rastreado não pode vencer; quando nenhuma variação tem destinatários rastreados, você mesmo escolhe o vencedor.

Quando o workspace não rastreia os contatos sem consentimento registrado, só os contatos que aceitaram contam nos resultados. A tabela de variações mostra um aviso em laranja quando menos da metade dos destinatários de uma variação foi rastreada, e a dica de cada taxa indica o número de destinatários rastreados.

## Desativar o rastreamento em um email

- **Broadcasts**: marque **Não rastrear aberturas e cliques neste broadcast** na etapa _Web Analytics_ (`tracking_mode: "no_tracking"` na API). Os parâmetros UTM são mantidos, e o vencedor de um teste A/B passa a ser escolhido manualmente.
- **Notificações transacionais**: escolha **Sem rastreamento de aberturas ou cliques, manter UTM** (`no_tracking`) ou **Desativado para esta notificação** (`disabled`), que também deixa os links intactos, sem parâmetros UTM, para links que não podem mudar, como os links de login.

## Links nos templates

Duas variáveis permitem que os contatos façam a sua escolha a partir de um email:

- `{{ tracking_preferences_url }}` abre a janela de rastreamento de emails da central de notificações.
- `{{ tracking_optout_url }}` pede ao contato que confirme e então recusa o rastreamento de aberturas e de cliques (origem `email_link`). Nada é registrado antes da confirmação do contato, porque os filtros de segurança de email abrem os links por conta própria.

```html
<a href="{{ tracking_preferences_url }}">Choose what we track</a>
```

O Notifuse nunca reescreve esses dois links para rastreamento.
