Gestione cookie lato client

Si tratta di uno dei metodi più efficaci per impedire che i cookie controllati dai tag di script vengano impostati senza consenso. Questo metodo prevede un numero minimo di modifiche al sito e non richiede l'utilizzo del wrapper (illustrato di seguito).

[en] Below are a couple examples in which this method would be applicable.

[en] In-Line Scripting Example:

<script type=’text/javascript’>
document.cookie = “targeting-cookie”+”=”+”1234”
</script>

[en] JavaScript File Example:

<script type=’text/javascript’ src=’/path/cookie.js’></script>

[en] How to Implement

Tag di script normali hanno un aspetto simile al seguente:

<script type="text/javascript">
code
</script>

Quando si utilizza la riscrittura del tipo di script, è necessario modificare gli script in:

<script type="text/plain" class="optanon-category-C0002">
code
</script>

Il numero dell'identificatore di classe corrisponde all'ID del gruppo di cookie caricato dallo script. In questo caso, si tratta di cookie prestazionali.

[en] How it Works

Quando il codice indicato sopra viene caricato, il JavaScript all'interno dei tag non viene eseguito e i cookie non vengono impostati. Quindi, quando il codice di Conformità cookie viene caricato, se per i cookie relativi al gruppo associato è stato fornito il consenso, il tag verrà modificato in modo dinamico in: script type=text/JavaScript e il codice all'interno dei tag verrà riconosciuto ed eseguito normalmente.

<script type=’text/plain’ class=’optanon-category-C0004’>
document.cookie = “targeting-cookie”+”=”+”1234”
</script>

[en] After re-writing this tag, the script would only fire on the site when a user consents to the C0004 category (Targeting Cookies). The class attribute is responsible for updating the type. When consent is withdrawn/withheld for the assigned category, the type will be text/plain; when consent is given, it will be text/javascript.

[en] In this example, when a user does not consent to Targeting cookies (C0004) , the script tag would appear as follows:

[en] When a user consents to Targeting cookies (C0004), the type will appear as follows:

<script type="text/plain" class="optanon-category-C0002-C0003-C0004">
code
</script>

Il wrapper Optanon viene fornito nel tag di script principale e ha un aspetto simile al seguente:

<script type="text/javascript">
function OptanonWrapper() {
}
</script>

Svolge la funzione di contenitore dei metodi di supporto utilizzati per bloccare o controllare gli script o i tag html responsabili dell'impostazione dei cookie. Il wrapper viene eseguito ad ogni caricamento di pagina o ogni volta che l'utente salva le modifiche alle impostazioni privacy nel centro preferenze.

Quando i gruppi di cookie vengono impostati da inattivi ad attivi, vengono eseguiti i relativi metodi di supporto e nella pagina viene inserito il corrispondente codice JavaScript/HTML.

Gli script del metodo di supporto non devono essere inseriti all'interno del controllo wrapper. Tuttavia, in caso contrario, vengono eseguiti solo al primo caricamento della pagina. Se si desidera che un'azione di opt in (attivazione) venga applicata immediatamente all'esperienza utente, è necessario utilizzare il wrapper.

Le modifiche apportate all'esperienza utente in seguito a un'azione di opt out (disattivazione) diventeranno effettive solo al momento dell'aggiornamento della pagina o della navigazione verso una nuova pagina.

[en] Below is an example function called through OptanonWrapper():

[en] Example function:

toConsole() {
    console.log(“SUCCESS”)
}
function OptanonWrapper{
  if(OnetrustActiveGroups.includes("C0002")){
    toConsole()
  }
}

[en] OnetrustActiveGroups plays a critical role in the Optanon Wrapper Control method. OnetrustActiveGroups is a data layer variable that gets updated every time a user modifies their choices with the latest category IDs. For more details on this variable, see OnetrustActiveGroups - utilizzo dell'oggetto livello di dati.

[en] In the above instance, toConsole() is an example function that is writing a message on the console when the if condition is executed. In this example, the if condition is checking for the OnetrustActiveGroups data layer variable and if it includes the C0002 category, meaning when Performance cookies are active. Whenever this condition is satisfied, the toConsole() function is executed. The toConsole() function will be called every time the OptanonWrapper() fires and when a user consents to Performance cookies (C0002).

[en] When the function is executed based on consent for Performance category, it appears as follows:

[en] Third-party tools often have public methods that can be called to indicate to the tool that a user has granted or revoked consent. These will often result in the technology being set to “strict” or “restricted” mode so that a restricted amount of data is processed to respect a user’s choices. If the technology you want to control has these methods, you can implement them through the OptanonWrapper control. See the following example:

function OptanonWrapper(){
        if(OnetrustActiveGroups.includes(“C0002”)){
                myAnalyticsTool.setUnrestrictedMode () //consent given, operate regularly
        }else{
                myAnalyticsTool.setRestrictedMode() //consent not given, operate in restricted mode
        }
}

[en] Events

[en] The OneTrust JavaScript SDK raises several events that can be used to trigger consent-related actions. The two most relevant events are OneTrustGroupsUpdated, which fires when consent becomes available on page load and whenever consent is changed, and OTConsentApplied, which only fires when an explicit consent action has been taken.

window.addEventListener(“OneTrustGroupsUpdated”, event => {
        if(event.details.includes(“C0002”)){
                myAnalyticsTool.setUnrestrictedMode();
}else{
        myAnalyticsTool.setRestrictedMode();
}
})

[en] For more information on OneTrust JavaScript events, see [en] Cookie Consent Java Script Events Guide.

I metodi di supporto vengono utilizzati per bloccare o controllare gli script o i tag html responsabili dell'impostazione dei cookie.

OneTrust.InsertScript

Con questo metodo, gli script responsabili dell'impostazione dei cookie vengono inclusi in un file esterno e inseriti dinamicamente nella pagina quando il gruppo di cookie a cui sono associati è attivo.

Il formato è:

OneTrust.InsertScript(url, selector, callback, options, groupId)

Esempio 1. OneTrust.InsertScript

OneTrust.InsertScript('/gaCookies.js', 'head', null, null, 'C0002');OneTrust.InsertScript('/performance-cookies-script.js', 'head', null, null, '2');

[en] In the example below, gaCookies.js is an external file that is setting Google Analytics cookies. This JavaScript file will be inserted only when Performance cookies are active. Implementing this using the InsertScript method within the OptanonWrapper() function would appear as follows:

function OptanonWrapper() { 
            OneTrust.InsertScript('path/gaCookies.js','head', null, null, 'C0002');
 }

Il risultato:

[en] In this example, the gaCookies.js file will get injected before the closing head tag of the HTML when Performance cookies (C0002) are active. The following script will be inserted in the source and will be executed as a regular JavaScript file:

<script type="text/javascript" src="path/gaCookies.js"></script>

Se il gruppo dei cookie prestazionali con ID di 2 è impostato su attivo o sempre attivo, il seguente script viene inserito nella pagina immediatamente prima del tag head di chiusura:

Nota

[en] Please note that the gaCookies.js used in the scenario above is strictly an example. This method is applicable to any JavaScript file that is required to be injected in the code based on user consent.

Vedere la tabella seguente per una spiegazione dei diversi parametri.

Parametro	Tipo di dati	Descrizione	Valore	Obbligatorio
url	String	URL assoluto o relativo del file JS		Sì
selector	String	Selettore di elementi HTML padre in cui verrà inserito il tag dello script	head body parent id	Sì
callback	Funzione	Una funzione JavaScript che va chiamata una volta inserito il tag dello script	function name null	Sì
options	Oggetto	Un elenco di comportamenti per quando viene inserito il tag dello script	Vedere la definizione delle opzioni riportata di seguito	Sì
groupId	Numero	ID del gruppo per il quale verrà inserito il tag dello script	ID del gruppo Optanon	Sì

OneTrust.InsertHTML

Questo metodo deve essere utilizzato quando il codice che controlla l'impostazione dei cookie è un tag HTML standard o personalizzato.

Il formato è:

OneTrust.InsertHtml(element, selector, callback, options, groupId)

Esempio 2. OneTrust.InsertHTML

OneTrust.InsertHtml('<iframe type="text/html" width="640" height="360" frameborder="no" src="https://www.youtube.com/embed/v=GEH-usLSwqE"></iframe>','123', null, null, 'C0003');OneTrust.InsertHtml('<customElement customAttribute="value">some content</customElement>', 'parent_element_id', null, null, '3');

[en] In this example, the iFrame is the standard HTML element to be injected in a section that has ID 123. The first null value specifies that there is not a callback function and the second null value specifies that there is no options parameter added. The group ID (C0003) will allow the element to be inserted when consent is granted for Functional-category cookies.

Il risultato:

Nota

[en] Please note that this method will automatically add an enclosing div around the element that is getting inserted.

<customElement customAttribute="value">some content</customElement>

Se il gruppo dei cookie di funzionalità è inattivo, lo script non viene inserito.

Vedere la tabella seguente per una spiegazione dei diversi parametri.

Parametro	Tipo di dati	Descrizione	Valore	Obbligatorio
element	String	Tag HTML da inserire		Sì
selector	String	ID dell'elemento HTML padre in cui verrà inserito l'elemento	parent id	Sì
callback	Funzione	Una funzione JavaScript che va chiamata una volta inserito l'elemento	function name null	Sì
options	Oggetto	Un elenco di comportamenti per quando viene inserito l'elemento	Vedere la definizione delle opzioni riportata di seguito null	Sì
groupId	Numero	ID del gruppo per il quale verrà inserito l'elemento	ID del gruppo Optanon	Sì

Nota

Alcuni componenti di terze parti che impostano i cookie utilizzano sia elementi JavaScript che HTML, che sono interdipendenti. Nella maggior parte dei casi, sarà quindi necessario utilizzare in coppia i metodi di supporto HTML e JavaScript per evitare problemi dovuti alla presenza di un elemento e all'assenza dell'altro.

{
deleteSelectorContent: <bool>,
makeSelectorVisible: <bool>,
makeElementsVisible: [‘<id>’, ‘<id>’, ‘<id>’, ...],
deleteElements: [‘<id>’, ‘<id>’, ‘<id>’, ...]
}