Guías

Analítica sin cookies para Next.js en 2 minutos

Añade analítica de producto sin cookies y centrada en la privacidad a tu proyecto Next.js (App Router): instala, llama a init una vez y mide lo que importa.

Por · Actualizado el · 1 min de lectura

La instalación en tres pasos#

  1. 1

    Instalación

    Terminal
    npm i @shipabase/js
    .env.local
    NEXT_PUBLIC_SHIPABASE_KEY=SB-EU-xxxxxxxxxx
  2. 2

    Llama a init una vez, en el cliente

    app/providers.tsx
    "use client"; import { useEffect } from "react";import { init } from "@shipabase/js"; export function Providers({ children }: { children: React.ReactNode }) {  useEffect(() => {    init(process.env.NEXT_PUBLIC_SHIPABASE_KEY!);  }, []);  return <>{children}</>;}

    Envuelve {children} en app/layout.tsx con <Providers>. Nunca llames a init en un Server Component.

  3. 3

    Mide lo que importa

    cualquier componente de cliente
    import { trackEvent } from "@shipabase/js"; trackEvent("project_created", { plan: "pro" });
    • Nombra los eventos en snake_case, con formato object_verb y en pasado: signup_completed, invoice_sent.
    • Lo habitual son entre 5 y 15 eventos. Mide acciones, no cada clic.
    • Mantén las props anónimas: plan, count, variant. Nunca emails ni IDs de usuario.

Para el Pages Router y la referencia completa, consulta la guía de instalación de Next.js.

¿Por qué no hace falta banner de cookies?#

El SDK no guarda nada en el navegador: ni cookies ni localStorage. Los visitantes se cuentan con un hash anónimo que cambia cada día. Consulta cómo se cuentan los visitantes para más detalles.

Preguntas frecuentes

¿Funciona con el Pages Router?

Sí. Llama a init en un useEffect en pages/_app.tsx.

¿Las páginas vistas se registran automáticamente?

Sí, desde @shipabase/js 0.4, incluidos los cambios de ruta del lado del cliente en el App Router.

Sigue leyendo