Javascript API (nuova versione)

Panoramica

La JavaScript API di Pandectes ti permette di interagire con il banner di consenso in modo programmatico dal tema del tuo negozio o da script personalizzati. Senza scrivere codice complesso, capire cosa offre l'API ti aiuta a sapere cosa è possibile e quando chiedere a uno sviluppatore di implementarlo per te.
Questa funzione è disponibile nel New Banner ed è accessibile da Settings → JavaScript API.

Cosa puoi fare con la JavaScript API?

Leggere lo stato di consenso attuale del visitatore

L'API permette al tuo negozio di sapere sempre, in tempo reale, a cosa ha dato il consenso un visitatore. Puoi verificare:

• Se un visitatore ha consentito il tracciamento analytics (ad es. Google Analytics, Microsoft Clarity)
• Se un visitatore ha consentito i cookie di marketing (ad es. Facebook Pixel, TikTok)
• Se un visitatore ha consentito i cookie di preferences/functionality
• La decisione di consenso completa del visitatore come singolo oggetto

È utile quando vuoi che altre parti del tuo negozio si comportino in modo diverso a seconda di ciò che il visitatore ha accettato.

Controllare la finestra di consenso

L'API ti dà la possibilità di aprire o chiudere la finestra del banner di consenso da qualsiasi azione nel tuo negozio. Ad esempio, un pulsante nel footer, un link in una pagina della privacy policy o un'opzione personalizzata "Cookie settings" nel tuo menu. Funziona insieme alla funzione integrata del link nel menu, ma offre agli sviluppatori maggiore flessibilità per attivarla da qualsiasi elemento della pagina.

Impostare o aggiornare il consenso in modo programmatico

In scenari avanzati, il tuo negozio può impostare direttamente la decisione di consenso di un visitatore. Ad esempio, quando un visitatore effettua una scelta di consenso tramite un'interfaccia personalizzata che hai creato, oppure quando il consenso viene raccolto con un meccanismo diverso e deve essere passato a Pandectes per essere applicato.

Cambiare la lingua del banner

L'API permette di cambiare dinamicamente la lingua della finestra di consenso. Se il tuo negozio serve visitatori in più lingue e ne rileva la preferenza, il banner può essere mostrato nella lingua corretta senza affidarsi esclusivamente alla lingua predefinita del browser.

Reagire agli eventi di consenso

L'API può avvisare il tuo negozio nel momento stesso in cui accade qualcosa legato al consenso, ad esempio:

• Quando il banner è completamente caricato e pronto
• Quando la finestra di consenso viene aperta dal visitatore
• Quando la finestra di consenso viene chiusa
• Quando il visitatore modifica o invia le proprie preferenze di consenso

Questo significa che puoi creare flussi che reagiscono istantaneamente alla scelta di un visitatore. Ad esempio, caricare uno script di tracciamento nel momento in cui viene dato il consenso, senza dover aggiornare la pagina.

A chi è destinata?

La JavaScript API è destinata ai commercianti con uno sviluppatore o a chi usa una vetrina personalizzata. Non devi usare né comprendere l'API perché il banner funzioni. Funziona completamente da solo, senza alcuna configurazione. Tuttavia, se vuoi un'integrazione più profonda tra il banner di consenso e il resto del comportamento del tuo negozio, l'API è lo strumento giusto.

Per iniziare

Per esplorare l'API e consultare il riferimento completo, vai su Settings → JavaScript API nell'app Pandectes. La pagina include l'elenco completo delle proprietà, delle funzioni e degli eventi disponibili, con le relative descrizioni. Se hai bisogno di aiuto per implementare un caso d'uso specifico, contatta pure il nostro team di supporto.

Aggiornato il: 20/10/2026