Documentação · Prynt Reveal

Links de email

Reconheça as pessoas para quem você já envia emails quando chegam ao seu site por um clique, em qualquer dispositivo e sem um cookie de uma visita anterior. Você assina um token curto para cada um dos seus contatos inscritos e o coloca nos links dos seus emails; o Reveal o verifica no servidor.

Como funciona

  1. Seus contatos chegam ao índice de contatos do Reveal: conecte HubSpot ou Mailchimp (sincronizados), Customer.io (consultado no clique) ou envie um CSV. O Reveal guarda apenas um hash de cada email com sal própria da sua conta; contatos descadastrados ou excluídos viram supressões.
  2. Você assina um pid por destinatário e campanha com POST /v1/reveal/links/sign a partir do seu backend, ou em lote pelo console.
  3. Você guarda o pid numa propriedade do contato (por exemplo prynt_pid) e adiciona ?pid= com essa merge tag aos links que apontam para o seu site.
  4. Quando o destinatário clica e há consentimento no seu site, o SDK lê pid, remove-o da URL que reporta e o envia com o beacon. O Reveal confere a assinatura, a validade e se o contato continua inscrito, e vincula a visita a esse contato como identificação first-party (first_party_link, referência de consentimento link:<campaign>).

Sem consentimento, com Global Privacy Control ou após um opt-out, o SDK nunca lê o token e o Reveal nunca o usa. O token nunca contém o endereço de email.

Assinar tokens no seu backend

curl https://api.pryntid.com/v1/reveal/links/sign \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"contactRef": "12345", "source": "hubspot", "campaign": "nov-newsletter", "ttlDays": 30}'

# 200 → {"pid": "djEuMTIu…", "expiresAt": "2026-12-03T10:00:00Z"}
CampoSignificado
contactRef + sourceO id do contato na origem: id de registro do HubSpot (hubspot), unique email id do Mailchimp (mailchimp), id do Customer.io (customerio), o contactRef do seu CSV (csv)
emailNo lugar de contactRef: o melhor contato inscrito com esse endereço
consentRefSó com email, para um contato que o Reveal ainda não conhece (uma lista do Klaviyo, por exemplo): sua referência do opt-in. O contato é registrado com origem link
campaign1–40 caracteres A-Z a-z 0-9 _ -, padrão email; registrado como referência de consentimento link:<campaign>
ttlDaysDias em que o link funciona: padrão 30, máximo 90. Um email encaminhado deixa de funcionar quando o token expira. Links de compartilhamento criados no console (visão somente leitura da conta) duram 7 dias por padrão e 30 no máximo

Erros: 422 contact_not_eligible se o contato não existe, se descadastrou, fez opt-out ou foi excluído; 401 sem uma chave secreta válida; 429 acima de 600 requisições por minuto por chave. O endpoint exige sua chave secreta: chame-o do seu servidor, nunca do navegador.

Assinatura em lote pelo console

People → Contacts → Bulk sign: envie um CSV com uma coluna contactRef (e source) ou email, escolha a campanha e a validade, baixe o arquivo com a coluna pid e importe-o na sua ferramenta de email como propriedade do contato. As linhas que não podem ser assinadas voltam com o motivo.

Merge tags

FerramentaReferência do contato para assinarLink decorado
HubSpot{{contact.hs_object_id}} · origem hubspothttps://example.com/pricing?pid={{contact.prynt_pid}}
Klaviyoseu próprio id, ou o email com consentRefhttps://example.com/pricing?pid={{ person|lookup:'prynt_pid' }}
Mailchimp*|UNIQID|* · origem mailchimphttps://example.com/pricing?pid=*|PRYNTPID|*
Customer.io{{customer.id}} · origem customeriohttps://example.com/pricing?pid={{customer.prynt_pid}}

Mailchimp e Customer.io também funcionam sem assinatura: com o rastreamento de cliques ativo eles adicionam mc_eid / _cio_id aos seus links. Conecte a integração e o Reveal consulta o assinante com a sua própria chave de API (só membros inscritos, cache de 24 horas; a chave é guardada criptografada).

Opções do SDK

PryntReveal.reveal({
  publicKey: 'pk_live_…',
  pid: { param: 'pid', store: true },   // param padrão 'pid'; store guarda em localStorage 'prynt_pid'
  // pid: false                          // desativa o reconhecimento por links de email
});

Com store: true as visitas seguintes do mesmo navegador são reconhecidas sem o parâmetro; um opt-out (Global Privacy Control, setConsent(false), uma recusa no seu gerenciador de consentimento) apaga o token guardado. Um valor de pid que não é um token da Prynt, como um id de produto, não é alterado.

Emails encaminhados

O mesmo token usado em mais de 3 dispositivos é tratado como link encaminhado: a visita continua vinculada, com confiança 0,6 e o motivo shared_link, para que você possa deixá-la fora dos alertas que exigem uma identificação forte. Os tokens estão ligados a um contato da sua conta; um token de outra conta, modificado ou expirado é ignorado.

Privacidade

  • Apenas os seus próprios contatos, de ferramentas que você controla, com o consentimento deles. O Reveal nunca adiciona pessoas de outros clientes nem de dados de terceiros.
  • O Reveal guarda um hash de cada email com sal própria da sua conta, nunca o endereço, e nunca o coloca num token.
  • Contatos descadastrados, limpos ou excluídos viram supressões. Um pedido de exclusão remove a pessoa, marca o contato como excluído para sempre e, no HubSpot, anonimiza as notas da Prynt e marca prynt_opted_out nos contatos que a Prynt criou.
  • Conte aos seus assinantes o que você faz: veja Consentimento para os modos de consentimento e o opt-out.

Próximo: Limites

Última atualização 2026-11-03 · Limites · Exclusão do visitante