API Javascript: controllo frontend e integrazione di script conformi

Estendi le funzionalità di CookieHub, carica in modo condizionale script di terze parti in base al consenso dell'utente e gestisci l'esperienza di dialogo direttamente dal codice lato client.

Comprensione dell'API Javascript

L'API Javascript di CookieHub fornisce un set flessibile di metodi ed eventi pubblici che consentono agli sviluppatori front-end di interagire e controllare il widget CMP direttamente sul sito web. Questa API è essenziale per garantire una solida conformità, consentendo di verificare manualmente lo stato del consenso di un utente prima di eseguire script di marketing, analisi o funzionali di terze parti.

Tutte le funzionalità sono accessibili tramite l'oggetto globale window.cookiehub, che diventa disponibile una volta inizializzato il tag CookieHub.

Perché utilizzare l'API Javascript?

Utilizzando l'API, il tuo sito web sarà conforme, dinamico e offrirà un'esperienza utente fluida.

Caricamento condizionale dello script

Utilizzare il metodo hasConsented() per caricare tag di terze parti (ad esempio, Google Analytics, Facebook Pixel) solo se l'utente ha fornito la categoria di consenso richiesta.

Integrazione in tempo reale

Utilizza eventi come cookiehub_onStatusChange per attivare script o aggiornare il tuo livello dati nel momento in cui un utente modifica le proprie preferenze, senza dover aggiornare la pagina.

Esperienza utente personalizzata

Crea pulsanti o link personalizzati che aprono in modo programmatico la finestra di dialogo del consenso (openDialog()) o il pannello delle impostazioni (openSettings()) da qualsiasi punto del tuo sito.

Flessibilità dello sviluppatore

Fornisce metodi semplici come allowAll() o denyAll() per scenari di integrazione avanzati in cui è necessario il controllo manuale sugli stati di consenso.

Come funziona

Le funzionalità dell'API Javascript sono suddivise in due gruppi principali: Metodi Pubblici (per interrogare lo stato e il controllo) ed Eventi (per reagire alle modifiche).

Per garantire la disponibilità dell'oggetto API, è necessario iniettare il tag CookieHub standard nell'<head> del sito web:

Guida all'installazione: Informazioni sullo script da iniettare - Tag CookieHub

Inizia a integrare il tuo CMP

L'API Javascript è il modo definitivo per ottenere un controllo granulare e conforme sulle integrazioni di terze parti del tuo sito web.

Domande frequenti

Una volta caricato il tag CookieHub principale, tutti i metodi e le proprietà pubbliche sono disponibili nell'oggetto globale window.cookiehub.

Sì, assolutamente. Se disabiliti l'icona mobile predefinita nella dashboard di CookieHub, puoi creare un link o un pulsante personalizzato in qualsiasi punto del tuo sito (ad esempio, nel piè di pagina) che attivi il metodo pubblico openDialog().

Sì. La dichiarazione completa sui cookie può essere incorporata direttamente in qualsiasi pagina (ad esempio, la pagina dedicata alla Politica sui Cookie) utilizzando un semplice snippet HTML. Questo metodo visualizza la dichiarazione come una tabella senza stile che eredita il CSS del tuo sito web, garantendo coerenza visiva. Come incorporare: Inserisci il seguente snippet HTML esattamente nel punto in cui desideri che appaia la dichiarazione: <div class="cookiehub-declaration"></div> Nota: se si desidera che gli utenti visualizzino la dichiarazione all'interno della sovrapposizione della finestra di dialogo CMP, è comunque possibile utilizzare il metodo window.cookiehub.openSettings('declaration');

Utilizza un metodo pubblico (come hasConsented()) quando il codice deve interrogare uno stato o controllare la finestra di dialogo (un'operazione attiva). Utilizza un evento (come cookiehub_onStatusChange) quando il codice deve reagire a un'azione dell'utente (un'operazione passiva) o a un momento di inizializzazione.

No. I metodi API come allowAll() o denyAll() sono progettati per fornire all'utente modi alternativi per esprimere il consenso (ad esempio, tramite un pulsante personalizzato). Non devono essere utilizzati per aggirare la scelta esplicita dell'utente o il flusso di lavoro CMP.

L'evento cookiehub_onStatusChange è l'evento più affidabile per l'integrazione con GTM. Si attiva ogni volta che l'utente modifica le proprie preferenze sui cookie, consentendo di aggiornare immediatamente il livello dati GTM per riflettere il nuovo stato di consenso.