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

Il tag si attiva ma il banner non appare

  1. 1. Apri la console del browser (F12)
  2. 2. Controlla se lo script CookieBeam si sta caricando
  3. 3. Verifica se l'ID del banner è corretto nel codice del tag GTM
  4. 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. 1. Apri ogni tag GA4/Google Ads in GTM
  2. 2. Vai a Impostazioni avanzate → Impostazioni consenso
  3. 3. Abilita "Richiedi consenso aggiuntivo per l'attivazione del tag"
  4. 4. Per GA4: seleziona "Analytics Storage"
  5. 5. Per Google Ads: seleziona "Ad Storage" e "Analytics Storage"
  6. 6. Salva e pubblica

Assicurati che CookieBeam si carichi per primo

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

Problemi di prestazioni

Il banner si carica lentamente

Ottimizza il caricamento

  1. 1. Assicurati che lo script abbia l'attributo "defer"
  2. 2. Usa la versione CDN (cdn.cookiebeam.com), non quella ospitata autonomamente
  3. 3. Controlla la velocità della tua connessione internet
  4. 4. Il banner dovrebbe caricarsi in meno di 500ms con una buona connessione

Il banner blocca il caricamento della pagina

Caricamento asincrono

  1. 1. Usa sempre l'attributo defer o async sul tag script
  2. 2. Corretto: script src="..." defer
  3. 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 !== 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!

📊 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!