Eventi JavaScript (v2)
Questa pagina descrive il banner v2. Per il banner v3 vedi Eventi.
Questa pagina elenca gli eventi che il banner v2 invia al sito e mostra come ascoltarli.
A chi serve
Serve a chi ha aggiunto al sito un listener sugli eventi del banner v2, per esempio per attivare uno strumento dopo il consenso.
Prerequisiti
Prima di cominciare controlla che:
- il sito carichi il banner v2;
- tu possa aggiungere uno script alla pagina.
Gli eventi del window
Il banner v2 emette tre CustomEvent sul window.
| Evento | Quando parte |
|---|---|
avacy_consent | Al caricamento della pagina (detail.trigger vale page_load) e a ogni salvataggio (consent_update) |
avacy_interaction | A ogni click sui pulsanti di scelta del banner |
avacy_reject_all | Quando il visitatore rifiuta tutto o chiude il banner senza scegliere |
Il detail di avacy_reject_all ha consent ('reject-all' o 'close-banner') e layer, che vale sempre '1': il pulsante di rifiuto e la X stanno solo nel primo livello.
Proprietà di event.detail per avacy_consent
| Proprietà | Contenuto |
|---|---|
trigger | 'page_load' oppure 'consent_update' |
optin | true se il visitatore ha già salvato una scelta, anche un rifiuto. false alla prima visita, prima della scelta |
purposes | Gli id delle finalità IAB consentite |
customPurposes | Le finalità personalizzate, ognuna con id e i flag c (consenso) e li (legittimo interesse) |
legitimateInterests | Gli id delle finalità IAB con legittimo interesse |
specialFeatures | Gli id delle special feature IAB consentite |
customVendors | I fornitori personalizzati dello spazio web, ognuno con id e consent |
iabVendors | Gli id dei fornitori IAB con consenso |
iabVendorsWithConsent | I fornitori IAB con consenso e con tutte le finalità consentite, ognuno con id e name |
customVendorsWithConsent | I fornitori personalizzati con tutte le finalità consentite, ognuno con id e name |
gcm | L'array dei tipi di Google Consent Mode concessi, per esempio ['analytics_storage'] |
Valori di event.detail.optin per avacy_interaction
| Valore | Quando |
|---|---|
consent-all | Il visitatore preme il pulsante di accettazione |
reject-all | Il visitatore preme il pulsante di rifiuto |
save-preferences | Il visitatore salva le preferenze dal pannello |
close-banner | Il visitatore chiude il banner senza scegliere |
Ascoltare un evento
Il visitatore ha salvato una scelta. optin vale true anche dopo un rifiuto. Per sapere cosa ha consentito, leggi purposes e i fornitori.
<script>
window.addEventListener('avacy_consent', function (event) {
var data = event.detail;
if (!data.optin) {
console.log("Il visitatore non ha ancora scelto.");
return;
}
console.log("Finalità IAB consentite: " + data.purposes.join(', '));
});
</script>
Pulsante premuto.
<script>
window.addEventListener('avacy_interaction', function (event) {
if (event.detail.optin === 'consent-all') {
console.log("Il visitatore ha accettato dal pulsante.");
} else if (event.detail.optin === 'save-preferences') {
console.log("Il visitatore ha salvato le preferenze.");
}
});
</script>
Fornitori personalizzati e loro stato.
<script>
window.addEventListener('avacy_consent', function (event) {
var vendors = event.detail.customVendors || [];
vendors.forEach(function (vendor) {
console.log('id: ' + vendor.id + ' consenso: ' + vendor.consent);
});
});
</script>
Consenso a Google (fornitore 755 della lista IAB TCF), solo al salvataggio (consent_update).
<script>
window.addEventListener('avacy_consent', function (event) {
var data = event.detail;
if (data.trigger !== 'consent_update') return;
var vendorId = 755;
var consented = data.iabVendorsWithConsent.some(function (vendor) {
return vendor.id === vendorId;
});
console.log('Consenso al fornitore ' + vendorId + ': ' + consented);
});
</script>
Consenso a una o più finalità.
<script>
window.addEventListener('avacy_consent', function (event) {
var purposes = event.detail.purposes;
var required = [1, 3];
var allowed = required.every(function (id) {
return purposes.indexOf(id) !== -1;
});
console.log('Consenso alle finalità ' + required.join(', ') + ': ' + allowed);
});
</script>
Gli eventi postMessage
Il banner v2 invia anche messaggi con window.postMessage. Ogni messaggio è una stringa con il nome dell'evento.
| Evento | Quando parte |
|---|---|
oil-checked-optin | Il banner ha trovato un consenso già salvato e ancora valido |
oil_shown | Il banner è stato mostrato |
oil_optin_done_button_clicked | Il visitatore ha premuto un pulsante di accettazione |
oil_optin_done | Il consenso è stato salvato |
oil_soi_optin_done | Il consenso è stato salvato nel cookie del sito |
oil_poi_optin_done | Il consenso è stato salvato anche per il Power Opt-In |
oil_optout_done | Il banner ha cancellato il consenso salvato (opt-out) |
oil_close_banner_button_clicked | Il visitatore ha chiuso il banner |
oil_as_cpc_privacy_selected | Il visitatore ha salvato una scelta diversa da Accetta tutto, per esempio dal pannello o con la X |
oil_click_advanced_settings | Il visitatore ha aperto le impostazioni avanzate |
Evento postMessage.
<script>
window.addEventListener('message', function (event) {
if (event.data === 'oil_shown') {
console.log('Il banner è stato mostrato.');
}
});
</script>
Lo storico degli eventi
AVACY.eventCollection elenca gli eventi postMessage già inviati. AVACY.isInCollection(nome) restituisce quante volte l'evento è nell'elenco, o 0 se manca.
console.log(AVACY.eventCollection);
// [ { name: 'oil-checked-optin', timestamp: 1735816751078 }, … ]
if (AVACY.isInCollection('oil_optin_done') > 0) {
console.log("L'evento oil_optin_done è già stato inviato.");
}
Verifica
- Aggiungi alla pagina uno dei listener, ricarica e apri la console del browser.
- Scegli un'opzione sul banner.
- Controlla che il listener scriva il messaggio in console.
Problemi comuni
I problemi più frequenti:
- Il listener su
consent_updatenon scatta mai:consent_updatenon è un evento. Ascoltaavacy_consente controllaevent.detail.trigger; - Il listener su
avacy_consentscatta a ogni caricamento di pagina: il banner v2 emette l'evento anche contriggeruguale apage_load. Filtra suevent.detail.trigger; - La console scrive
eventCollection is not defined:eventCollectionè una proprietà diAVACY. UsaAVACY.eventCollection; - Dopo il passaggio al banner v3 alcuni listener non scattano: il banner v3 emette ancora
avacy_consent, ma nonavacy_interaction,avacy_reject_alle gli eventipostMessage. Vedi Retrocompatibilità con il banner v2.
Ultimo aggiornamento: 09/11/2026.