Passa al contenuto principale

Banner e API

Questa pagina elenca i cambiamenti del banner e dell'API che riguardano chi integra Avacy in un sito. Ogni voce indica versione, data e impatto sul sito. Le novità della dashboard e del plugin WordPress sono in Dashboard e plugin WordPress.

Le date sono quelle del deploy in produzione.

La versione del banner è in window.Avacy.version.

3.3.1 (17/11/2026)​

  • Un fornitore custom segnato come strettamente necessario mostra Sempre attivo nel pannello delle preferenze, al posto dell'interruttore. Ha sempre il consenso, anche con Rifiuta tutto e con la chiusura del banner, e non ha il legittimo interesse.
  • I fornitori senza il flag non cambiano.
  • Impatto sul sito: nessuna modifica da fare. Gli script di quel fornitore marcati per il blocco preventivo partono anche quando il visitatore rifiuta.

3.3.0 (11/11/2026)​

  • showPreferenceCenter() accetta un solo argomento facoltativo, un oggetto di opzioni: window.Avacy.showPreferenceCenter({ section: 'vendor' }). Il pannello si apre sempre in sovrimpressione.
  • Il primo argomento target delle versioni precedenti non c'è più. Il pannello montato dentro un elemento della pagina si apriva comunque in sovrimpressione, e un selettore senza risultati dava errore.
  • Impatto sul sito: se chiami showPreferenceCenter(undefined, { section: 'vendor' }), passa a showPreferenceCenter({ section: 'vendor' }). Con la forma vecchia la sezione viene ignorata e il pannello si apre dalla prima voce. Una chiamata con un selettore o un elemento apre il pannello in sovrimpressione, senza errori. Vedi Link "Preferenze cookie".

3.2.5 (06/11/2026)​

  • timestamp di getConsent() e di avacy:consent-loaded resta il momento della scelta anche dopo un ricaricamento della pagina. Prima diventava l'ora del caricamento. Per un consenso salvato da una versione precedente, il banner ricava il momento dalla scadenza del consenso.
  • Spazi web migrati dal banner v2: uno script con data-iab-vendor="" o data-custom-vendor="" non richiede niente e parte dopo la scelta, come nel v2. Con data-purposes="", data-legints="" o data-special-features="" lo script resta bloccato e la console lo segnala con un avviso.
  • Se la pagina è ancora in caricamento, il banner parte a DOMContentLoaded. Su Firefox l'import map di WordPress con un tema a blocchi torna a funzionare: menu e blocchi interattivi partono. Lo stub TCF e il default di Google Consent Mode restano immediati.
  • Impatto sul sito: nessuna modifica obbligatoria. Sugli spazi web migrati dal v2, elenca gli id negli attributi di finalità, legittimo interesse e special feature lasciati vuoti. Vedi Marcatura manuale (v2).

3.2.4 (02/11/2026)​

  • Lingua fuori configurazione: il banner usa l'inglese se è tra le lingue dello spazio web, altrimenti la lingua principale. Con la 3.2.3 usava sempre la lingua principale.
  • La regola vale anche per changeLanguage(). Prima mostrava una lingua non configurata con i testi standard di Avacy, senza i testi del cliente.
  • Impatto sul sito: nessuna modifica da fare. Se cambi le lingue nella dashboard, il banner usa la lista nuova dopo il salvataggio.

3.2.3 (02/11/2026)​

  • Lingua automatica: con una lingua della pagina non attiva, il banner usa la lingua principale. changeLanguage() normalizza il codice e ignora i valori non validi con un avviso in console.
  • Il banner funziona con una CSP rigida su style-src e script-src con nonce.
  • Se l'elenco dei fornitori IAB non si scarica, il banner lo segnala. Il rifiuto chiude il banner per la scheda corrente.
  • L'evento avacy_consent parte su ogni banner v3. Sugli spazi web migrati dal v2, il banner rimette window.AVACY.
  • Impatto sul sito: nessuna modifica obbligatoria. Con una CSP basata sul nonce, metti il nonce sullo snippet.

3.2.2 (29/10/2026)​

  • Il banner aspetta che la pagina sia pronta prima di comparire. Prima, su alcuni siti, non compariva.
  • Il testo predefinito del pulsante delle preferenze è "Preferenze", in tutte le lingue.
  • Le misure del banner non dipendono più dalla dimensione del font del sito. Il banner centrale è largo 900 px.
  • Impatto sul sito: nessuna modifica da fare.

3.2.1 (20/10/2026)​

  • I messaggi in console sui tag Google in ritardo mettono per primo il controllo del Google tag e rimandano alla pagina pubblica sulla debug mode.
  • Impatto sul sito: cambiano solo i testi in console, non il consenso.

3.2.0 (19/10/2026)​

  • Il banner aggiunge l'evento avacy_consent_update al dataLayer dopo ogni aggiornamento di Google Consent Mode, rifiuti compresi, solo se Google Consent Mode è configurato. Con la mappatura delle finalità non lo aggiunge alla prima visita, prima che la persona scelga.
  • Impatto sul sito: un trigger di Google Tag Manager può usare avacy_consent_update per attivare i tag che aspettano il consenso.

3.1.0 (13/10/2026)​

  • Il banner ha quattro varianti di caricamento, che il CDN sceglie in base alle impostazioni dello spazio web. Le varianti con Google Consent Mode inviano il default nel dataLayer prima dei tag Google, con tutti i tipi in denied.
  • Il banner avvisa in console se un comando Google arriva prima del default di Consent Mode.
  • getConsent() non mescola più le special feature TCF con le finalità e le mostra in una vista propria.
  • Impatto sul sito: template GTM 2.0 e snippet caricano la variante giusta senza modifiche. Il codice che leggeva le special feature da purposes le trova nella vista a parte.

3.0.0 (13/10/2026)​

  • Prima versione del banner v3 in produzione, con il pacchetto @avacy/cmp-web. Il numero 3.0.0 era nel repository dal 29/05/2026, ma la prima pubblicazione in produzione è del 13/10/2026.
  • Impatto sul sito: il banner v3 sostituisce il banner v2 sugli spazi web migrati.

API​

  • L'API v4 accetta i consensi dei form inviati con identifier e senza consent_data. Prima li rifiutava con un errore.
  • Impatto sul sito: nessuna modifica obbligatoria. Se il form identifica la persona solo con identifier, puoi omettere consent_data. Vedi API REST.

Archivio consensi: limite di richieste (02/11/2026)​

  • L'API accetta al massimo 60 richieste al minuto dallo stesso indirizzo IP per lo stesso spazio web. Oltre il limite risponde 429, con l'intestazione Retry-After che indica i secondi da aspettare.
  • Impatto sul sito: un'integrazione che invia molti consensi dal proprio server deve distribuire le richieste nel tempo e riprovare dopo Retry-After. Vedi API REST.

Archivio consensi: IP della persona (29/10/2026)​

  • L'API salva l'IP scritto in ip_address, se è un indirizzo IPv4 o IPv6 valido. Prima salvava l'IP da cui arrivava la chiamata.
  • Impatto sul sito: i consensi inviati dal tuo server riportano l'IP della persona. Vedi API REST.

Archivio consensi: controllo del piano (08/09/2026)​

  • La registrazione di un consenso richiede un piano che include l'archivio consensi.
  • Impatto sul sito: un'integrazione su un piano senza archivio riceve 403 a ogni richiesta POST. Vedi API REST.

Plugin WordPress e template GTM​


Ultimo aggiornamento: 06/11/2026.