Documentação · Prynt Reveal

CSP, cookies, armazenamento e o que é enviado

Revisores de segurança perguntam três coisas: com quais hosts o script fala, o que guarda no dispositivo e o que sai do navegador. Aqui estão as três, sem omissões.

Content-Security-Policy

O Reveal precisa de duas diretivas. O bundle é carregado de api.pryntid.com (o mesmo host para onde vão os eventos), então um host cobre ambas:

Content-Security-Policy:
  script-src  'self' https://api.pryntid.com;
  connect-src 'self' https://api.pryntid.com;

# Loading the bundle from npm's CDN instead of https://api.pryntid.com? Add that host to script-src too:
#   script-src 'self' https://cdn.jsdelivr.net;
# Self-hosted Prynt: replace https://api.pryntid.com with your own API host in both directives.

O snippet de uma linha inicia o Reveal a partir de um atributo onload inline. Políticas estritas sem 'unsafe-inline' precisam de um nonce na tag, ou de um segundo script seu que chame PryntReveal.reveal():

# The one-line snippet uses an inline onload="…" handler. If your policy has no 'unsafe-inline'
# (or uses nonces/hashes), either give the script tag your nonce:
<script nonce="{{ nonce }}" src="https://api.pryntid.com/cdn/prynt-reveal.umd.js" async onload="PryntReveal.reveal({publicKey:'pk_live_YOUR_PUBLIC_KEY'})"></script>

# or drop onload and start Reveal from a nonce'd/hashed script of your own:
<script src="https://api.pryntid.com/cdn/prynt-reveal.umd.js" defer></script>
<script nonce="{{ nonce }}">window.addEventListener('DOMContentLoaded', () => PryntReveal.reveal({ publicKey: 'pk_live_YOUR_PUBLIC_KEY' }));</script>

Nenhum outro host é contatado: sem grafos de identidade de terceiros, sem serviços de geolocalização, sem parceiros de anúncios. Os eventos usam fetch com keepalive e navigator.sendBeacon ao sair, credentials: 'omit', Content-Type: text/plain (uma requisição CORS simples, sem preflight). Um connect-src bloqueado aparece como cspBlocked: true em diagnose() e no painel ?prynt_debug=1.

Cookies: nenhum

PryntReveal.reveal() **não grava cookies**. Não há identificador entre sites, nem cookies de terceiros, nem sincronização com grafos de identidade alheios.

Se você também usa o agente de inteligência de dispositivo (Prynt.load() + identify(), um produto distinto no mesmo bundle), esse agente persiste seu próprio id de visitante de forma redundante num cookie de primeira parte __prynt_id (Max-Age 1 ano, SameSite=Lax, Secure em https), na chave __prynt_id do localStorage e num banco IndexedDB __prynt. O Reveal só lê esse id quando Prynt.load() rodou na página e há consentimento.

localStorage: uma chave

ChaveValorFinalidadeDuração
prynt_rvs{"id":"rvs_…","last":<ms>}O id de sessão (24 caracteres aleatórios) e a hora do último evento, para agrupar as páginas de uma visitaRenovado após 30 minutos sem eventos; a chave permanece até o navegador limpar os dados do site

Quando o armazenamento está bloqueado (modo privado do Safari, navegador restrito) a sessão vive em memória durante a vida da página; diagnose().storage então diz blocked. Nada mais é gravado: nem impressão digital, nem e-mail, nem histórico do visitante.

O que é enviado

Cada lote é um POST para /v1/reveal/collect com no máximo 50 eventos, enviado a cada 2 segundos ou ao acumular 10 eventos, e por beacon ao sair da página:

POST https://api.pryntid.com/v1/reveal/collect      Content-Type: text/plain (JSON)
{
  "publicKey": "pk_live_…", "website": "example.com",
  "sessionId": "rvs_…", "visitorId": null,            // visitorId only with the full agent (Prynt.load()) AND consent
  "consent": true, "consentSource": "cookiebot",       // config | override | gpc | cookieyes | cookiebot | onetrust | klaro | tcf | gcm | default
  "events": [
    { "eventId": "evt_…", "kind": "pageview", "url": "https://example.com/pricing?utm_source=linkedin",
      "path": "/pricing", "title": "Pricing", "ts": "2026-11-03T10:00:00.000Z",
      "referrer": "https://www.google.com/", "utm": { "source": "linkedin", "gclid": true } },
    { "eventId": "evt_…", "kind": "engagement", "durationMs": 15000, "scrollPct": 80, … },
    { "eventId": "evt_…", "kind": "form", "identity": { "email": "[email protected]", "formId": "demo" }, "shielded": true, … }
  ]
}
CampoCom consentimentoSem consentimento
url, path, titleURL completa (sem fragmento, sem tokens de clique de ESP)Apenas origem + caminho — sem query string
referrerdocument.referrer, depois a página anterior em navegações SPANão enviado
utmValores utm_*; gclid/fbclid como booleanos (só presença, nunca o valor)Não enviado
engagementMilissegundos ativos (visíveis) desde o último evento de engagement e profundidade máxima de rolagemNão enviado
custom (track)Nome + props planas (máx. 20 chaves, 200 caracteres; chaves que parecem dados pessoais são descartadas)Retido em memória, enviado só se o consentimento chegar
identity (formulários / identify)E-mail e nome do seu próprio formulário ou login; formIdRetido (ou descartado em formulários) salvo requireConsent:false
props.espToken{provider, token} de mc_eid, _hsenc, _kx, vgo_ee, _cio_id, mkt_tok… — o sinal «veio da sua newsletter»Não enviado
visitorIdO id de inteligência de dispositivo quando Prynt.load() rodou na páginanull
consentSourceDe onde veio a decisão de consentimento (ver Consentimento)Igual
botHinttrue quando o user agent bate com uma lista compacta de crawlers/headless (o servidor decide)Igual

No servidor o endereço IP é usado para a busca da empresa e depois minimizado e guardado como hash com sal — IPs em claro nunca são armazenados nas tabelas do Reveal. Valores de formulário são lidos só no envio, só do campo de e-mail e do campo chamado name; senhas, campos ocultos e qualquer outro campo nunca são lidos.

Auto-hospedado

Com seu próprio servidor Prynt, substitua api.pryntid.com pelo seu host de API em ambas as diretivas e passe endpoint: 'https://seu-servidor-prynt' para PryntReveal.reveal() (o snippet do console já faz isso).

Próximo: Consentimento

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