Documentación · Prynt Reveal · Instalación

Next.js / React

Monta Reveal una vez en el cliente; los cambios de ruta se siguen automáticamente. Funciona con el App Router, el Pages Router y apps React Router.

Paquete npm (recomendado)

npm install @pryntid/js
// app/prynt-reveal.tsx — a client component mounted once in app/layout.tsx
'use client';
import { useEffect } from 'react';
import { reveal } from '@pryntid/js/reveal';

export default function PryntReveal() {
  useEffect(() => {
    // spa: true (default) patches history.pushState, so App Router / Pages Router navigations
    // become pageviews on their own. stop() removes every listener on unmount.
    const client = reveal({ publicKey: process.env.NEXT_PUBLIC_PRYNT_KEY!, website: 'example.com' });
    return () => client.stop();
  }, []);
  return null;
}

// app/layout.tsx
// import PryntReveal from './prynt-reveal';
// <body>{children}<PryntReveal /></body>

React sin Next (Vite, CRA, React Router): el mismo useEffect en tu componente raíz. Los routers hash (#/ruta) no se detectan — llama a reveal.pageview() desde el listener de tu router.

Alternativa: next/script con el build CDN

// Pages Router or no npm: next/script with the CDN build (loads after hydration)
import Script from 'next/script';

<Script src="https://api.pryntid.com/cdn/prynt-reveal.umd.js" strategy="afterInteractive"
  onLoad={() => window.PryntReveal.reveal({ publicKey: 'pk_live_YOUR_PUBLIC_KEY', website: 'example.com' })} />

Notas

  • Server components y SSR: PryntReveal.reveal() devuelve un cliente no-op cuando falta window, pero mantén la llamada en un componente cliente para que no se ejecute en cada render.
  • React Strict Mode monta los efectos dos veces en desarrollo; la limpieza (reveal.stop()) lo resuelve.
  • Content-Security-Policy con nonces (cabeceras de next.config o middleware): la vía npm no necesita script inline. Con next/script, pasa nonce.
  • Identificar tras el login: reveal.identify({ email: session.user.email }) en el componente que conoce la sesión.

Ejecuta el Test Script

  1. En la consola ve a Websites → tu sitio → **Test Script**. Descarga tu página desde nuestro lado y ejecuta las siete comprobaciones: snippet presente, clave pública, dominio, CSP script-src, CSP connect-src, gestor de consentimiento, posición del script y redirección www.
  2. Abre tu sitio con ?prynt_debug=1 para ver el panel en vivo desde el punto de vista del navegador (consentimiento, CMP, almacenamiento, cspBlocked, último envío).
  3. Visita dos o tres páginas. El pulso de la consola muestra el último evento en segundos; las primeras empresas aparecen en cuanto visita una red empresarial.

Un cspBlocked: true o una comprobación CSP fallida significa que tu Content-Security-Policy necesita las dos líneas de CSP y almacenamiento. ¿Usas un gestor de consentimiento? Consentimiento explica qué se detecta y qué se envía antes de que el visitante decida.

Siguiente: Nuxt / Vue

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