Gestión de cookies del lado cliente

Este es uno de los métodos más eficaces para la prevención de cookies controladas mediante etiquetas script establecidas sin consentimiento. Este método requiere el menor número de cambios en el sitio y no precisa el uso del contenedor (a continuación).

[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

Las etiquetas script normales tienen este aspecto:

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

Al utilizar la reescritura de tipos de scripts, debe cambiar los scripts a:

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

El número del identificador de clase corresponde al ID del grupo de cookies para las cookies cargadas por el script. En este caso, se trata de Performance Cookies (Cookies de rendimiento).

[en] How it Works

Al cargar el código anterior, no se ejecutará el JavaScript que se encuentra en las etiquetas y las cookies no se establecerán. A continuación, cuando se carga el código de Consentimiento de cookies, si se ha otorgado el consentimiento para las cookies asociadas, se cambiará la etiqueta de forma dinámica a: script type=text/JavaScript. Se reconocerá el código que se encuentra dentro de las etiquetas y se ejecutará con normalidad.

<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>

El contenedor de Optanon se proporciona en la etiqueta de script principal y tiene este aspecto:

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

Funciona como un soporte para los métodos auxiliares que se utilizan para bloquear o controlar cualquier etiqueta script o html que provoque el establecimiento de cookies. El contenedor se ejecutará cada vez que se cargue la página o cuando el usuario guarde cambios en la configuración de privacidad en el centro de preferencias.

Al cambiar el estado de grupos de cookies de Inactive (Inactiva) a Active (Activa), se ejecutan los métodos auxiliares pertinentes y el JavaScript/HTML se insertará en la página.

No es necesario colocar los scripts del método auxiliar dentro del control del contenedor. No obstante, si no lo están, solo se ejecutan al cargar la página por primera vez. Si desea que cualquier acción de inclusión (de Inactive [Inactiva] a Active [Activa]) se refleje de inmediato en la experiencia del usuario, debe usar el contenedor.

Los cambios en la experiencia del usuario como resultado de una acción de exclusión (Active [Activa] a Inactive [Inactiva]) solo se reflejarán al actualizar la página o al ir a una página nueva.

[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: uso del objeto de capa de datos.

[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.

Los métodos auxiliares se utilizan para bloquear o controlar cualquier etiqueta script o html que provoque el establecimiento de cookies.

OneTrust.InsertScript

Con este método, los scripts encargados del establecimiento de cookies se colocan en un archivo externo y se insertan de forma dinámica en la página cuando el estado del grupo de cookies con el que están asociados es Active (Activa).

El formato es:

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

Ejemplo 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');
 }

Resultado:

[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>

Si el grupo Performance Cookies (Cookies de rendimiento) con el ID 2 se establece en Active (Activa) o Always Active (Siempre activa), se inserta el siguiente script en la página justo delante de la etiqueta head de cierre:

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.

Consulte la siguiente tabla para ver una explicación de los diferentes parámetros.

Parámetro	Tipo de datos	Descripción	Valor	Obligatorio
url	Cadena	Dirección URL absoluta o relativa del archivo JS		Sí
selector	Cadena	Selector de elemento principal HTML donde se insertará la etiqueta script	head body parent id	Sí
callback	Función	Una función de JavaScript a la que se llama tras la inserción de la etiqueta script	function name null	Sí
options	Objeto	Una lista de comportamientos para el momento en que se inserta la etiqueta script	Consulte la definición de las opciones a continuación	Sí
groupId	Número	ID del grupo para el que se insertará la etiqueta script	Optanon Group ID	Sí

OneTrust.InsertHTML

Este método debe utilizarse si el código que controla la configuración de las cookies es una etiqueta HTML estándar o personalizada.

El formato es:

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

Ejemplo 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.

Resultado:

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>

Si el estado del grupo Functionality Cookies (Cookies de funcionalidad) es Inactive (Inactivo), no se inserta el script.

Consulte la siguiente tabla para ver una explicación de los diferentes parámetros.

Parámetro	Tipo de datos	Descripción	Valor	Obligatorio
element	Cadena	Etiqueta HTML que se insertará		Sí
selector	Cadena	ID de elemento principal HTML donde se insertará el elemento	parent ID	Sí
callback	Función	Una función de JavaScript a la que se llama tras la inserción del elemento	function name null	Sí
options	Objeto	Una lista de comportamientos para el momento en que se inserta el elemento	Consulte la definición de las opciones a continuación null	Sí
groupId	Número	ID del grupo para el que se insertará el elemento	Optanon Group ID	Sí

Nota

Algunos componentes de terceros que establecen cookies utilizan elementos HTML y JavaScript que son interdependientes. En la mayoría de los casos, deberá utilizar los métodos auxiliares HTML y JavaScript juntos para evitar cualquier problema debido a que un elemento esté presente sin el otro.

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