Menu della documentazione

Microsoft Ads (UET)

Trasmettere lo stato del consenso al tag Microsoft Advertising (UET): attivazione, funzionamento del segnale ad_storage e verifica.

Microsoft UET Consent Mode

CookieHug può trasmettere lo stato del consenso al tag Microsoft Advertising (UET), l'equivalente di Google Consent Mode per Bing Ads. Microsoft richiede un segnale di consenso (ad_storage) per il traffico proveniente dallo Spazio economico europeo; senza di esso conversioni e remarketing in Microsoft Ads smettono di funzionare correttamente.

La funzione è disattivata per impostazione predefinita e si abilita per dominio. CookieHug non installa il tag UET: ne governa soltanto il consenso. Funziona sia che UET sia incorporato direttamente sia tramite Google Tag Manager.

Attivazione

  • Apri il dominio nella dashboard → Avanzate → sezione Politica di consenso.
  • Trova la scheda Microsoft UET Consent Mode (Bing / Microsoft Ads) e sposta l'interruttore: il salvataggio è automatico.
  • La modifica arriva nello script del banner al successivo scaricamento (cache dello script: fino a 5 minuti).

Come funziona il segnale

Prima che il tag UET (bat.js) venga eseguito, l'SDK inserisce uno stato di consenso predefinito nella coda window.uetq. Se il visitatore ha già una decisione salvata, il valore predefinito la rispecchia subito:

// prima della decisione dell'utente (o dopo un rifiuto):
window.uetq.push('consent', 'default', { ad_storage: 'denied' });

// dopo il consenso alla categoria Marketing (anche al ritorno con consenso salvato):
window.uetq.push('consent', 'update', { ad_storage: 'granted' });

Un aggiornamento viene inviato dopo ogni decisione: accettazione, rifiuto, modifica e revoca. Il segnale deriva dalla categoria Marketing, esattamente la stessa che governa ad_storage in Google Consent Mode. Importante: lo snippet di CookieHug deve caricarsi prima del tag UET (la stessa regola valida per i tag Google), così il valore predefinito entra nella coda prima che bat.js la elabori.

Verifica

Nei DevTools, su una pagina con la funzione attiva:

// subito dopo l'ingresso (prima di qualsiasi decisione):
window.uetq
// → in coda: ['consent', 'default', { ad_storage: 'denied' }]

// dopo il clic su «Accetta tutto»:
// → si aggiunge: ['consent', 'update', { ad_storage: 'granted' }]

Puoi controllare lo stato anche con l'estensione UET Tag Helper di Microsoft. Se window.uetq non esiste, la pagina non ha il tag UET: il segnale di CookieHug resta allora inerte in coda e non rompe nulla.