Javascript API (nuova versione)

Panoramica

L'API JavaScript di Pandectes ti permette di interagire programmaticamente con il banner di consenso dal tema del tuo store o dagli script personalizzati. Senza scrivere codice complesso, capire cosa offre l'API ti aiuta a sapere cosa è possibile fare e quando chiedere a uno sviluppatore di implementarlo per te.
Questa funzionalità è disponibile nel New Banner ed è accessibile da All settings > JavaScript API.

Cosa puoi fare con l'API JavaScript?

Leggere lo stato attuale del consenso del visitatore

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

• Se il visitatore ha permesso il tracciamento analytics (ad es. Google Analytics, Microsoft Clarity)
• Se il visitatore ha permesso i cookie marketing (ad es. Facebook Pixel, TikTok)
• Se il visitatore ha permesso i cookie di preferenze/funzionalità
• La decisione completa di consenso del visitatore come un unico oggetto

È utile quando vuoi che altre parti del tuo store si comportino in modo diverso in base a ciò a cui il visitatore ha acconsentito.

Controllare la finestra di consenso

L'API ti permette di aprire o chiudere la finestra del banner di consenso da qualsiasi azione nel tuo store. Ad esempio, un pulsante nel footer, un link in una pagina di informativa privacy o un'opzione personalizzata "Impostazioni cookie" nel menu. Funziona insieme alla funzione di link integrata nel menu, ma offre agli sviluppatori più flessibilità per attivarla da qualsiasi elemento della pagina.

Impostare o aggiornare il consenso in modo programmatico

In scenari avanzati, il tuo store può impostare direttamente la decisione di consenso del visitatore. Ad esempio, quando un visitatore fa una scelta di consenso tramite un'interfaccia personalizzata che hai creato, o quando il consenso viene raccolto con un altro meccanismo 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 store si rivolge a visitatori in più lingue e ne rileva la preferenza, il banner può essere mostrato nella lingua corretta senza affidarsi solo a quella predefinita del browser.

Reagire agli eventi di consenso

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

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

Questo significa che puoi costruire flussi che reagiscono immediatamente alla scelta di un visitatore. Ad esempio, caricare uno script di tracciamento nel momento stesso in cui viene dato il consenso, senza bisogno di ricaricare la pagina.

A chi è rivolta?

L'API JavaScript è pensata per merchant che hanno uno sviluppatore o per chi usa uno storefront personalizzato. Non devi usare né capire l'API perché il banner funzioni: opera completamente da solo fin da subito. Tuttavia, se vuoi un'integrazione più profonda tra il banner di consenso e il resto del comportamento del tuo store, l'API è lo strumento giusto.

Come iniziare

Per esplorare l'API e vedere il riferimento completo, vai su All settings > JavaScript API all'interno dell'app Pandectes. La pagina include l'elenco completo di proprietà, funzioni ed eventi disponibili, con le relative descrizioni. Se hai bisogno di aiuto per implementare un caso d'uso specifico, non esitare a contattare il nostro team di supporto.

Aggiornato il: 27/10/2026