Passa al contenuto principale

Eventi JavaScript (v2)

Se il tuo sito usa il banner v3

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.

EventoQuando parte
avacy_consentAl caricamento della pagina (detail.trigger vale page_load) e a ogni salvataggio (consent_update)
avacy_interactionA ogni click sui pulsanti di scelta del banner
avacy_reject_allQuando 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àContenuto
trigger'page_load' oppure 'consent_update'
optintrue se il visitatore ha già salvato una scelta, anche un rifiuto. false alla prima visita, prima della scelta
purposesGli id delle finalità IAB consentite
customPurposesLe finalità personalizzate, ognuna con id e i flag c (consenso) e li (legittimo interesse)
legitimateInterestsGli id delle finalità IAB con legittimo interesse
specialFeaturesGli id delle special feature IAB consentite
customVendorsI fornitori personalizzati dello spazio web, ognuno con id e consent
iabVendorsGli id dei fornitori IAB con consenso
iabVendorsWithConsentI fornitori IAB con consenso e con tutte le finalità consentite, ognuno con id e name
customVendorsWithConsentI fornitori personalizzati con tutte le finalità consentite, ognuno con id e name
gcmL'array dei tipi di Google Consent Mode concessi, per esempio ['analytics_storage']

Valori di event.detail.optin per avacy_interaction​

ValoreQuando
consent-allIl visitatore preme il pulsante di accettazione
reject-allIl visitatore preme il pulsante di rifiuto
save-preferencesIl visitatore salva le preferenze dal pannello
close-bannerIl 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.

EventoQuando parte
oil-checked-optinIl banner ha trovato un consenso già salvato e ancora valido
oil_shownIl banner è stato mostrato
oil_optin_done_button_clickedIl visitatore ha premuto un pulsante di accettazione
oil_optin_doneIl consenso è stato salvato
oil_soi_optin_doneIl consenso è stato salvato nel cookie del sito
oil_poi_optin_doneIl consenso è stato salvato anche per il Power Opt-In
oil_optout_doneIl banner ha cancellato il consenso salvato (opt-out)
oil_close_banner_button_clickedIl visitatore ha chiuso il banner
oil_as_cpc_privacy_selectedIl visitatore ha salvato una scelta diversa da Accetta tutto, per esempio dal pannello o con la X
oil_click_advanced_settingsIl 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​

  1. Aggiungi alla pagina uno dei listener, ricarica e apri la console del browser.
  2. Scegli un'opzione sul banner.
  3. Controlla che il listener scriva il messaggio in console.

Problemi comuni​

I problemi più frequenti:

  • Il listener su consent_update non scatta mai: consent_update non è un evento. Ascolta avacy_consent e controlla event.detail.trigger;
  • Il listener su avacy_consent scatta a ogni caricamento di pagina: il banner v2 emette l'evento anche con trigger uguale a page_load. Filtra su event.detail.trigger;
  • La console scrive eventCollection is not defined: eventCollection è una proprietà di AVACY. Usa AVACY.eventCollection;
  • Dopo il passaggio al banner v3 alcuni listener non scattano: il banner v3 emette ancora avacy_consent, ma non avacy_interaction, avacy_reject_all e gli eventi postMessage. Vedi Retrocompatibilità con il banner v2.

Ultimo aggiornamento: 09/11/2026.