consentimiento de cookies para Nuxt
@cookiecrumbs/nuxt coloca la etiqueta al principio de app.head.script con prioridad critical, antes del chunk de entrada de Nuxt, e importa automáticamente un composable useConsent().
la norma
Una app Nuxt con un plugin de GA o de píxel lo ejecuta en la entrada del cliente. Nada pregunta antes, y nada puede deshacerlo.
La norma es la misma en toda la UE y en el Reino Unido: nada más allá de lo estrictamente necesario puede almacenarse en el dispositivo de un visitante ni leerse de él antes de que haya dado su consentimiento. Es el artículo 5(3) de la Directiva ePrivacy, y ese consentimiento debe cumplir la definición del RGPD: libre, específico, informado e inequívoco, con un rechazo tan fácil como la aceptación. El Reino Unido mantiene la misma norma en PECR, con exenciones limitadas para estadísticas de bajo riesgo desde el 5 de febrero de 2026. California y las demás leyes estatales de EE. UU. funcionan al revés: sin opt-in, pero con un enlace de opt-out y soporte para la señal Global Privacy Control.
De ahí se derivan tres cosas para un sitio web. Los scripts de analítica, publicidad y redes sociales tienen que esperar una decisión. La decisión tiene que registrarse de forma que puedas demostrarla después, porque el artículo 7(1) pone la carga de la prueba sobre ti. Y retirar el consentimiento tiene que ser tan fácil como darlo, lo que exige un control que vuelva a abrir el banner en cada página. Un banner que muestra dos botones y carga Google Analytics de todos modos suspende la primera prueba, y ese es justo el fallo que las autoridades están sancionando, desde las decisiones de la CNIL contra Google y SHEIN hasta las inspecciones de las autoridades neerlandesa y belga.
cómo funciona
Nuxt gestiona el head del documento por ti, que es exactamente donde tiene que estar un runtime de consentimiento. El módulo pone la etiqueta en app.head.script con tagPriority: "critical", así que se renderiza antes del chunk de entrada de Nuxt en cada página, renderizada en servidor o estática. Sin editar layouts ni llamadas de head por página.
Los plugins de cliente son la fuente habitual de rastreadores tempranos en Nuxt: un plugin gtag, un plugin de Pixel, un módulo de terceros que inyecta su propio script. El composable useConsent() les da a todos isGranted(category) y una forma de suscribirse a los cambios, así que un plugin puede esperar e inicializarse en el momento en que llega el consentimiento. Los módulos de Nuxt de terceros que inyectan scripts reciben una categoría en su etiqueta, o su host queda neutralizado por el mapa de bloqueo del escaneo.
Tres componentes vienen con el módulo: ConsentGate para subárboles, CookieDeclaration para la página de privacidad y ManageCookiesLink para el pie. Las rutas de servidor y el middleware pueden leer la cookie de consentimiento con los mismos helpers, así que una página puede renderizar un marcador en lugar de un embed antes de la hidratación.
configuración
Cinco pasos. La CLI hace la mayoría, y cada uno es también un clic en el panel.
Detecta Nuxt, vincula el sitio, escribe la configuración.
npx cookiecrumbs login
npx cookiecrumbs initLa clave del sitio y el entorno van en nuxt.config.ts.
npm i @cookiecrumbs/nuxt
// nuxt.config.ts
export default defineNuxtConfig({
modules: ['@cookiecrumbs/nuxt'],
cookiecrumbs: { site: 'pk_live_…', env: 'production' },
});useConsent() expone status, consent, regime, country, language, version y las acciones accept, reject, open y withdraw.
const { isGranted, open } = useConsent();
<ConsentGate category="analytics">
<AnalyticsWidget />
</ConsentGate>Un plugin de cliente inicializa su rastreador solo cuando se concede la categoría, y de nuevo si el consentimiento cambia después.
// plugins/pixel.client.ts
export default defineNuxtPlugin(() => {
const { isGranted, onChange } = useConsent();
const start = () => { if (isGranted('marketing')) initPixel(); };
start(); onChange(start);
});Escanea, clasifica una vez por proveedor, publica.
npx cookiecrumbs scan --wait
npx cookiecrumbs push --env productionLas tiendas Nuxt que usan Google Ads a través de un plugin gtag reciben los valores por defecto de Consent Mode del runtime antes de que cargue el plugin, así que la etiqueta de conversión respeta la decisión sin reescribir nada.
Google Consent Mode v2 es la capa de señales entre el banner y las etiquetas de Google. Antes de que se ejecute cualquier etiqueta, siete señales (ad_storage, analytics_storage, ad_user_data, ad_personalization, functionality_storage, personalization_storage, security_storage) se fijan en «denied» para los visitantes del EEE, el Reino Unido y Suiza. En cuanto alguien elige, el runtime las actualiza y las etiquetas de Google se ajustan. Desde el 15 de junio de 2026 Google usa ad_storage como señal determinante para los datos de Ads, así que acertar con el valor por defecto importa más que antes.
CookieCrumbs fija los valores por defecto de forma síncrona, antes que cualquier gestor de etiquetas, los actualiza con cada decisión e incluye una plantilla de Google Tag Manager para que los activadores de consentimiento existan sin listeners escritos a mano. En modo avanzado, los pings sin cookies de Google mantienen las conversiones modeladas para los visitantes que dijeron que no. Lo que no hace es fingir ser una CMP certificada por Google: para AdSense, Ad Manager o AdMob en el EEE sigues necesitando una con IAB TCF, y CookieCrumbs hoy no lo es.
ojo
Cada uno aparece en el primer escaneo como un rastreador que se disparó antes del consentimiento.
antes de publicar
Ocho líneas. El panel marca las dos últimas con datos reales.
type="text/plain" con una categoría, o bien el host está en el mapa de bloqueo del escaneo.lo que obtienes
Dos dominios, 100 subpáginas escaneadas al mes por dominio, todas las normativas, la CLI, los SDK y el servidor MCP.
Cada página, en cada estado de consentimiento, en un navegador real. Cookies, píxeles, iframes y claves de almacenamiento, con la página y el script que los pusieron. Se vuelve a escanear según un calendario.
La declaración de cookies se escribe sola a partir del resultado.
Las etiquetas permanecen inactivas hasta que se concede su categoría. «Rechazar todo» es tan visible como «Aceptar todo». Siete diseños, 25 idiomas, Consent Mode v2 y la norma correcta por región.
21 kB, un solo archivo, sin peticiones propias a terceros.
Cada decisión se guarda con marca de tiempo, versión del banner y un hash de los textos mostrados, encadenada al registro anterior. Las exportaciones van firmadas. Alojado en Fráncfort.
Artículo 7(1), en el plan gratuito.
comprobación gratuita
El HTML de la página de inicio, contrastado con la base de datos de rastreadores. Sin cuenta, sin guardar nada. El escaneo completo del panel hace lo mismo con cada página, en un navegador real.
preguntas
siguiente paso
Añade el sitio, ejecuta npx cookiecrumbs init en tu repositorio Nuxt y el registro de consentimiento empieza a grabar en la UE.