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'è.
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
- Apri nella dashboard la pagina Lista fornitori dello spazio web.
- Individua il fornitore custom nella tabella.
- Apri il menu Altre azioni della sua riga.
- Scegli Modifica URL blocco preventivo.
- In Inserisci l'URL per il blocco preventivo scrivi l'URL che compare nell'attributo
srcdello script del fornitore, poi aggiungilo con il pulsante con il segno più. - Conferma con Modifica.
- 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.
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
- Cambia il
typedello script intext/avacy-blocked, così il browser non lo esegue. - Sposta l'indirizzo dal
srcadata-avacy-src. - Aggiungi
data-avacy-requirescon 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
- Cambia il
typeintext/avacy-blocked. - 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
- Togli l'attributo
src. - Scrivi lo stesso indirizzo in
data-avacy-src. - 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 formaframework: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,9servono le finalità 1, 8 e 9.
| Asse | Cosa controlla | Esempio |
|---|---|---|
vendor | Il consenso a un fornitore | custom:vendor:d116, tcf:vendor:755 |
purpose | Il consenso a una finalità. Con custom legge le finalità custom | gcm:purpose:4, tcf:purpose:1, custom:purpose:3 |
specialFeature | Il consenso a una special feature IAB | tcf:specialFeature:1 |
legint | Il legittimo interesse sulla finalità, che il banner distingue dal consenso | tcf: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ì:
- prima della scelta del visitatore non sblocca nulla;
- se il fornitore, la finalità o la special feature indicati nel requisito, per esempio
d116incustom:vendor:d116, non compaiono tra le scelte registrate del visitatore, il requisito non è concesso; - 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
- Apri la pagina in una finestra privata, senza dare il consenso. Lo script non parte e l'iframe non ha l'attributo
src. - Scegli Accetta cookie. Lo script parte e l'iframe riceve il
src. - 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:1usa:dove serve;. Scrivicustom:vendor:d116;tcf:purpose:1; - asse sconosciuto (
gcm:purposes:4) o id mancante (gcm:purpose:); - framework con le maiuscole:
GCMè diverso dagcm.
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.