Cómo funciona
- Tus contactos llegan al índice de contactos de Reveal: conecta HubSpot o Mailchimp (sincronizados), Customer.io (consultado en el clic) o sube un CSV. Reveal guarda solo un hash de cada email con sal propia de tu cuenta; los contactos dados de baja o borrados pasan a ser supresiones.
- Firmas un
pidpor destinatario y campaña conPOST /v1/reveal/links/signdesde tu backend, o en bloque desde la consola. - Guardas el
piden una propiedad del contacto (por ejemploprynt_pid) y añades?pid=con esa merge tag a los enlaces que apuntan a tu web. - Cuando el destinatario hace clic y hay consentimiento en tu web, el SDK lee
pid, lo quita de la URL que reporta y lo envía con el beacon. Reveal comprueba la firma, la caducidad y que el contacto sigue suscrito, y vincula la visita a ese contacto como identificación first-party (first_party_link, referencia de consentimientolink:<campaign>).
Sin consentimiento, con Global Privacy Control o tras un opt-out, el SDK nunca lee el token y Reveal nunca lo usa. El token nunca contiene la dirección de email.
Firmar tokens desde tu 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"}| Campo | Significado |
|---|---|
contactRef + source | El id del contacto en su origen: id de registro de HubSpot (hubspot), unique email id de Mailchimp (mailchimp), id de Customer.io (customerio), el contactRef de tu CSV (csv) |
email | En lugar de contactRef: el mejor contacto suscrito con esa dirección |
consentRef | Solo con email, para un contacto que Reveal aún no conoce (una lista de Klaviyo, por ejemplo): tu referencia del opt-in. El contacto se registra con origen link |
campaign | 1–40 caracteres A-Z a-z 0-9 _ -, por defecto email; se guarda como referencia de consentimiento link:<campaign> |
ttlDays | Días que funciona el enlace: por defecto 30, máximo 90. Un email reenviado deja de funcionar cuando su token caduca. Los enlaces para compartir que creas en la consola (vista de cuenta de solo lectura) duran 7 días por defecto y 30 como máximo |
Errores: 422 contact_not_eligible si el contacto no existe, se dio de baja, hizo opt-out o fue borrado; 401 sin una clave secreta válida; 429 por encima de 600 peticiones por minuto y clave. El endpoint necesita tu clave secreta: llámalo desde tu servidor, nunca desde el navegador.
Firma en bloque desde la consola
People → Contacts → Bulk sign: sube un CSV con una columna contactRef (y source) o email, elige campaña y duración, descarga el fichero con la columna pid e impórtalo en tu herramienta de email como propiedad del contacto. Las filas que no se pueden firmar vuelven con el motivo.
Merge tags
| Herramienta | Referencia del contacto para firmar | Enlace decorado |
|---|---|---|
| HubSpot | {{contact.hs_object_id}} · origen hubspot | https://example.com/pricing?pid={{contact.prynt_pid}} |
| Klaviyo | tu propio id, o el email con consentRef | https://example.com/pricing?pid={{ person|lookup:'prynt_pid' }} |
| Mailchimp | *|UNIQID|* · origen mailchimp | https://example.com/pricing?pid=*|PRYNTPID|* |
| Customer.io | {{customer.id}} · origen customerio | https://example.com/pricing?pid={{customer.prynt_pid}} |
Mailchimp y Customer.io también funcionan sin firmar: con el seguimiento de clics activo añaden mc_eid / _cio_id a tus enlaces. Conecta la integración y Reveal busca al suscriptor con tu propia clave de API (solo miembros suscritos, caché de 24 horas; la clave se guarda cifrada).
Opciones del SDK
PryntReveal.reveal({
publicKey: 'pk_live_…',
pid: { param: 'pid', store: true }, // param por defecto 'pid'; store lo guarda en localStorage 'prynt_pid'
// pid: false // desactiva el reconocimiento por enlaces de email
});Con store: true las visitas posteriores desde el mismo navegador se reconocen sin el parámetro; un opt-out (Global Privacy Control, setConsent(false), un rechazo en tu gestor de consentimiento) borra el token guardado. Un valor de pid que no es un token de Prynt, como un id de producto, no se toca.
Emails reenviados
El mismo token usado desde más de 3 dispositivos se trata como enlace reenviado: la visita se vincula igualmente, con confianza 0,6 y el motivo shared_link, para que puedas dejarla fuera de las alertas que exigen una identificación fuerte. Los tokens están ligados a un contacto de tu cuenta; un token de otra cuenta, modificado o caducado se ignora.
Privacidad
- Solo tus propios contactos, de herramientas que tú controlas, con su consentimiento. Reveal nunca añade personas de otros clientes ni de datos de terceros.
- Reveal guarda un hash de cada email con sal propia de tu cuenta, nunca la dirección, y nunca la pone en un token.
- Los contactos dados de baja, limpiados o borrados pasan a ser supresiones. Una solicitud de borrado elimina a la persona, marca el contacto como borrado para siempre y, en HubSpot, anonimiza las notas de Prynt y marca
prynt_opted_outen los contactos que creó Prynt. - Explica a tus suscriptores lo que haces: consulta Consentimiento para los modos de consentimiento y el opt-out.
Última actualización 2026-11-03 · Límites · Exclusión del visitante