Passa al contenuto principale

Marcare script e iframe

Il blocco preventivo manuale tiene fermi script e iframe finché il visitatore non dà il consenso richiesto. Scrivi la marcatura nell'HTML e il banner sblocca l'elemento quando il consenso c'è.

Banner v2

Il banner v2 usa un'altra marcatura, con data-managed="as-oil". Vedi Marcatura manuale (v2). Se non sai quale banner usa il tuo sito, leggi Quale banner sta usando il tuo sito.

A chi serve​

Serve a chi modifica a mano l'HTML del sito e inserisce script o iframe di terze parti, come un widget, un video o una mappa. Il plugin WordPress scrive la marcatura da solo, come spiega la guida Blocco preventivo con il plugin WordPress.

Prerequisiti​

Prima di cominciare controlla che:

  • il sito carichi lo snippet del banner;
  • lo spazio web abbia almeno un fornitore custom con un URL di blocco preventivo, e la lista fornitori sia pubblicata. Questa condizione accende l'add-on preemptive-block, che sblocca gli elementi marcati. Serve anche se gli elementi non li marca il plugin WordPress ma li marchi tu. Senza l'add-on gli elementi restano bloccati per sempre.

Impostare l'URL di blocco preventivo​

  1. Apri nella dashboard la pagina Lista fornitori dello spazio web.
  2. Individua il fornitore custom nella tabella.
  3. Apri il menu Altre azioni della sua riga.
  4. Scegli Modifica URL blocco preventivo.
  5. In Inserisci l'URL per il blocco preventivo scrivi l'URL che compare nell'attributo src dello script del fornitore, poi aggiungilo con il pulsante con il segno più.
  6. Conferma con Modifica.
  7. Pubblica la lista con Salva e pubblica lista fornitori.

Il fornitore deve essere pubblicato e visibile. I fornitori IAB, quelli del catalogo Google e quelli senza cookie non hanno la voce.

L'ID del fornitore

La marcatura usa l'ID del fornitore custom, per esempio d116, nella colonna ID della tabella Lista fornitori. Un fornitore inserito a mano ha un ID che inizia con c, uno preso dal catalogo un ID che inizia con d.

Step​

Script esterno​

  1. Cambia il type dello script in text/avacy-blocked, così il browser non lo esegue.
  2. Sposta l'indirizzo dal src a data-avacy-src.
  3. Aggiungi data-avacy-requires con il consenso richiesto.
<script type="text/avacy-blocked"
data-avacy-src="https://example.com/widget.js"
data-avacy-requires="custom:vendor:d116"></script>

Script inline​

  1. Cambia il type in text/avacy-blocked.
  2. Aggiungi data-avacy-requires. Lascia il codice dentro il tag com'è.
<script type="text/avacy-blocked"
data-avacy-requires="custom:vendor:d116">
console.log('Questo script parte dopo il consenso a d116');
</script>

Modulo ES​

Aggiungi data-avacy-type="module". Il banner rimette quel type allo sblocco.

<script type="text/avacy-blocked"
data-avacy-type="module"
data-avacy-src="https://example.com/widget.mjs"
data-avacy-requires="custom:vendor:d116"></script>

Iframe​

  1. Togli l'attributo src.
  2. Scrivi lo stesso indirizzo in data-avacy-src.
  3. Aggiungi data-avacy-requires.
<iframe data-avacy-src="https://www.youtube.com/embed/ID_DEL_VIDEO"
data-avacy-requires="custom:vendor:d116"
width="560" height="315"
title="Video"></iframe>

Sostituisci d116 con l'ID del tuo fornitore. Senza consenso l'iframe resta vuoto e il banner non mostra testi o pulsanti al suo posto.

Il banner non legge il valore di type: funziona qualunque tipo che il browser non esegue, e text/avacy-blocked è la convenzione. Allo sblocco il banner sostituisce lo script con un nodo nuovo che conserva gli altri attributi, e rimette il src all'iframe togliendo gli attributi di blocco. Un elemento senza data-avacy-requires viene ignorato.

La sintassi di data-avacy-requires​

data-avacy-requires="custom:vendor:d116;tcf:purpose:1,8,9"

Le regole della sintassi:

  • un requisito ha tre parti separate da :, nella forma framework:asse:id;
  • ; separa un requisito dal successivo;
  • , separa più id dentro lo stesso requisito;
  • il banner sblocca l'elemento solo quando tutti i requisiti e tutti gli id sono concessi. Con tcf:purpose:1,8,9 servono le finalità 1, 8 e 9.
AsseCosa controllaEsempio
vendorIl consenso a un fornitorecustom:vendor:d116, tcf:vendor:755
purposeIl consenso a una finalità. Con custom legge le finalità customgcm:purpose:4, tcf:purpose:1, custom:purpose:3
specialFeatureIl consenso a una special feature IABtcf:specialFeature:1
legintIl legittimo interesse sulla finalità, che il banner distingue dal consensotcf:legint:2

La prima parte, framework, dice da quale sistema di consenso dello spazio web leggere la scelta: custom per i fornitori e le finalità custom, tcf per IAB TCF, gcm per la Google Consent Mode. Per i tag Google vedi Tag Google con gtag.

Il banner valuta ogni requisito così:

  1. prima della scelta del visitatore non sblocca nulla;
  2. se il fornitore, la finalità o la special feature indicati nel requisito, per esempio d116 in custom:vendor:d116, non compaiono tra le scelte registrate del visitatore, il requisito non è concesso;
  3. se il requisito nomina un framework che lo spazio web non ha, il banner usa il fornitore custom indicato nella stessa marcatura. Senza un requisito custom:vendor:..., l'elemento resta bloccato.

Con IAB TCF acceso chiedi a mano solo finalità e special feature che il fornitore custom dichiara, e solo come consenso. Il banner registra una finalità IAB solo se la dichiara almeno un fornitore della lista, IAB o custom. Una richiesta su una finalità che nessuno dichiara, o su legint quando lo spazio web non offre il legittimo interesse, lascia l'elemento bloccato anche dopo Accetta cookie.

L'ordine di esecuzione​

Il banner sblocca gli elementi con queste regole:

  • segue l'ordine del documento;
  • gli script esterni scaricano in parallelo e partono in ordine;
  • uno script inline aspetta gli script esterni che lo precedono, per al massimo 5 secondi ciascuno;
  • una scelta nuova rivaluta gli elementi ancora bloccati e sblocca ciò che ora è concesso;
  • il banner non blocca di nuovo uno script già partito: un consenso ritirato ha effetto dal caricamento successivo.

Verifica​

  1. Apri la pagina in una finestra privata, senza dare il consenso. Lo script non parte e l'iframe non ha l'attributo src.
  2. Scegli Accetta cookie. Lo script parte e l'iframe riceve il src.
  3. Ripeti con Rifiuta tutto. Gli elementi con un requisito concreto restano bloccati.

Per i controlli nel pannello Network e nel dataLayer vedi Verificare il blocco.

Problemi comuni​

Lo script non parte mai, nemmeno dopo Accetta cookie: manca il fornitore custom pubblicato con URL di blocco, quindi l'add-on resta spento (vedi Prerequisiti), oppure la marcatura è illeggibile (vedi sotto).

Marcatura illeggibile: l'elemento resta bloccato e, con i log attivi (window.Avacy.debugModeOn(), vedi Ordine dei tag Google e debug mode), la console del CMP registra unreadable marking, left blocked tra i messaggi di livello info. Le cause più comuni:

  • separatore sbagliato: custom:vendor:d116:tcf:purpose:1 usa : dove serve ;. Scrivi custom:vendor:d116;tcf:purpose:1;
  • asse sconosciuto (gcm:purposes:4) o id mancante (gcm:purpose:);
  • framework con le maiuscole: GCM è diverso da gcm.

Attributo vuoto: con data-avacy-requires="" il banner sblocca l'elemento alla prima scelta valida, anche con Rifiuta tutto, perché non richiede nulla. Scrivi il requisito se lo script traccia il visitatore.

Sito con CSP e nonce: se script-src accetta solo script con un nonce, metti il nonce del sito anche sugli script marcati. Il banner li sblocca mantenendo il loro nonce. Senza nonce la CSP li blocca anche dopo il consenso. Vedi Script con nonce.

Tutte le finalità: il banner non ha una forma per "tutte le finalità". Scrivile una per una, per esempio tcf:purpose:1,2,3,4,5,6,7,8,9,10.

Iframe con src ancora presente: si carica subito. Sposta l'indirizzo in data-avacy-src.


Ultimo aggiornamento: 27/10/2026.