Documentação · Prynt Reveal · Instalação

Next.js / React

Monte o Reveal uma vez no cliente; as mudanças de rota são seguidas automaticamente. Funciona com o App Router, o Pages Router e apps React Router.

Pacote 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 sem Next (Vite, CRA, React Router): o mesmo useEffect no seu componente raiz. Routers hash (#/rota) não são detectados — chame reveal.pageview() a partir do listener do seu router.

Alternativa: next/script com o 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 e SSR: PryntReveal.reveal() devolve um cliente no-op quando window não existe, mas mantenha a chamada num componente cliente para não rodar a cada render.
  • O React Strict Mode monta os efeitos duas vezes em desenvolvimento; a limpeza (reveal.stop()) resolve isso.
  • Content-Security-Policy com nonces (cabeçalhos do next.config ou middleware): a via npm não precisa de script inline. Com next/script, passe nonce.
  • Identificar após o login: reveal.identify({ email: session.user.email }) no componente que conhece a sessão.

Execute o Test Script

  1. No console vá a Websites → seu site → **Test Script**. Ele busca sua página do nosso lado e executa as sete verificações: snippet presente, chave pública, domínio, CSP script-src, CSP connect-src, gestor de consentimento, posição do script e redirecionamento www.
  2. Abra seu site com ?prynt_debug=1 para ver o painel ao vivo do ponto de vista do navegador (consentimento, CMP, armazenamento, cspBlocked, último envio).
  3. Visite duas ou três páginas. O pulso no console mostra o último evento em segundos; as primeiras empresas aparecem assim que uma rede empresarial visitar.

Um cspBlocked: true ou uma verificação CSP com falha significa que sua Content-Security-Policy precisa das duas linhas de CSP e armazenamento. Usa um gestor de consentimento? Consentimento explica o que é detectado e o que é enviado antes de o visitante decidir.

Próximo: Nuxt / Vue

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