Javascript API (vecchia versione)

Panoramica

La JavaScript API di Pandectes permette al tuo negozio di interagire con il banner di consenso senza affidarsi esclusivamente al comportamento integrato del banner. Offre agli sviluppatori una serie di strumenti per leggere lo stato attuale del banner e del consenso, attivare azioni e ascoltare eventi, tutto dal tema del tuo negozio o da script personalizzati. Questa pagina descrive le funzionalità disponibili nella versione Legacy Banner dell'API.

Cosa puoi fare con la JavaScript API Legacy?

Leggere lo stato del banner e del consenso

L'API espone una serie di proprietà di sola lettura che riflettono in ogni momento lo stato attuale del banner e del consenso del visitatore. Puoi verificare:

• Se l'API e il banner sono completamente caricati e pronti all'uso
• Se il banner è attualmente visibile sullo schermo
• Se il banner è applicabile al visitatore corrente (in base alle regole di geolocalizzazione)
• Se la geolocalizzazione è attiva e in quale paese viene rilevato il visitatore
• In quale lingua viene attualmente mostrato il banner
• Lo stato del consenso del visitatore per ogni singola categoria di cookie: strettamente necessari, functionality, performance, targeting e cookie non classificati
• Se il visitatore ha cliccato Allow, Decline o Dismiss sul banner

Questo offre al tuo negozio un'istantanea in tempo reale di ciò a cui un visitatore ha dato il consenso e di come ha interagito con il banner.

Controllare la visualizzazione del banner

L'API ti permette di mostrare o nascondere il banner in modo programmatico, invece di affidarti solo alle regole di visualizzazione automatiche. In particolare, puoi:

• Mostrare il banner — forzare la comparsa del banner di consenso al visitatore
• Nascondere il banner — rimuoverlo dalla vista, con la possibilità di mostrare o nascondere contemporaneamente anche il pulsante di revoca/riapertura
• Mostrare o nascondere il pulsante di revoca — il piccolo pulsante che permette ai visitatori di riaprire il banner dopo aver già fatto una scelta

È utile quando vuoi attivare il banner in risposta a una specifica azione dell'utente, come il clic su un link "Cookie settings" nel footer.

Aprire e chiudere il popup delle preferenze

Oltre al banner principale, l'API ti dà il controllo anche sul popup delle preferenze sui cookie, il pannello in cui i visitatori possono accettare o rifiutare singole categorie di cookie. Puoi:

• Aprire direttamente il popup delle preferenze
• Chiuderlo in modo programmatico
• Salvare le preferenze attuali del visitatore e chiudere il popup con una sola azione
• Impostare lo stato delle singole caselle delle categorie all'interno del popup
• Applicare le modifiche del consenso a livello di categoria con diversi livelli di granularità

Questo permette flussi di consenso completamente personalizzati, in cui il pannello delle preferenze viene attivato o gestito al di fuori del banner stesso.

Attivare una revoca del consenso

L'API ti permette di revocare in modo programmatico il consenso precedentemente dato da un visitatore. Questo reimposta il suo stato di consenso e, per impostazione predefinita, riapre il banner in modo che possa fare una nuova scelta. In via facoltativa si può evitare che il banner si riapra automaticamente, se vuoi gestire tu questo passaggio.

Forzare un'azione "leave site"

L'API include un metodo per attivare la funzionalità leave site, la stessa azione che si verifica quando un visitatore clicca su un pulsante leave-site del banner. È utile negli scenari in cui vuoi offrire ai visitatori un modo esplicito per uscire dal negozio nell'ambito di un flusso privacy personalizzato.

Ascoltare gli eventi del banner e del consenso

L'API genera eventi nei momenti chiave del ciclo di vita del banner, così il tuo negozio può reagire in tempo reale. Puoi ascoltare:

• Quando la Pandectes API è stata inizializzata ed è pronta
• Quando la pagina è stata caricata completamente
• Quando la posizione del visitatore è stata rilevata (utile per la logica basata sulla geolocalizzazione)
• Quando è stata impostata la lingua del banner
• Quando il banner diventa visibile
• Quando il banner viene nascosto
• Quando il visitatore clicca sul pulsante leave site
• Quando il banner viene chiuso (dopo una decisione di consenso)
• Quando una decisione di consenso viene presa o aggiornata
• Quando il visitatore apre il pannello delle preferenze

Questi eventi permettono ad altri script e integrazioni del tuo negozio di rispondere immediatamente alle modifiche del consenso, ad esempio caricando uno script di tracciamento nel momento in cui un visitatore concede il consenso, senza richiedere il ricaricamento della pagina.

A chi è destinata?

La JavaScript API è destinata ai commercianti con uno sviluppatore o ai negozi che usano una vetrina personalizzata o headless. Il banner funziona completamente da solo senza alcun uso dell'API: questa serve per scenari avanzati in cui è necessaria un'integrazione più stretta con il comportamento del tuo negozio.

Per iniziare

Per consultare il riferimento completo dell'API, vai su Settings → JavaScript API nell'app Pandectes. Se hai bisogno di aiuto per un caso d'uso specifico, contatta il nostro team di supporto.

Aggiornato il: 20/10/2026