Consenso ai cookie pensato per le applicazioni React.
Aggiungi CookieHub alla tua app React con react-cookiehub, mantieni coerente lo stato del consenso durante la navigazione lato client e controlla quando i servizi di analisi, marketing e i contenuti incorporati possono essere eseguiti.
- Pacchetto React
- Stato del consenso adatto alle SPA
- Script controllati dal consenso
Un unico stato del consenso in tutta la tua app React.
Le app React non si caricano come i siti web tradizionali. I componenti vengono montati mentre i visitatori navigano nell’app, le route cambiano senza ricaricare completamente la pagina e gli script possono essere caricati dinamicamente: se il consenso non è gestito in un unico punto, il tracciamento può quindi attivarsi prima che il visitatore abbia scelto.
CookieHub offre alla tua app React un livello di consenso centralizzato. Inizializzalo una sola volta nella radice dell’app con react-cookiehub, poi carica gli strumenti di analisi, marketing e gli altri strumenti non essenziali solo quando il visitatore ha consentito la categoria di consenso pertinente.
Caricamento degli script dopo il consenso
Inizializza gli strumenti di analisi, marketing o altri strumenti non essenziali solo quando la categoria pertinente è consentita.
Consenso adatto alle SPA
Inizializza CookieHub in modo centralizzato e mantieni coerente il consenso dei visitatori nei cambi di route lato client.
Controlli specifici per React
Usa i componenti e gli eventi React del pacchetto invece di disseminare controlli del consenso in tutta l’app.
Controlli del consenso progettati per React.
react-cookiehub è il pacchetto di CookieHub per le app React e Next.js. Carica CookieHub dalla radice dell’app e ti offre componenti ed eventi per tutto ciò che deve attendere il consenso:
- CookieHub.initialize() carica CookieHub con il tuo codice di dominio
- CookieHubScript carica uno script esterno o inline nella categoria di consenso che imposti
- CookieHubGA e CookieHubPixel caricano Google Analytics e il Meta Pixel nelle categorie analisi e marketing
- CookieHubYoutube incorpora i video di YouTube tramite un URL youtube-nocookie
- onAllow, onRevoke e altri eventi permettono alla tua app di reagire quando il consenso cambia
La guida al pacchetto contiene il riferimento completo, inclusa la configurazione per l’App Router e il Pages Router di Next.js.
Vedi la guida al pacchettoStrumenti per il consenso ai cookie per la tua app React.
Caricamento degli script dopo il consenso
CookieHubScript aggiunge uno script nella categoria di consenso che scegli (come analisi, marketing o preferenze), così viene eseguito solo quando il visitatore consente quella categoria.
Consenso stabile nei cambi di route
CookieHub viene caricato una sola volta dalla radice dell’app. La navigazione lato client non ricarica la pagina, quindi la scelta del visitatore resta valida quando cambiano le route.
Componente per Google Analytics
CookieHubGA carica Google Analytics con il tuo ID di monitoraggio nella categoria analisi, quindi attende il consenso all’analisi.
Componente per Meta Pixel
CookieHubPixel carica il pixel di Meta (Facebook) con il tuo ID pixel nella categoria marketing, quindi attende il consenso al marketing.
Controllo dei contenuti multimediali incorporati
CookieHubYoutube incorpora un video di YouTube a partire dall’URL o dall’ID tramite un URL youtube-nocookie, che non imposta i cookie di tracciamento di YouTube.
Eventi di consenso e API
Eventi come onAllow, onRevoke e onStatusChange e metodi come hasConsented() e openSettings() permettono alla tua app di reagire al consenso senza ricaricare la pagina.
Aggiungi CookieHub a React in pochi passaggi.
Questi passaggi seguono la guida al pacchetto react-cookiehub. Usi Next.js? Lì CookieHub viene inizializzato lato client: vedi le note qui sotto.
- 01
Installa il pacchetto
Aggiungi react-cookiehub al tuo progetto React.
npm install react-cookiehub - 02
Inizializza CookieHub con il tuo codice di dominio
A ogni dominio che aggiungi nella dashboard di CookieHub viene assegnato un codice di dominio univoco di 8 caratteri. Importa CookieHub da react-cookiehub e chiama CookieHub.initialize() con quel codice nel componente radice, ad esempio App.js, così vale per tutta l’app.
CookieHub.initialize('YOUR-DOMAIN-CODE') - 03
Carica i servizi non essenziali tramite CookieHub
Aggiungi gli script con CookieHubScript e la loro categoria di consenso, oppure usa CookieHubGA, CookieHubPixel e CookieHubYoutube. Per gli altri pacchetti di tracciamento, usa onInitialise per gestire il consenso già espresso e onAllow quando viene concesso un nuovo consenso.
category="analytics" - 04
Verifica il consenso nei cambi di route
Verifica che il tracciamento non venga eseguito prima del consenso, poi spostati tra le route e cambia la tua scelta nella finestra delle impostazioni. Imposta debug: true nelle opzioni per avere più dettagli nella console.
debug: true
Usi l’App Router di Next.js?
CookieHub si basa su API del browser come window, quindi inizializzalo lato client: crea un componente client che chiama CookieHub.initialize() dentro useEffect e renderizzalo nel layout radice.
Configurazione per l’App Router di Next.jsUsi il Pages Router di Next.js?
Chiama CookieHub.initialize() dentro useEffect nel file _app, così CookieHub non viene eseguito sul server. Poiché Next.js può alterare l’ordine di caricamento degli script, la guida al pacchetto consiglia i componenti per script di CookieHub.
Configurazione per il Pages Router di Next.js
Mantieni intatto il consenso quando la tua app cambia route.
In una single-page app, React monta componenti e carica servizi mentre i visitatori navigano, senza ricaricare completamente la pagina. react-cookiehub aggiunge CookieHub una sola volta, dalla radice dell’app, così la decisione di consenso del visitatore resta disponibile per ogni route e componente.
- Il componente radice inizializza CookieHub
- CookieHub conserva lo stato del consenso del visitatore
- Le route cambiano senza ricaricare la pagina
- Gli script vengono eseguiti solo nelle categorie consentite
Carica gli script di terze parti solo dopo il consenso.
react-cookiehub copre gli script che aggiungi tramite i suoi componenti. Gli script che la tua app carica in altro modo non vengono trattenuti dal pacchetto da soli: caricali tramite CookieHubScript o contrassegnali per il consenso. I pacchetti di tracciamento personalizzati devono verificare il consenso già espresso in onInitialise e avviarsi con un nuovo consenso in onAllow.
Come funziona il blocco degli scriptScript nei tuoi componenti
CookieHubScript riceve uno script esterno (src) o inline (innerHTML) e la sua categoria, e lo esegue quando il visitatore consente quella categoria.
Google Analytics e Meta Pixel
CookieHubGA trattiene Google Analytics fino al consenso all’analisi; CookieHubPixel trattiene il pixel di Meta (Facebook) fino al consenso al marketing.
Altri pacchetti di tracciamento per React
I pacchetti che richiedono una propria inizializzazione possono avviarsi nell’evento onInitialise, oppure in onAllow quando una categoria come analisi viene consentita.
Video di YouTube incorporati
CookieHubYoutube incorpora un video a partire dall’URL o dall’ID tramite un URL youtube-nocookie, con larghezza e altezza facoltative.
Reagisci quando il consenso cambia.
Quando un visitatore cambia la sua scelta, la tua app potrebbe dover reagire subito: avviare un pacchetto di tracciamento, fermarne uno o aggiornare l’interfaccia. Passa dei gestori di eventi a CookieHub.initialize() per agire in base al consenso senza ricaricare la pagina:
- onInitialise viene eseguito quando CookieHub è stato inizializzato
- onAllow viene eseguito quando il visitatore consente una categoria, come analisi
- onRevoke viene eseguito quando il visitatore revoca una categoria, come marketing
- onStatusChange viene eseguito quando il visitatore aggiorna il proprio stato di consenso
Metodi come hasConsented(category), hasAnswered(), openSettings(), allowAll() e denyAll() permettono ai tuoi componenti di verificare il consenso, aprire la finestra delle impostazioni o consentire o rifiutare tutte le categorie. Per altre opzioni, consulta l’API JavaScript di CookieHub.
Scopri l’API JavaScriptDomande su React, con risposta.
Caricali tramite react-cookiehub. CookieHubScript riceve uno script esterno o inline e la categoria di consenso a cui appartiene, e lo esegue solo quando il visitatore consente quella categoria. Per i pacchetti di tracciamento che avvii nel codice, verifica il consenso già espresso con hasConsented() in onInitialise e avviali in onAllow quando il visitatore acconsente in seguito.
Sì. react-cookiehub non è legato a un router specifico: inizializzi CookieHub una sola volta nel componente radice e i cambi di route lato client non ricaricano la pagina, quindi la scelta del visitatore resta valida mentre si sposta tra le route. Inizializzalo nella radice, non nelle singole route.
Sì. Il componente CookieHubGA riceve il tuo ID di monitoraggio di Google Analytics e carica Google Analytics nella categoria analisi, quindi non viene eseguito finché il visitatore non consente i cookie di analisi.
Sì. Il componente CookieHubPixel riceve il tuo ID pixel di Meta (Facebook) e carica il pixel nella categoria marketing, quindi non viene eseguito finché il visitatore non consente i cookie di marketing.
Passa dei gestori di eventi quando inizializzi CookieHub: onAllow e onRevoke ricevono la categoria che il visitatore ha consentito o revocato, e onStatusChange viene eseguito quando aggiorna la sua scelta. Puoi anche verificare il consenso in qualsiasi momento con hasConsented(category) o usare l’API JavaScript di CookieHub.
Nella dashboard di CookieHub. A ogni dominio che aggiungi viene assegnato un codice di dominio univoco di 8 caratteri, visibile nell’elenco dei domini. Passalo a CookieHub.initialize() al posto di YOUR-DOMAIN-CODE.
Sì. La guida al pacchetto react-cookiehub copre sia l’App Router sia il Pages Router di Next.js. Segnala inoltre che Next.js può causare problemi con l’ordine di caricamento degli script, quindi consiglia di caricare gli script di tracciamento con i componenti per script di CookieHub.
Sì. CookieHub si basa su API del browser come window, quindi la documentazione del pacchetto consiglia l’inizializzazione lato client. Con l’App Router, chiama CookieHub.initialize() dentro useEffect in un componente client renderizzato dal layout radice; con il Pages Router, chiamalo dentro useEffect nel file _app.
Sì. Se la tua app React carica già i suoi tag tramite Google Tag Manager, puoi installare CookieHub tramite GTM con il modello CookieHub CMP invece di react-cookiehub. Usa una sola implementazione, non entrambe.
CookieHub offre strumenti che aiutano i titolari di app React a soddisfare i requisiti di consenso delle leggi sulla privacy come GDPR, CCPA e LGPD: un banner di consenso, il caricamento controllato dal consenso degli script che aggiungi tramite CookieHub, la registrazione delle decisioni di consenso e una dichiarazione sui cookie sempre aggiornata.
Aggiungi la gestione del consenso alla tua app React.
Usa l’integrazione React di CookieHub per mantenere il consenso dei visitatori collegato agli script e ai servizi caricati dalla tua applicazione.