Guida alla risoluzione dei problemi
Soluzioni ai problemi comuni di CookieBeam. Se non trovi la risposta, invia un'email a [email protected]
Salto rapido:
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 con Consent Mode v2
Google Analytics non riceve i segnali di consenso
Abilita Consent Mode v2
- 1. Vai a Dashboard CookieBeam → Impostazioni Banner
- 2. Abilita "Google Consent Mode v2"
- 3. Salva le modifiche
- 4. In GA4, controlla il report in tempo reale per i segnali di consenso
- 5. Dovresti vedere "granted" o "denied" per analytics_storage
Verifica la configurazione di GA4
- 1. In GTM, apri il tuo tag di configurazione GA4
- 2. Verifica che sia impostato per usare la modalità consenso
- 3. In Amministrazione GA4 → Raccolta dati → Lo stato della modalità consenso dovrebbe mostrare "Osservato"
I segnali della modalità consenso non si aggiornano
Controlla il dataLayer
- 1. Apri la console del browser (F12)
- 2. Digita: window.dataLayer
- 3. Cerca gli eventi "consent"
- 4. Dovresti vedere gli eventi di aggiornamento quando l'utente accetta/rifiuta
- 5. Formato: event "consent", consent_update ...
Problemi di prestazioni
Il banner si carica lentamente
Ottimizza il caricamento
- 1. Assicurati che lo script abbia l'attributo "defer"
- 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
Caricamento asincrono
- 1. Usa sempre l'attributo defer o async sul tag script
- 2. Corretto: script src="..." defer
- 3. Non caricare mai in modo sincrono nell'head
Debugging avanzato
Per sviluppatori: usa questi comandi nella console del browser per il debug di CookieBeam
Verifica se CookieBeam è caricato:
window.CookieBeam !== undefinedOttieni lo stato del consenso attuale:
CookieBeam.getConsent()Controlla il dataLayer (GTM):
window.dataLayerForza 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
[email protected]
Risposta entro 24 ore
❓ FAQ
Domande comuni
Risposte rapide
📚 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!