Marcatura manuale (v2)
Questa pagina descrive il banner v2. Per il banner v3 vedi Marcare gli script.
Questa pagina spiega come marcare a mano uno <script> o un <iframe>, perché il banner v2 lo blocchi fino al consenso.
A chi serve
Questa pagina serve a chi ha installato il banner v2 con lo snippet HTML e vuole bloccare a mano gli script dei fornitori.
Prerequisiti
Prima di cominciare controlla che:
- il sito carichi il banner v2;
- tu conosca gli id delle finalità IAB e l'id del fornitore che lo script richiede. L'id di un fornitore personalizzato ha una forma come
d116.
Step
- Aggiungi all'elemento l'attributo
data-managed="as-oil". - Cambia l'attributo
typedello script inas-oil. Il browser non riconosce il tipo e non lancia lo script. - Se lo script non è JavaScript normale, aggiungi
data-typecon il tipo originale, per esempiomodule. - Se lo script è in un file separato, aggiungi
data-srccon il percorso del file.js. - Aggiungi gli attributi dei requisiti (tabella sotto).
| Attributo | Cosa richiede |
|---|---|
data-purposes | Gli id delle finalità IAB, separati da virgola |
data-legints | Gli id delle finalità IAB con base giuridica di legittimo interesse |
data-special-features | Gli id delle special feature IAB |
data-iab-vendor | L'id del fornitore IAB |
data-custom-vendor | L'id del fornitore personalizzato |
L'elemento si attiva solo quando il visitatore soddisfa tutti i requisiti presenti. Il banner v2 li legge insieme, come un AND.
Un attributo assente non richiede niente. Un attributo presente ma vuoto si comporta in modo diverso nei due banner, tranne quelli dei fornitori.
| Attributo presente ma vuoto | Banner v2 | Banner v3 |
|---|---|---|
data-purposes="" | Richiede tutte le finalità, IAB e personalizzate | Lo script resta bloccato |
data-legints="" | Lo script resta bloccato. Il banner v2 richiede il legittimo interesse per le finalità da 2 a 10, ma non lo dà mai alle finalità 3, 4, 5 e 6 | Lo script resta bloccato |
data-special-features="" | Richiede tutte le special feature | Lo script resta bloccato |
data-iab-vendor="" e data-custom-vendor="" | Non richiede niente | Non richiede niente |
Le regole del TCF 2.2 non ammettono il legittimo interesse per le finalità IAB 3, 4, 5 e 6: per queste vale solo il consenso. Vedi Understanding the upcoming Transparency & Consent Framework v2.2 di IAB Europe.
Questo esempio blocca uno script finché il visitatore consente le finalità 1, 2 e 4 e il fornitore d116.
<script data-managed="as-oil"
data-type="text/javascript"
data-src="path/to/the/script.js"
data-purposes="1,2,4"
data-custom-vendor="d116"
type="as-oil"></script>
Il banner v2 gestisce anche gli <iframe>. Per un iframe il banner v2 rimette al loro posto gli attributi src, href, title, display e type copiandoli da data-src, data-href, data-title, data-display e data-type.
Verifica
- Apri la pagina senza dare il consenso. Controlla che lo script non parta.
- Nel pannello delle preferenze consenti le finalità e il fornitore richiesti, e salva.
- Ricarica la pagina e controlla che lo script parta. Se avevi già fatto una scelta sul banner, il banner v2 sblocca gli script solo dopo il ricaricamento.
Problemi comuni
I problemi più frequenti:
- Lo script parte subito: controlla che
typevalgaas-oile chedata-managedvalgaas-oil; - Lo script non parte mai: controlla che gli id nei requisiti esistano nello spazio web. Con il banner v2 un id che non esiste blocca lo script;
- Dopo il passaggio al banner v3 lo script resta bloccato: l'elemento ha
data-purposes,data-legintsodata-special-featuresvuoto, oppure lo spazio web non ha l'add-on di blocco preventivo. Vedi Retrocompatibilità con il banner v2.
Ultimo aggiornamento: 10/11/2026.