Consentimiento de cookies creado para aplicaciones React.
Añade CookieHub a tu app de React con react-cookiehub, mantén el estado del consentimiento coherente durante la navegación del lado del cliente y controla cuándo pueden ejecutarse los servicios de analítica, marketing y contenido incrustado.
- Paquete para React
- Estado del consentimiento apto para SPA
- Scripts controlados por el consentimiento
Un único estado del consentimiento en toda tu app de React.
Las apps de React no se cargan como los sitios web tradicionales. Los componentes se montan a medida que los visitantes recorren la app, las rutas cambian sin recargar la página por completo y los scripts pueden cargarse de forma dinámica, así que, si el consentimiento no se gestiona en un solo lugar, el seguimiento puede activarse antes de que el visitante haya decidido.
CookieHub da a tu app de React una capa de consentimiento centralizada. Inicialízalo una vez en la raíz de tu app con react-cookiehub y carga las herramientas de analítica, marketing y otras no esenciales solo cuando el visitante haya permitido la categoría de consentimiento correspondiente.
Carga de scripts tras el consentimiento
Inicializa las herramientas de analítica, marketing u otras no esenciales solo cuando la categoría correspondiente esté permitida.
Consentimiento apto para SPA
Inicializa CookieHub de forma centralizada y mantén coherente el consentimiento del visitante en los cambios de ruta del lado del cliente.
Controles específicos para React
Usa los componentes y eventos de React del paquete en lugar de repartir comprobaciones de consentimiento por toda la app.
Controles de consentimiento diseñados para React.
react-cookiehub es el paquete de CookieHub para apps de React y Next.js. Carga CookieHub desde la raíz de tu app y te ofrece componentes y eventos para todo lo que deba esperar al consentimiento:
- CookieHub.initialize() carga CookieHub con tu código de dominio
- CookieHubScript carga un script externo o en línea en la categoría de consentimiento que indiques
- CookieHubGA y CookieHubPixel cargan Google Analytics y Meta Pixel en las categorías de analítica y marketing
- CookieHubYoutube inserta vídeos de YouTube mediante una URL de youtube-nocookie
- onAllow, onRevoke y otros eventos permiten que tu app responda cuando cambia el consentimiento
La guía del paquete incluye la referencia completa, con la configuración para el App Router y el Pages Router de Next.js.
Ver la guía del paqueteHerramientas de consentimiento de cookies para tu app de React.
Carga de scripts tras el consentimiento
CookieHubScript añade un script en la categoría de consentimiento que elijas (como analítica, marketing o preferencias), de modo que solo se ejecuta cuando el visitante permite esa categoría.
Consentimiento estable en los cambios de ruta
CookieHub se carga una sola vez desde la raíz de tu app. La navegación del lado del cliente no recarga la página, así que la elección del visitante sigue vigente cuando cambian las rutas.
Componente para Google Analytics
CookieHubGA carga Google Analytics con tu ID de seguimiento en la categoría de analítica, así que espera al consentimiento de analítica.
Componente para Meta Pixel
CookieHubPixel carga el píxel de Meta (Facebook) con tu ID de píxel en la categoría de marketing, así que espera al consentimiento de marketing.
Control del contenido multimedia incrustado
CookieHubYoutube inserta un vídeo de YouTube a partir de su URL o ID mediante una URL de youtube-nocookie, que no establece las cookies de seguimiento de YouTube.
Eventos de consentimiento y API
Eventos como onAllow, onRevoke y onStatusChange, y métodos como hasConsented() y openSettings(), permiten que tu app responda al consentimiento sin recargar la página.
Añade CookieHub a React en pocos pasos.
Estos pasos siguen la guía del paquete react-cookiehub. ¿Usas Next.js? Allí CookieHub se inicializa del lado del cliente; consulta las notas de abajo.
- 01
Instala el paquete
Añade react-cookiehub a tu proyecto de React.
npm install react-cookiehub - 02
Inicializa CookieHub con tu código de dominio
Cada dominio que añades en el panel de CookieHub recibe un código de dominio único de 8 caracteres. Importa CookieHub desde react-cookiehub y llama a CookieHub.initialize() con ese código en tu componente raíz, como App.js, para que se ejecute en toda la app.
CookieHub.initialize('YOUR-DOMAIN-CODE') - 03
Carga los servicios no esenciales a través de CookieHub
Añade scripts con CookieHubScript y su categoría de consentimiento, o usa CookieHubGA, CookieHubPixel y CookieHubYoutube. Para otros paquetes de seguimiento, usa onInitialise para gestionar el consentimiento existente y onAllow cuando se concede un consentimiento nuevo.
category="analytics" - 04
Prueba el consentimiento en los cambios de ruta
Comprueba que el seguimiento no se ejecuta antes del consentimiento; después, navega entre rutas y cambia tu elección en el diálogo de ajustes. Define debug: true en las opciones para ver más detalles en la consola.
debug: true
¿Usas el App Router de Next.js?
CookieHub depende de API del navegador como window, así que inicialízalo del lado del cliente: crea un componente de cliente que llame a CookieHub.initialize() dentro de useEffect y renderízalo en tu layout raíz.
Configuración para el App Router de Next.js¿Usas el Pages Router de Next.js?
Llama a CookieHub.initialize() dentro de useEffect en tu archivo _app para que CookieHub no se ejecute en el servidor. Como Next.js puede alterar el orden de carga de los scripts, la guía del paquete recomienda los componentes de scripts de CookieHub.
Configuración para el Pages Router de Next.js
Mantén el consentimiento intacto cuando tu app cambia de ruta.
En una single-page app, React monta componentes y carga servicios a medida que los visitantes navegan, sin recargar la página por completo. react-cookiehub añade CookieHub una sola vez, desde la raíz de tu app, así que la decisión de consentimiento del visitante está disponible en cada ruta y componente.
- Tu componente raíz inicializa CookieHub
- CookieHub guarda el estado del consentimiento del visitante
- Las rutas cambian sin recargar la página
- Los scripts solo se ejecutan en las categorías permitidas
Carga los scripts de terceros solo tras el consentimiento.
react-cookiehub cubre los scripts que añades mediante sus componentes. El paquete no retiene por sí solo los scripts que tu app carga de otra forma: cárgalos con CookieHubScript o etiquétalos para el consentimiento. Los paquetes de seguimiento propios deben comprobar el consentimiento existente en onInitialise e iniciarse con el consentimiento nuevo en onAllow.
Cómo funciona el bloqueo de scriptsScripts en tus componentes
CookieHubScript recibe un script externo (src) o en línea (innerHTML) y la categoría a la que pertenece, y lo ejecuta cuando el visitante permite esa categoría.
Google Analytics y Meta Pixel
CookieHubGA retiene Google Analytics hasta el consentimiento de analítica; CookieHubPixel retiene el píxel de Meta (Facebook) hasta el consentimiento de marketing.
Otros paquetes de seguimiento para React
Los paquetes que necesitan su propia inicialización pueden iniciarse en el evento onInitialise, o en onAllow cuando se permite una categoría como analítica.
Vídeos de YouTube incrustados
CookieHubYoutube inserta un vídeo a partir de su URL o ID mediante una URL de youtube-nocookie, con un ancho y un alto opcionales.
Reacciona cuando cambia el consentimiento.
Cuando un visitante cambia su elección, puede que tu app tenga que responder al momento: iniciar un paquete de seguimiento, detener otro o actualizar la interfaz. Pasa controladores de eventos a CookieHub.initialize() para actuar según el consentimiento sin recargar la página:
- onInitialise se ejecuta cuando CookieHub se ha inicializado
- onAllow se ejecuta cuando el visitante permite una categoría, como analítica
- onRevoke se ejecuta cuando el visitante revoca una categoría, como marketing
- onStatusChange se ejecuta cuando el visitante actualiza su estado de consentimiento
Métodos como hasConsented(category), hasAnswered(), openSettings(), allowAll() y denyAll() permiten a tus componentes comprobar el consentimiento, abrir el diálogo de ajustes o permitir o rechazar todas las categorías. Para más opciones, consulta la API de JavaScript de CookieHub.
Explora la API de JavaScriptPreguntas sobre React, respondidas.
Cárgalos con react-cookiehub. CookieHubScript recibe un script externo o en línea y la categoría de consentimiento a la que pertenece, y solo lo ejecuta cuando el visitante permite esa categoría. En los paquetes de seguimiento que inicias en el código, comprueba el consentimiento existente con hasConsented() en onInitialise e inícialos en onAllow cuando el visitante dé su consentimiento más tarde.
Sí. react-cookiehub no depende de un router concreto: inicializas CookieHub una vez en tu componente raíz y los cambios de ruta del lado del cliente no recargan la página, así que la elección del visitante sigue vigente mientras se mueve entre rutas. Inicialízalo en la raíz y no en rutas individuales.
Sí. El componente CookieHubGA recibe tu ID de seguimiento de Google Analytics y carga Google Analytics en la categoría de analítica, así que no se ejecuta hasta que el visitante permite las cookies de analítica.
Sí. El componente CookieHubPixel recibe tu ID de píxel de Meta (Facebook) y carga el píxel en la categoría de marketing, así que no se ejecuta hasta que el visitante permite las cookies de marketing.
Pasa controladores de eventos al inicializar CookieHub: onAllow y onRevoke reciben la categoría que el visitante ha permitido o revocado, y onStatusChange se ejecuta cuando actualiza su elección. También puedes comprobar el consentimiento en cualquier momento con hasConsented(category) o usar la API de JavaScript de CookieHub.
En el panel de CookieHub. Cada dominio que añades recibe un código de dominio único de 8 caracteres, que aparece en tu lista de dominios. Pásalo a CookieHub.initialize() en lugar de YOUR-DOMAIN-CODE.
Sí. La guía del paquete react-cookiehub cubre tanto el App Router como el Pages Router de Next.js. También advierte que Next.js puede causar problemas con el orden de carga de los scripts, por lo que recomienda cargar los scripts de seguimiento con los componentes de scripts de CookieHub.
Sí. CookieHub depende de API del navegador como window, por lo que la documentación del paquete recomienda inicializarlo del lado del cliente. Con el App Router, llama a CookieHub.initialize() dentro de useEffect en un componente de cliente renderizado desde tu layout raíz; con el Pages Router, llámalo dentro de useEffect en tu archivo _app.
Sí. Si tu app de React ya carga sus etiquetas a través de Google Tag Manager, puedes instalar CookieHub mediante GTM con la plantilla CookieHub CMP en lugar de react-cookiehub. Usa una sola implementación, no ambas.
CookieHub ofrece herramientas que ayudan a los propietarios de apps de React a cumplir los requisitos de consentimiento de leyes de privacidad como el RGPD, la CCPA y la LGPD: un banner de consentimiento, carga controlada por el consentimiento de los scripts que añades con él, registros de las decisiones de consentimiento y una declaración de cookies siempre actualizada.
Añade la gestión del consentimiento a tu app de React.
Usa la integración de CookieHub con React para mantener el consentimiento de los visitantes conectado con los scripts y servicios que carga tu aplicación.