Passa al contenuto principale

Leggere il consenso

La funzione window.Avacy.getConsent() del banner restituisce la scelta del visitatore in tre viste dello stesso dato.

Banner v2

Il banner v2 non offre window.Avacy.getConsent(). Vedi Eventi JavaScript (v2). Se non sai quale banner usa il tuo sito, leggi Quale banner sta usando il tuo sito.

Prerequisiti​

Prima di cominciare controlla che:

  • il banner sia installato nella pagina. Vedi Snippet HTML;
  • il codice giri dopo il caricamento del banner. Per capire quando, vedi Eventi del banner.

Cosa restituisce getConsent​

window.Avacy.getConsent(): Consent | null

La funzione restituisce null finché il banner non ha finito l'avvio. Dopo l'avvio restituisce un oggetto con uno di questi tre stati.

StatoQuando
{ ready: false }Il banner è avviato e non ha ancora letto il consenso salvato.
{ ready: true, valid: false }Il banner ha letto il consenso e il visitatore non ne ha uno utilizzabile.
{ ready: true, valid: true, type, timestamp, choices }Il visitatore ha un consenso salvato e valido.

Lo stato valido contiene anche questi campi.

CampoContenuto
typeTipo di scelta salvata: 'AcceptAll', 'RejectAll' o 'Personalized'.
timestampMomento della scelta, in millisecondi dal 1970.
consentIdIdentificativo del consenso nell'archivio consensi. Compare solo con l'archiviazione dei consensi del banner attiva, dopo che l'archivio ha registrato la scelta. Per attivarla, vedi Archivio dei consensi.

Le tre viste​

VistaCampiQuando usarla
Macrotype, timestampSapere se il visitatore ha accettato tutto, rifiutato tutto o scelto a mano.
Mappapurposes, specialFeatures, vendorsDecidere su una finalità o un fornitore preciso.
ElencochoicesScorrere tutte le scelte.

I campi purposes, specialFeatures, vendors e choices ci sono sempre. Negli stati senza consenso valgono {}, {}, {} e [].

Vista mappa​

Ogni mappa ha la forma mappa[framework][id] = true | false. Il framework è tcf, gcm, acm o custom. Un framework non configurato non ha la chiave.

Il contenuto delle tre mappe:

  • purposes contiene le finalità e le finalità dei fornitori custom;
  • specialFeatures contiene le funzionalità speciali del TCF. Hanno gli stessi id 1 e 2 delle finalità 1 e 2, quindi stanno in una mappa a parte;
  • vendors contiene i fornitori. L'id dei fornitori TCF è un numero. L'id dei fornitori custom è un testo, per esempio 'd116'. La dashboard mostra l'id nella colonna ID dell'elenco dei fornitori.

Le chiavi delle mappe sono testi: purposes.tcf[1] e purposes.tcf['1'] danno lo stesso risultato.

Le finalità di Google Consent Mode hanno questi id.

IdPermesso Google
1ad_storage
2ad_user_data
3ad_personalization
4analytics_storage
5functionality_storage
6personalization_storage
7security_storage

Vista elenco​

Ogni voce di choices ha questa forma.

{ framework: 'tcf' | 'gcm' | 'acm' | 'custom', type: string, id: number | string, hasConsent?: boolean, hasLegitimateInterest?: boolean }

L'elenco contiene anche voci di sola informazione, per esempio le finalità speciali del TCF (type: 'specialPurpose'). Il visitatore non può sceglierle, quindi non usarle per decidere se avviare uno script.

Consenso assente, scaduto o rifiutato​

Lo stato valid: false indica che il visitatore non ha un consenso utilizzabile, non che ha rifiutato. Il banner lo restituisce in questi casi:

  • il visitatore non ha ancora scelto;
  • il consenso salvato è scaduto;
  • il consenso salvato appartiene a una versione precedente della policy;
  • il banner non riesce a leggere il valore salvato.

Chi rifiuta tutto ha un consenso valido: valid: true, type: 'RejectAll' e tutte le mappe a false.

Con valid: false non avviare gli script che richiedono il consenso e non trattare il caso come un rifiuto.

Esempi​

Gli esempi funzionano incollati nella console del browser, a banner caricato.

Leggere il consenso e distinguere i casi​

function descriviConsenso() {
var consent = window.Avacy.getConsent();

if (!consent) return 'banner non ancora avviato';
if (!consent.ready) return 'consenso non ancora letto';
if (!consent.valid) return 'nessun consenso valido (assente, scaduto o da rinnovare)';
return 'scelta salvata: ' + consent.type + ', ' + new Date(consent.timestamp).toISOString();
}

console.log(descriviConsenso());

Decidere su una finalità o un fornitore​

function haConsensoMarketing() {
var consent = window.Avacy.getConsent();
if (!consent || !consent.ready || !consent.valid) return false;

// Google Consent Mode, finalità 1 (ad_storage)
var conGoogle = !!(consent.purposes.gcm && consent.purposes.gcm[1]);

// TCF, finalità 1 e fornitore 52
var conTcf = !!(
consent.purposes.tcf && consent.purposes.tcf[1] &&
consent.vendors.tcf && consent.vendors.tcf[52]
);

return conGoogle || conTcf;
}

console.log(haConsensoMarketing());

I numeri 1 e 52 sono segnaposto. Sostituiscili con gli id del tuo spazio web. Gli id dei fornitori TCF sono quelli della Global Vendor List di IAB Europe. La dashboard li mostra nella colonna ID dell'elenco dei fornitori. Gli id di Google Consent Mode sono nella tabella sopra.

Scorrere tutte le scelte​

function elencaScelte() {
var consent = window.Avacy.getConsent();
if (!consent || !consent.ready || !consent.valid) return [];

return consent.choices.map(function (choice) {
return choice.framework + ':' + choice.type + ':' + choice.id + ' = ' + choice.hasConsent;
});
}

console.log(elencaScelte());

Verifica​

  1. Apri una pagina con il banner senza scegliere. window.Avacy.getConsent() risponde con ready: true e valid: false.
  2. Clicca Rifiuta tutto, se la configurazione del banner lo mostra. getConsent() risponde con valid: true e type: 'RejectAll'.
  3. Ricarica la pagina. La risposta resta uguale, perché il banner rilegge il consenso salvato.

Problemi comuni​

I problemi più frequenti:

  • getConsent() restituisce null: il banner non ha finito l'avvio. Aspetta l'evento avacy:ready. Se window.Avacy non esiste, lo snippet manca nella pagina oppure il bundle non è ancora caricato;
  • getConsent() restituisce ready: false: il banner non ha ancora caricato il consenso salvato. Usa l'evento avacy:consent-loaded;
  • Una finalità o un fornitore risulta undefined: il framework o l'id non sono nella configurazione del banner. Controlla con Object.keys(consent.purposes);
  • Una funzionalità speciale del TCF non compare in purposes: le funzionalità speciali stanno in specialFeatures;
  • consentId manca anche con l'archiviazione attiva: l'archivio accetta solo le scelte che arrivano dai domini dello spazio web. In locale o su un dominio di prova non presente fra quelli dello spazio, la scelta non viene archiviata.

Ultimo aggiornamento: 27/10/2026.