Saltar al contenido principal

instalación

Analítica para Next.js, en una etiqueta

Un core de 1,2 KB, sin cookies y sin guardar la IP. Cambia YOUR_TOKEN por el token de tu sitio para medir visitas y fuentes, y conecta Stripe, Lemon Squeezy, Paddle o la API de ingresos para ver el dinero que hay detrás.

  1. Copia el token de tu sitio

    Está en Panel → Ajustes → Instalación, dentro del snippet. Antes del lanzamiento, tendrás panel en cuanto elijamos tu cuenta para la beta.

  2. Pega el snippet

    Una vez, en un lugar que carguen todas tus páginas. Sustituye YOUR_TOKEN por tu token.

    Next.jsapp/layout.tsx
    import Script from 'next/script';
    
    export default function RootLayout({ children }) {
      return (
        <html>
          <body>
            {children}
            <Script src="https://api.getvero.dev/t.js?s=YOUR_TOKEN" strategy="afterInteractive" />
          </body>
        </html>
      );
    }

    Usa next/script con afterInteractive. El módulo SPA opcional registra por sí solo las navegaciones del App Router.

  3. Publica y abre tu sitio

    Vero cuenta las visitas a tu dominio y sus subdominios, así que una prueba en localhost no aparece. Con el snippet publicado, abre tu sitio en otra pestaña: tu panel detecta la primera visita solo.

Dónde va la etiqueta en una app de Next.js

El layout raíz de app/layout.tsx envuelve todas las rutas, así que es el único sitio donde hace falta la etiqueta. Cárgala con next/script y la estrategia afterInteractive, dentro del body y después de children, tal y como hace el snippet.

Las navegaciones del App Router no recargan el documento, y el core por sí solo contaría solo la primera página de cada visita. El módulo SPA intercepta la History API al cargar y envía una página vista cada vez que pushState, replaceState o popstate cambian la ruta o la query. Con el Pages Router funciona igual.

No tienes que elegir los módulos a mano. Al añadir un sitio en Next.js, Vero lee tu página de inicio, encuentra __NEXT_DATA__ o _next/static, te enseña el snippet de Next.js y activa SPA junto a scroll, engagement, outbound y leave. Puedes cambiar la combinación de cada sitio en Panel → Ajustes → Instalación.

Si prefieres no enviar nada desde el navegador, middleware.ts puede registrar las páginas vistas desde el edge, firmadas con el secreto de ingesta de Ajustes del sitio → Ventas. Los bloqueadores no lo frenan y funciona con JavaScript desactivado, pero pierdes lo que solo sabe el navegador: scroll, engagement, Web Vitals y las rutas en el cliente.

Resolución de problemas

Las visitas de mi preview de Vercel no aparecen

Cuando tu sitio tiene dominio, Vero solo cuenta los beacons cuyo origen es ese dominio, su versión con o sin www o uno de sus subdominios. Un despliegue en *.vercel.app es otro host, así que el dashboard lo marca como preview e ignora sus visitas. Para probar una preview sin ensuciar tus números, empieza una prueba de instalación y abre la URL de la preview.

Mis datos no aparecen

Preguntas frecuentes

¿Funciona también con el Pages Router?

Sí. El módulo SPA escucha la History API, que usan los dos routers, así que los cambios de ruta en cualquiera de ellos se convierten en páginas vistas.

¿Un cambio en la query string cuenta como página vista nueva?

Con el módulo SPA activado, sí: cambiar la ruta o la query es una página vista. Cambiar solo el hash no lo es.

¿Puedo medir desde middleware.ts y prescindir del script en el cliente?

Sí, con el secreto de ingesta del sitio. Se cuenta cada petición de página, pero scroll, engagement, Web Vitals y las navegaciones en el cliente necesitan el script en el navegador.

IntegracionesPrecios

Después de la etiqueta

Beta elegida a mano, lista abierta

Pide plaza en la beta.

Cualquiera puede apuntarse a la lista. Las cuentas que elegimos tienen Pro gratis durante toda la beta.

Al apuntarte aceptas recibir avisos del lanzamiento y nuestra Política de Privacidad.

Ver la demo