Gerenciamento de cookies do ponto de vista do cliente

Este é um dos métodos mais eficientes de impedir que cookies controlados por tags de script sejam definidos sem consentimento. Este método requer a menor quantidade de alterações em seu local e não requer o uso do invólucro (abaixo).

[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

As tags de script normais são semelhantes a estas:

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

Usando a regravação do tipo de script, você precisa alterar os scripts para:

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

O número no identificador de classe corresponde ao id do grupo de cookies para os cookies que o script carrega. Nesse caso, são cookies de desempenho.

[en] How it Works

Quando o código acima é carregado, o JavaScript dentro das tags não é executado e nenhum cookies é definido. Em seguida, quando o código de Conformidade de cookies for carregado, se os cookies do grupo associado tiverem consentimento, ele mudará dinamicamente a tag para: script type=text/JavaScript – o código dentro das tags será reconhecido e executado 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>

O Optanon Wrapper é fornecido na tag de script principal e tem a seguinte aparência:

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

Ele funciona como um suporte para os métodos auxiliares que são usados para bloquear ou controlar qualquer script ou tags html que fazem com que os cookies sejam definidos. O wrapper é executado em cada carregamento de página ou sempre que o usuário salva as alterações nas configurações de privacidade na Central de preferências.

Quando grupos de cookies são alternados de Inativo para Ativo, os métodos auxiliares relevantes são executados e o JavaScript/HTML relacionado será inserido na página.

Os scripts do método auxiliar não precisam ser colocados dentro do controle do wrapper. No entanto, se não forem, eles serão executados apenas no carregamento da primeira página. Se quiser que qualquer ação de aceitação (Inativo para Ativo) seja refletida imediatamente na experiência do usuário, você deve usar o wrapper.

As alterações na experiência do usuário como resultado de uma ação de cancelamento (ativa para inativa) serão refletidas somente na atualização da página ou na navegação para uma nova página.

[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 - usando o objeto Data Layer.

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

Os métodos auxiliares são usados para bloquear ou controlar qualquer script ou tags html que façam com que os cookies sejam definidos.

OneTrust.InsertScript

Com esse método, os scripts responsáveis pela configuração de cookies são colocados em um arquivo externo e inseridos dinamicamente na página quando o grupo de cookies ao qual estão associados está Ativo.

O formato é:

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

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

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

Se o grupo de Cookies de desempenho com um id de 2 estiver definido como Ativo ou Sempre ativo, o seguinte script será inserido na página imediatamente antes do tag head de fechamento:

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 a tabela abaixo para obter uma explicação dos diferentes parâmetros.

Parâmetro	Tipo de dados	Descrição	Valor	Obrigatório
url	String	URL absoluta ou relativa do arquivo JS		Sim
seletor	String	Seletor de elemento principal HTML no qual a tag script será inserida	head Body ID principal	Sim
callback	Função	Uma função JavaScript a ser chamada assim que a tag de script for inserida	nome da função nulo	Sim
opções	Objeto	Uma lista de comportamentos para quando a tag de script é inserida	Consulte a definição Opções abaixo	Sim
groupId	Número	ID do grupo para o qual a tag de script será inserida	ID do grupo Optanon	Sim

OneTrust.InsertHTML

Esse método deve ser usado quando o código que controla a configuração de cookies for uma tag HTML padrão ou personalizada.

O formato é:

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

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

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

Se o grupo Cookies de funcionalidade estiver Inativo, o script não será inserido.

Consulte a tabela abaixo para obter uma explicação dos diferentes parâmetros.

Parâmetro	Tipo de dados	Descrição	Valor	Obrigatório
elemento	String	Tag HTML a ser inserida		Sim
seletor	String	id do elemento principal HTML onde o elemento será inserido	ID principal	Sim
callback	Função	Uma função JavaScript a ser chamada assim que o elemento for inserido	nome da função nulo	Sim
opções	Objeto	Uma lista de comportamentos para quando o elemento é inserido	Consulte a definição Opções abaixo nulo	Sim
groupId	Número	ID do grupo para o qual o elemento será inserido	ID do grupo Optanon	Sim

Nota

Alguns componentes de terceiros que configuram cookies usam elementos JavaScript e HTML que são interdependentes. Na maioria dos casos, você precisará usar os métodos de ajuda em HTML e JavaScript como um par para evitar problemas de um elemento estar presente sem o outro.

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