Inserisci il codice seguente nell'head della pagina

<script type="text/javascript" src="//privacy.ene.si/api/js?key=[KEY]&uid=[UID]&ln=[LANG]"></script>

KEY api key del cliente

UID codice identificativo del progetto

LANG lingua richiesta tra quelle disponibili: ita, eng, spa, fra, deu, por, tur, rus, ukr

• Il Cookie Banner viene mostrato solo se la funzionalità è attiva da backoffice per il progetto.
• L'SDK inietta automaticamente il foglio stile API: non è necessario includere manualmente il vecchio CSS //privacy.ene.si/api/css.
• Il sistema imposta automaticamente il Google Consent Mode v2 solo se non trova già un comando consent nel dataLayer.
• Gli esempi javascript con $() usano jQuery solo a scopo dimostrativo: l'SDK funziona anche senza jQuery.

Accetta o rifiuta tutti i cookie

Sono disponibili anche le azioni rapide data-epp="accept" e data-epp="decline".

Esempio

<button type="button" data-epp="accept">Accetta tutti</button>
<button type="button" data-epp="decline">Rifiuta tutti</button>

Consulta la Privacy Policy

Aggiungi l'attributo data-epp="policy" ad un link o un pulsante per visualizzare la Privacy Policy in un popup

Esempio

<button type="button" data-epp="policy">Privacy Policy</button>

E' possibile anche rimandare l'utente ad una pagina esterna

Esempio

<a href="https://privacy.ene.si/api/policy-full/?uid=[UID]&ln=[LANG]" target="_blank">Privacy Policy</a>

UID codice identificativo del progetto

LANG lingua richiesta tra quelle disponibili: ita, eng, spa, fra, deu, por, tur, rus, ukr

Consulta la Cookie Policy

Aggiungi l'attributo data-epp="cookie" ad un link o un pulsante per visualizzare la Cookie Policy in un popup

Esempio

<button type="button" data-epp="cookie">Cookie Policy</button>

E' possibile anche rimandare l'utente ad una pagina esterna

Esempio

<a href="https://privacy.ene.si/api/cookie-full/?uid=[UID]&ln=[LANG]" target="_blank">Cookie Policy</a>

UID codice identificativo del progetto

LANG lingua richiesta tra quelle disponibili: ita, eng, spa, fra, deu, por, tur, rus, ukr

Modifica le preferenze sui Cookie

Aggiungi l'attributo data-epp="cookie-preferences" ad un link o un pulsante

Esempio

<button type="button" data-epp="cookie-preferences">Preferenze sui Cookie</button>

Consulta una informativa di consenso

Aggiungi l'attributo data-epp="consent-information" e l'attributo data-epp-pid="[PID]" ad un link o un pulsante per visualizzare la Cookie Policy in un popup

Esempio

<button class="btn btn-primary" type="button" data-epp="consent-information" data-epp-pid="[PID]">Informativa di consenso</button>

PID codice informativa di consenso

Accetta una categoria specifica

Aggiungi l'attributo data-epp="accept-category" e l'attributo data-epp-category="[PID]" ad un link o un pulsante per accettare direttamente da un pulsante una categoria specifica dei cookie

Esempio

<button class="btn btn-primary" type="button" data-epp="accept-category" data-epp-category="[PID]">Accetta la categoria 10004</button>

PID codice identificativo della categoria di servizi

Iframe

Per bloccare un iframe è possibile sostituire l'attibuto src con data-epp-src
E' possibile associare lo sblocco ad una categoria di cookie tramite l'attributo data-epp-category="[PID]"

Esempio

<iframe data-epp-src="https://www.youtube.com/embed/NB5uizJmHsw" src="about:blank"></iframe>
<iframe data-epp-src="https://www.youtube.com/embed/NB5uizJmHsw" data-epp-category="[PID]" src="about:blank"></iframe>

PID codice identificativo della categoria di servizi

Per bloccare un gruppo di iframe è possibile aggiungere l'attributo data-epp-autolock nell'elemento che li contiene (genitore)
E' possibile associare lo sblocco di tutti gli iframe contenuti nel gruppo ad una categoria di cookie tramite l'attributo data-epp-category="[PID]"

Esempio

<div data-epp-autolock>
    <iframe src="https://www.youtube.com/embed/NB5uizJmHsw"></iframe>
</div><div data-epp-autolock data-epp-category="[PID]">
    <iframe src="https://www.youtube.com/embed/NB5uizJmHsw"></iframe>
</div>

PID codice identificativo della categoria di servizi

MetaTag Link

Per bloccare un meta tag link è possibile sostituire l'attibuto href con data-epp-href
E' possibile associare lo sblocco ad una categoria di cookie tramite l'attributo data-epp-category="[PID]"

Esempio

<link href="https://fonts.googleapis.com/css2?family=Open+Sans&display=swap" rel="stylesheet">
 <link data-epp-category="10003" data-epp-href="https://fonts.googleapis.com/css2?family=Open+Sans&display=swap" rel="stylesheet">

PID codice identificativo della categoria di servizi

Script

Per bloccare tag script contenenti porzioni di codice si deve applicare l'attibuto data-epp-onconsent e un tipo non eseguibile (es. type="text/plain")

Per bloccare tag script con caricamento di una risorsa esterna si deve applicare l'attibuto data-epp-onconsent e sostituire l'attributo src con data-epp-src

E' possibile associare lo sblocco ad una categoria di cookie tramite l'attributo data-epp-category="[PID]"

Esempio di esecuzione dello script

<script data-epp-onconsent type="text/plain">
    $(function() {
        $('[pp-lock-script-status]').removeClass('text-danger').addClass('text-success').text('Eseguito');
    })
</script>
<div pp-lock-script-status class="text-danger">Bloccato</div>

<script data-epp-onconsent data-epp-category="[PID]" type="text/plain">
    $(function() {
        $('[pp-lock-script-category-status]').removeClass('text-danger').addClass('text-success').text('Eseguito per "Miglioramento dell’esperienza"');
    })
</script>
<div pp-lock-script-category-status class="text-danger">Bloccato per "Miglioramento dell’esperienza"</div>

PID codice identificativo della categoria di servizi

Esempio di caricamento esterno

<script data-epp-onconsent data-epp-src="[SRC]"></script>

<script data-epp-onconsent data-epp-category="[PID]" data-epp-src="[SRC]"></script>

PID codice identificativo della categoria di servizi

SRC risorsa da caricare esternamente

Esecuzione di un callback

E' possibile eseguire delle funzioni javascript alla accettazione dei consensi

Esempio

<script type="text/javascript">
    $(function() {
        EPP.onAccept(function() {
            $('[pp-js-onaccept-status]').removeClass('text-danger').addClass('text-success').text('Eseguito');
        })
    })
</script>
<div pp-js-onaccept-status class="text-danger">Bloccato</div>

<script type="text/javascript">
    $(function() {
        EPP.onAccept(function() {
            $('[pp-js-onaccept-category-status]').removeClass('text-danger').addClass('text-success').text('Eseguito per "Miglioramento dell’esperienza"');
        }, '[PID]')
    })
</script>
<div pp-js-onaccept-category-status class="text-danger">Bloccato per "Miglioramento dell’esperienza"</div>

PID codice identificativo della categoria di servizi

Caricamento file script

E' possibile caricare un file javascript alla accettazione dei consensi, ed eseguire un callback al completamento del suo caricamento nel dom

Esempio

<script type="text/javascript">
    $(function() {
        EPP.loadScript('[SRC]', function() {
            // callback
        }, '[PID]');
    })
</script>

SRC url del file javascript

PID codice identificativo della categoria di servizi

Verifica di un consenso

E' possibile verificare l'accettazione di una categoria di servizi

Esempio

<script type="text/javascript">
    $(function() {
        EPP.isAllowedCategory('[PID]');
    })
</script>

PID codice identificativo della categoria di servizi

Abilita una categoria

E' possibile abilitare programmaticamente una categoria (utile per azioni esplicite dell'utente dopo la raccolta del consenso).

Esempio

<script type="text/javascript">
    EPP.allowCategory('[PID]');
</script>

PID codice identificativo della categoria di servizi

Privacy Policy

Per integrare la pagina della Privacy Policy su un sito web,
è possibile eseguire una chiamata GET e stampare il risultato

Esempio

GET https://privacy.ene.si/api/policy?uid=[UID]&ln=[LANG]

UID codice identificativo del progetto

LANG lingua richiesta tra quelle disponibili: ita, eng, spa, fra, deu, por, tur, rus, ukr

Cookie Policy

Per integrare la pagina della Cookie Policy su un sito web,
è possibile eseguire una chiamata GET e stampare il risultato

Esempio

GET https://privacy.ene.si/api/cookie?uid=[UID]&ln=[LANG]

UID codice identificativo del progetto

LANG lingua richiesta tra quelle disponibili: ita, eng, spa, fra, deu, por, tur, rus, ukr

Modalità di consenso Google (GA4, GTM)

La modalità di consenso viene inviata automaticamente dal SDK javascript del cookie banner

E' presente un automatismo che identifica le piattaforme in cui il consenso è già stato inviato senza interferire con altre implementazioni

• Aggiornamenti alla modalità di consenso
• Configurare la modalità di consenso sui siti web