Documentación · Prynt Reveal

Enlaces de email

Reconoce a las personas a las que ya envías emails cuando llegan a tu web desde un clic, en cualquier dispositivo y sin una cookie de una visita anterior. Firmas un token corto para cada uno de tus contactos suscritos y lo pones en los enlaces de tus emails; Reveal lo verifica en el servidor.

Cómo funciona

  1. 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.
  2. Firmas un pid por destinatario y campaña con POST /v1/reveal/links/sign desde tu backend, o en bloque desde la consola.
  3. Guardas el pid en una propiedad del contacto (por ejemplo prynt_pid) y añades ?pid= con esa merge tag a los enlaces que apuntan a tu web.
  4. 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 consentimiento link:<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"}
CampoSignificado
contactRef + sourceEl 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)
emailEn lugar de contactRef: el mejor contacto suscrito con esa dirección
consentRefSolo 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
campaign1–40 caracteres A-Z a-z 0-9 _ -, por defecto email; se guarda como referencia de consentimiento link:<campaign>
ttlDaysDí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

HerramientaReferencia del contacto para firmarEnlace decorado
HubSpot{{contact.hs_object_id}} · origen hubspothttps://example.com/pricing?pid={{contact.prynt_pid}}
Klaviyotu propio id, o el email con consentRefhttps://example.com/pricing?pid={{ person|lookup:'prynt_pid' }}
Mailchimp*|UNIQID|* · origen mailchimphttps://example.com/pricing?pid=*|PRYNTPID|*
Customer.io{{customer.id}} · origen customeriohttps://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_out en los contactos que creó Prynt.
  • Explica a tus suscriptores lo que haces: consulta Consentimiento para los modos de consentimiento y el opt-out.

Siguiente: Límites

Última actualización 2026-11-03 · Límites · Exclusión del visitante