Passa al contenuto principale

Verificare che il banner funzioni

Questa pagina spiega come controllare il banner dopo l'installazione e come trovare la causa se non compare.

Banner v2

Il banner v2 non ha window.Avacy e scrive in console messaggi con il prefisso [avacy-loader-v2] (vedi Messaggi [avacy-loader-v2]). Se non sai quale banner usa il tuo sito, leggi Quale banner sta usando il tuo sito.

Prerequisiti​

Prima di cominciare controlla che:

  • lo snippet sia nel <head> del sito, come in Snippet HTML o nella pagina della tua piattaforma;
  • il banner dello spazio web sia pubblicato nella dashboard.

Step​

  1. Apri il sito in una finestra privata, che parte senza consensi salvati.
  2. Attendi la fine del caricamento. Il banner compare nella pagina.
  3. Apri la console degli strumenti per sviluppatori.
  4. Scrivi window.Avacy e premi Invio. La console mostra un oggetto.
  5. Scrivi window.Avacy.version e premi Invio. La console mostra la versione del banner.
  6. Cerca i messaggi che iniziano con [avacy-loader]. In un sito che funziona non ce ne sono.

Verifica​

window.Avacy esiste solo dopo l'avvio del banner e subito dopo il caricamento può essere ancora vuoto. Riprova dopo qualche secondo.

Dopo la scelta di un visitatore il banner non compare più e, se lo spazio web la prevede, compare l'icona delle preferenze. Per questo il controllo si fa in una finestra privata.

Problemi comuni​

Il banner non compare​

CausaCome riconoscerla (console o pagina)Cosa fare
Codice dello spazio web sbagliato, oppure banner non pubblicatobanner.json not loaded … (HTTP 404)Copia di nuovo lo snippet dalla dashboard e controlla che il banner sia pubblicato
La CSP blocca la configurazionebanner.json not loaded … (TypeError: Failed to fetch) e un errore di CSPAutorizza gli indirizzi descritti in Snippet HTML
La CSP blocca gli stiliNessun banner e l'avviso "The banner styles were blocked by the Content-Security-Policy…"Metti il nonce sullo snippet, come in Snippet HTML
La CSP con nonce blocca il bannerNessun banner e un errore di CSP su script-srcMetti il nonce del sito sullo snippet, come in Snippet HTML
Pagina in cacheIl sito mostra ancora la pagina senza snippetSvuota la cache del sito o del tema e ricarica la pagina
Consenso già salvato nel browserCompare l'icona delle preferenze, non il bannerProva in una finestra privata

Lo snippet è nella pagina due volte​

Due snippet uguali producono un solo banner e nessun errore, ma la pagina carica il loader due volte. Tieni un solo snippet per pagina.

Dopo una modifica nella dashboard il banner non cambia​

La CDN può servire la configurazione precedente per alcuni minuti. Attendi e ricarica la pagina senza cache.

Con il TCF attivo il banner scarica l'elenco dei fornitori IAB quando il visitatore sceglie. Se il download fallisce, il banner non salva nessun consenso e mostra "Si è verificato un problema tecnico: non è stato possibile salvare la scelta. Riprova più tardi.".

CausaCome riconoscerla (console)Cosa fare
La CSP blocca assets.avacy-cdn.com[Avacy] The site's Content Security Policy blocks … e un errore di CSPAutorizza gli indirizzi descritti in Snippet HTML
La rete o un'estensione del browser bloccano il download[Avacy] The IAB vendor list could not be downloaded from …Controlla la rete e disattiva le estensioni che bloccano le richieste

Rifiuta tutto, la X e Continua senza accettare non bloccano mai il visitatore: se il download fallisce, il banner si chiude fino alla fine della sessione del browser senza salvare nessun consenso. Alla sessione successiva il banner ricompare.

Messaggi [avacy-loader] della console​

Il loader scrive i messaggi in inglese.

MessaggioTipoCosa significaCosa fare
[avacy-loader] no ?webspace= in the install tag; the banner is not served.erroreLo snippet non contiene webspace. Il banner non parte.Copia lo snippet completo dalla dashboard.
[avacy-loader] banner.json not loaded from <indirizzo> (<motivo>); the banner is not served.erroreIl loader non ha scaricato la configurazione dello spazio web. Il banner non parte.Leggi il motivo tra parentesi, spiegato sotto.
[avacy-loader] '<nome>' is not part of this release; ignored.avvisoLa configurazione chiede un componente aggiuntivo che questa versione non include. Il loader lo ignora.Scrivi al supporto di Avacy con il nome del componente.
[avacy-loader] add-on '<nome>' failed to load (<motivo>).erroreIl loader non ha caricato un componente aggiuntivo, per esempio il blocco preventivo o l'archivio consensi.Controlla la rete e la CSP. Se il motivo è no definition named '<nome>' as default export, scrivi al supporto.
[avacy-loader] boot failederroreL'avvio si è interrotto. La console mostra l'errore subito dopo il messaggio.Copia l'errore e scrivi al supporto.
[avacy-loader] cannot find its own <script> tag.erroreIl loader non ritrova il proprio tag. Succede con un tag module il cui indirizzo non contiene webspace=.Incolla lo snippet della dashboard senza modificarlo.

Il motivo nel messaggio banner.json not loaded può essere uno di questi.

MotivoSignificato
HTTP 404 oppure HTTP 403La CDN non trova la configurazione. Il codice dello spazio web è sbagliato, oppure il banner non è pubblicato o è spento.
not an objectIl file scaricato non è una configurazione valida.
SyntaxError: …Il file scaricato non è un JSON valido.
TypeError: Failed to fetchLa richiesta non è arrivata, per la rete, per un blocco della CSP o per un'estensione del browser.

Messaggi [avacy-loader-v2]​

Un sito con banner v2 e snippet di Avacy scrive messaggi con il prefisso [avacy-loader-v2].

MessaggioTipo
[avacy-loader-v2] oil is already on this page; ignored.avviso
[avacy-loader-v2] #oil-configuration is on the page: oil follows its data-remote-config, not ?webspace=.avviso
[avacy-loader-v2] no ?webspace= in the install tag; the banner is not served.errore
[avacy-loader-v2] cannot find its own <script> tag.errore

Altri messaggi del banner​

MessaggioCosa significa
[Avacy] Google tags ran before the Consent Mode default or the TCF stub …Un tag Google è partito prima del banner. Leggi Ordine dei tag Google e debug mode.

Ultimo aggiornamento: 30/10/2026.