---
title: "Guida alla risoluzione dei problemi | CookieBeam"
description: "Risolvi i problemi comuni di CookieBeam. Soluzioni per banner che non compaiono, problemi con la modalità consenso, integrazione GTM e altro."
url: "https://cookiebeam.com/it/troubleshooting"
lang: "it"
image: "https://cookiebeam.com/opengraph-image.png?v=20261016"
---

# Guida alla risoluzione dei problemi

Soluzioni ai problemi comuni di CookieBeam. Se non trovi la risposta, invia un'email a [support@cookiebeam.com](mailto: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. 1. Apri il tuo sito web in Chrome
2. 2. Premi F12 per aprire gli Strumenti per sviluppatori
3. 3. Vai alla scheda "Network"
4. 4. Aggiorna la pagina
5. 5. Cerca "cookiebeam" nel filtro
6. 6. Se vedi uno stato 200, lo script è stato caricato correttamente

#### Verifica l'ID del banner

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

#### Controlla gli errori JavaScript

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

#### Svuota la cache

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

### Il banner appare su desktop ma non su mobile

#### Controlla le impostazioni responsive

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

### Il banner appare ma sembra rotto/senza stile

#### Conflitto CSS

1. 1. Il CSS del tuo sito potrebbe sovrascrivere gli stili del banner
2. 2. Aggiungi la priorità !important nel CSS personalizzato di CookieBeam
3. 3. Oppure aumenta la specificità CSS nelle impostazioni del banner
4. 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. 1. Controlla se il tuo browser blocca i cookie di terze parti
2. 2. Verifica che il localStorage sia abilitato (richiesto per salvare il consenso)
3. 3. Controlla se sei in modalità privata/incognito (i cookie non persistono)
4. 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. 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 con Consent Mode v2

### Google Analytics non riceve i segnali di consenso

#### Abilita Consent Mode v2

1. 1. Vai a Dashboard CookieBeam → Impostazioni Banner
2. 2. Abilita "Google Consent Mode v2"
3. 3. Salva le modifiche
4. 4. In GA4, controlla il report in tempo reale per i segnali di consenso
5. 5. Dovresti vedere "granted" o "denied" per analytics_storage

#### Verifica la configurazione di GA4

1. 1. In GTM, apri il tuo tag di configurazione GA4
2. 2. Verifica che sia impostato per usare la modalità consenso
3. 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. 1. Apri la console del browser (F12)
2. 2. Digita: window.dataLayer
3. 3. Cerca gli eventi "consent"
4. 4. Dovresti vedere gli eventi di aggiornamento quando l'utente accetta/rifiuta
5. 5. Formato: event "consent", consent_update ...

## Problemi di scansione dei cookie

### Lo scanner non rileva tutti i cookie

#### Metodi di scansione multipli

1. 1. Prova sia il metodo di scansione automatico che quello manuale
2. 2. Scansione manuale: visita tutte le pagine importanti prima di completare la scansione
3. 3. Alcuni cookie appaiono solo dopo azioni specifiche (login, checkout, ecc.)
4. 4. I cookie di terze parti potrebbero richiedere l'interazione dell'utente per apparire

### Categorie di cookie errate

#### Categorizzazione manuale

1. 1. Vai a Dashboard → Scanner Cookie → Risultati
2. 2. Fai clic sul cookie categorizzato erroneamente
3. 3. Cambia la categoria manualmente
4. 4. CookieBeam impara dalle tue correzioni

## Problemi di prestazioni

### Il banner si carica lentamente

#### Ottimizza il caricamento

1. 1. Mantieni il loader sincrono e come primo elemento nell'head della pagina; escludilo dagli ottimizzatori di ritardo degli script.
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

#### Loader sincrono

1. 1. Non aggiungere async o defer al loader del banner.
2. 2. Utilizza l'URL canonico del loader dalla scheda di installazione del banner.
3. 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](mailto:support@cookiebeam.com) [❓ FAQ Domande comuni Risposte rapide](https://cookiebeam.com/guides) [📚 Centro di apprendimento Guide e tutorial Documentazione approfondita](https://cookiebeam.com/guides)

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