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 NightOwl · Actualizado el · 1 min de lectura
La instalación en tres pasos#
- 1
Instalación
Terminal npm i @shipabase/js.env.local NEXT_PUBLIC_SHIPABASE_KEY=SB-EU-xxxxxxxxxx - 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}enapp/layout.tsxcon<Providers>. Nunca llames ainiten un Server Component. - 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 formatoobject_verby 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.
- Nombra los eventos en
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.


