Guida alla risoluzione dei problemi

Soluzioni ai problemi comuni di CookieBeam. Se non trovi la risposta, invia un'email a support@cookiebeam.com

Salto rapido:

Problemi di visualizzazione del banner Problemi con Google Tag Manager Problemi con Consent Mode v2 Problemi di scansione dei cookie Problemi di prestazioni

Problemi di visualizzazione del banner

Il banner non viene visualizzato sul mio sito

Verifica se lo script è caricato

1. Apri il tuo sito web in Chrome
2. Premi F12 per aprire gli Strumenti per sviluppatori
3. Vai alla scheda "Network"
4. Aggiorna la pagina
5. Cerca "cookiebeam" nel filtro
6. Se vedi uno stato 200, lo script è stato caricato correttamente

Verifica l'ID del banner

1. Vai alla dashboard di CookieBeam
2. Fai clic sul tuo banner → scheda Installazione
3. Copia il tuo ID banner
4. Verifica che corrisponda all'ID nel codice del tuo sito
5. Errore comune: usare l'ID sbagliato o lasciare il segnaposto "YOUR-BANNER-ID"

Controlla gli errori JavaScript

1. Apri Chrome DevTools (F12)
2. Vai alla scheda "Console"
3. Cerca messaggi di errore in rosso
4. Se vedi "CookieBeam is not defined" o simile, lo script non si sta caricando
5. Carica lo script del banner in modo sincrono come primo elemento nell'head della pagina, senza async o defer.

Svuota la cache

1. Esegui un aggiornamento forzato: Ctrl+Shift+R (Windows) o Cmd+Shift+R (Mac)
2. Oppure svuota completamente la cache del browser
3. Prova in modalità incognito/privata per testare

Il banner appare su desktop ma non su mobile

Controlla le impostazioni responsive

1. Vai a Banner Designer → Layout
2. Assicurati che "Mobile Responsive" sia abilitato
3. Testa diverse dimensioni dello schermo in DevTools (F12 → Device Toolbar)
4. Controlla eventuali conflitti CSS su mobile

Il banner appare ma sembra rotto/senza stile

Conflitto CSS

1. Il CSS del tuo sito potrebbe sovrascrivere gli stili del banner
2. Aggiungi la priorità !important nel CSS personalizzato di CookieBeam
3. Oppure aumenta la specificità CSS nelle impostazioni del banner
4. Controlla la console del browser per errori CSS

Il banner appare a ogni visita (non ricorda la scelta)

Problemi di archiviazione dei cookie

1. Controlla se il tuo browser blocca i cookie di terze parti
2. Verifica che il localStorage sia abilitato (richiesto per salvare il consenso)
3. Controlla se sei in modalità privata/incognito (i cookie non persistono)
4. Assicurati che il cookie di consenso non venga eliminato da un altro script

Problemi con Google Tag Manager

Il banner non si attiva in modalità Anteprima di GTM

Controlla la configurazione dei tag

1. Apri la modalità Anteprima di GTM
2. Cerca il tag "CookieBeam Consent" nell'elenco dei tag
3. Verifica che mostri "Tags Fired" e non "Tags Not Fired"
4. Se non si attiva, controlla la configurazione dell'attivatore
5. Usa l'attivatore "Inizializzazione del consenso - Tutte le pagine"

Il tag si attiva ma il banner non appare

1. Apri la console del browser (F12)
2. Controlla se lo script CookieBeam si sta caricando
3. Verifica se l'ID del banner è corretto nel codice del tag GTM
4. Verifica che l'URL dello script sia: https://cdn.cookiebeam.com/banner/...

Altri tag si attivano ancora senza consenso

Configura i requisiti di consenso

1. Apri ogni tag GA4/Google Ads in GTM
2. Vai a Impostazioni avanzate → Impostazioni consenso
3. Abilita "Richiedi consenso aggiuntivo per l'attivazione del tag"
4. Per GA4: seleziona "Analytics Storage"
5. Per Google Ads: seleziona "Ad Storage" e "Analytics Storage"
6. Salva e pubblica

Assicurati che CookieBeam si carichi per primo

1. Il tag CookieBeam deve usare l'attivatore "Inizializzazione del consenso"
2. Questo si attiva PRIMA di tutti gli altri tag
3. Gli altri tag di marketing dovrebbero avere requisiti di consenso

Problemi di prestazioni

Il banner si carica lentamente

Ottimizza il caricamento

1. Mantieni il loader sincrono e come primo elemento nell'head della pagina; escludilo dagli ottimizzatori di ritardo degli script.
2. Usa la versione CDN (cdn.cookiebeam.com), non quella ospitata autonomamente
3. Controlla la velocità della tua connessione internet
4. Il banner dovrebbe caricarsi in meno di 500ms con una buona connessione

Il banner blocca il caricamento della pagina

Loader sincrono

1. Non aggiungere async o defer al loader del banner.
2. Utilizza l'URL canonico del loader dalla scheda di installazione del banner.
3. Carica in modo sincrono come primo elemento nell'head della pagina, prima dei tracker.

Debugging avanzato

Per sviluppatori: usa questi comandi nella console del browser per il debug di CookieBeam

Verifica se CookieBeam è caricato:

window.CookieBeam !== undefined

Ottieni lo stato del consenso attuale:

CookieBeam.getConsent()

Controlla il dataLayer (GTM):

window.dataLayer

Forza visualizzazione banner (test):

CookieBeam.show()

Resetta il consenso (test):

CookieBeam.reset()

Serve ancora aiuto?

Se non hai trovato una soluzione, siamo qui per aiutarti!

✉️ Supporto via Email

support@cookiebeam.com

Risposta entro 24 ore

📚 Centro di apprendimento

Guide e tutorial

Documentazione approfondita

📊 Quando segnali un problema: Includi il tuo ID Browser (disponibile nella dashboard di CookieBeam), la versione del browser e i passaggi per riprodurre il problema. Anche gli screenshot sono utili!