Leggere il consenso
La funzione window.Avacy.getConsent() del banner restituisce la scelta del visitatore in tre viste dello stesso dato.
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.
| Stato | Quando |
|---|---|
{ 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.
| Campo | Contenuto |
|---|---|
type | Tipo di scelta salvata: 'AcceptAll', 'RejectAll' o 'Personalized'. |
timestamp | Momento della scelta, in millisecondi dal 1970. |
consentId | Identificativo 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
| Vista | Campi | Quando usarla |
|---|---|---|
| Macro | type, timestamp | Sapere se il visitatore ha accettato tutto, rifiutato tutto o scelto a mano. |
| Mappa | purposes, specialFeatures, vendors | Decidere su una finalità o un fornitore preciso. |
| Elenco | choices | Scorrere 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:
purposescontiene le finalità e le finalità dei fornitori custom;specialFeaturescontiene le funzionalità speciali del TCF. Hanno gli stessi id 1 e 2 delle finalità 1 e 2, quindi stanno in una mappa a parte;vendorscontiene 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.
| Id | Permesso Google |
|---|---|
| 1 | ad_storage |
| 2 | ad_user_data |
| 3 | ad_personalization |
| 4 | analytics_storage |
| 5 | functionality_storage |
| 6 | personalization_storage |
| 7 | security_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
- Apri una pagina con il banner senza scegliere.
window.Avacy.getConsent()risponde conready: trueevalid: false. - Clicca Rifiuta tutto, se la configurazione del banner lo mostra.
getConsent()risponde convalid: trueetype: 'RejectAll'. - Ricarica la pagina. La risposta resta uguale, perché il banner rilegge il consenso salvato.
Problemi comuni
I problemi più frequenti:
getConsent()restituiscenull: il banner non ha finito l'avvio. Aspetta l'eventoavacy:ready. Sewindow.Avacynon esiste, lo snippet manca nella pagina oppure il bundle non è ancora caricato;getConsent()restituisceready: false: il banner non ha ancora caricato il consenso salvato. Usa l'eventoavacy:consent-loaded;- Una finalità o un fornitore risulta
undefined: il framework o l'id non sono nella configurazione del banner. Controlla conObject.keys(consent.purposes); - Una funzionalità speciale del TCF non compare in
purposes: le funzionalità speciali stanno inspecialFeatures; consentIdmanca 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.