Tracking Preferences

Deixe os destinatários escolherem o que você rastreia

Uma página hospedada onde cada destinatário liga ou desliga o rastreamento de aberturas e cliques sem se descadastrar, em inglês, alemão, francês, italiano e espanhol. A escolha é aplicada a todo envio, e você pode lê-la e sincronizá-la pela API.

  • Página hospedada em 5 idiomas
  • Sem precisar se descadastrar
  • Aplicada em todo envio
  • Histórico de consentimento
  • Sync com cursor
POSThttps://g.sendcorex.com/v1/privacyprivacy:read

Como funciona

Uma página que você não precisa criar

Campanhas com tracking adicionam o link ao lado do seu link de descadastro, no seu estilo. Em emails da API e SMTP, coloque [tracking_preferences_url] onde quiser. Cada destinatário recebe o próprio link, a página usa seu logo e suas cores, abre no idioma do destinatário e também tem link na página de descadastro.

A recusa sempre vence

Quando um destinatário desliga o tracking, ele fica desligado em toda campanha e em todo email enviado com "unsubscribe": true, mesmo que a campanha ou o envio peça tracking. Sem pixel, sem links reescritos.

Para você sincronizar

Leia um destinatário ou 100 de uma vez, acompanhe cada mudança com um cursor, receba um webhook quando um destinatário mudar a preferência e registre consentimentos que você mesmo coletou.

Primeiros passos

Two steps and your recipients can manage their tracking.

  1. 1

    Adicione [tracking_preferences_url] aos seus emails

    Envie com "unsubscribe": true e coloque [tracking_preferences_url] ao lado do seu link de descadastro (aliases: [privacy_url], [preferences_url]). Nós o substituímos pelo link próprio do destinatário.

    Sem "unsubscribe": true o placeholder é removido do email e a API responde com um aviso. Campanhas não precisam de nada: o link é adicionado para você quando a campanha rastreia aberturas ou cliques.

  2. 2

    Crie uma API key com privacy:read

    No dashboard, abra Developers → API Keys e dê privacy:read a uma key. Adicione privacy:write se você também registra consentimento do seu lado.

  3. 3

    Mantenha seu CRM sincronizado

    Assine o webhook tracking_preferences_updated e consulte List Changes como rede de segurança.

A preferência

Todo comando retorna preferências neste formato.

{
  "email": "jane.doe@example.com",
  "track_opens": false,
  "track_clicks": true,
  "source": "page",
  "updated_at": "2026-10-24T07:20:12.031Z"
}
track_opens / track_clicks

true permitido, false recusado, null nunca escolheu. false sempre vence em campanhas e em envios com "unsubscribe": true.

source

page quando o destinatário mudou, api quando você mudou, dashboard quando seu time mudou.

updated_at

Quando a mudança foi feita. A lista completa de mudanças está em Get History.

Sua primeira requisição

As preferências de dois destinatários antes de um envio. Substitua SENDCOREX_API_KEY pela sua API key.

curl -X POST 'https://g.sendcorex.com/v1/privacy' \
  -H "Authorization: $SENDCOREX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "commands": [
    { "command": "get_many", "args": { "emails": ["jane.doe@example.com", "marc.dupont@example.fr"] } }
  ]
}'

Destinatários ausentes da resposta nunca escolheram nada: seu envio decide por eles. A mesma requisição em 8 linguagens está em Get Many.

Tarefas comuns

Países com opt-in

Onde o tracking precisa de consentimento antes, envie com tracking desligado e ligue só para os destinatários que permitiram.

Antes de enviar

Sincronize com o Salesforce

Grave cada mudança no registro do contato com um loop de cursor, e ignore as mudanças que você mesmo fez.

Sincronize com seu CRM

Registre o consentimento dos seus formulários

Um destinatário concordou no seu formulário de cadastro? Guarde aqui para que todo envio respeite isso.

Set Preferences

Comprove o consentimento em uma auditoria

Mostre cada mudança de um destinatário: o que escolheu, quando e quem mudou.

Get History

Referência completa

Tudo marcado como CMD é um comando enviado por POST /v1/privacy, até 20 por requisição.