Passa al contenuto principale

Marcatura manuale (v2)

Se il tuo sito usa il banner v3

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​

  1. Aggiungi all'elemento l'attributo data-managed="as-oil".
  2. Cambia l'attributo type dello script in as-oil. Il browser non riconosce il tipo e non lancia lo script.
  3. Se lo script non è JavaScript normale, aggiungi data-type con il tipo originale, per esempio module.
  4. Se lo script è in un file separato, aggiungi data-src con il percorso del file .js.
  5. Aggiungi gli attributi dei requisiti (tabella sotto).
AttributoCosa richiede
data-purposesGli id delle finalità IAB, separati da virgola
data-legintsGli id delle finalità IAB con base giuridica di legittimo interesse
data-special-featuresGli id delle special feature IAB
data-iab-vendorL'id del fornitore IAB
data-custom-vendorL'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 vuotoBanner v2Banner v3
data-purposes=""Richiede tutte le finalità, IAB e personalizzateLo 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 6Lo script resta bloccato
data-special-features=""Richiede tutte le special featureLo script resta bloccato
data-iab-vendor="" e data-custom-vendor=""Non richiede nienteNon 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​

  1. Apri la pagina senza dare il consenso. Controlla che lo script non parta.
  2. Nel pannello delle preferenze consenti le finalità e il fornitore richiesti, e salva.
  3. 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 type valga as-oil e che data-managed valga as-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-legints o data-special-features vuoto, oppure lo spazio web non ha l'add-on di blocco preventivo. Vedi Retrocompatibilità con il banner v2.

Ultimo aggiornamento: 10/11/2026.