Versions Compared

Version Old Version 8 New Version 9
Changes made by

Nilson Deparis (Unlicensed)

Henrique Bernst

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

O sistema de gerenciamento de cookies possui diversos modos e formatos de integração a depender da estrutura e tecnologia do seu portal.

...

Expand
titleIntegração padrão

  1. Acesse o menu “Integrações” e clique no botão “Integração Padrão”

  2. Selecione o website e selecione o seu banner já criado.

  3. Copie o código indicado no campo de script.

  4. No HTML do seu portal coloque esse script imediatamente antes do fechamento da tag “</body>”

  5. Importante: Não tente alterar o formato do script ou a sua ordem de execução no código.

Exemplo:

Code Block
languagehtml
SCRIPT_COPIADO
</body>
</html>
Expand
titleIntegração auto-block

A integração auto-block possui um passo a mais mas esse formato é responsável não apenas pela exibição da barra de cookies mas também pelo bloqueio dos cookies. Mais adiante você aprenderá a como configurar o bloqueio.

Note

Atenção - Como o auto-block executa em modo bloqueante, o seu site dependerá do script para executar. Para reduzir a latência e a chance de falhas você pode fazer o download do script clicando no botão “Baixe arquivo autoblock.js” e coloca-lo em seu próprio servidor.

Info

Nota:

Se por padrão você costuma adicionar seus scripts na tag HEAD, então deve-se colocar o script como primeiro elemento da tag HEAD.
Se por padrão você costuma adicionar seus scripts na tag BODY, então deve-se colocar o script como primeiro elemento da tag BODY.

  1. Acesse o menu “Integrações” e clique no botão “Integração auto-block”;

  2. Selecione o website e selecione o seu banner já criado.banner que irá utilizar na integração;

  3. Escolha a versão de Autoblock: ‘autoblock v2’;

  4. Em seu HTML Insira o primeiro script imediatamente APÓS a ABERTURA da tag <body> ou tag <head>;

  5. Em seu HTML insira o segundo script imediatamente ANTES do FECHAMENTO da tag </body> ou tag </head>;

  6. Importante: Não tente alterar o formato do script ou a sua ordem de execução no código.

Exemplo script no body:

Code Block
languagehtml
<html>
<body>
<<PRIMEIRO SCRIPT - AUTO-BLOCK>>
...
<<SEGUNDO SCRIPT>>
</body>
</html>

Exemplo do script no head:

Code Block
languagehtml
<html>
<head>
<<PRIMEIRO SCRIPT - AUTO-BLOCK>>
...
<<SEGUNDO SCRIPT>>
</head>
</html>

...

Expand
titleIntegração padrão

Passo 2.1 - Definindo códigos para cada grupo ou cookie

O bloqueio ocorre através do mapeamento de códigos no sistema com alterações que você precisa realizar em seu website. Cada “Grupo de cookie” e cada “Cookie” possui um campo chamado “Código do script”.

  • Se na criação do seu Banner você escolheu o tipo de coleta “Baseada em grupos”, então você precisa colocar códigos de script em cada grupo no menu “Gestão de cookies/Grupos de cookies”

  • Se na criação do seu Banner você escolheu o tipo de coleta “Baseada em cookies” então você precisa colocar códigos de script em cada cookie no menu “Gestão de cookies/Mapeamento” - Não se preocupe que o sistema já coloca automaticamente caso você tenha esquecido.

Passo 2.2 - Modificando o seu HTML

Agora que cada grupo e cada cookie foi classificado, a próxima tarefa é a mudança no seu código-fonte para bloquear os cookies. Veja os exemplos abaixo.

Como é

Como deve ficar

Em seu código HTML você possui importações e inicializações de scripts como no exemplo abaixo.

Code Block
<script src="//cdn.onesignal.com/sdks/OneSignalSDK.js" ></script>

<script>
  var OneSignal = window.OneSignal || [];
  OneSignal.push(function() {
    OneSignal.init({
      appId: "2733d6f1-5b7c-4fd8-9fa6-1563db7afe8a",
    });
  });
</script>

O primeiro passo é bloquear a execução do script de inicialização e o segundo passo é colocar nele o identificador do seu grupo ou cookie conforme mapeamento anterior.

Code Block
<script src="//cdn.onesignal.com/sdks/OneSignalSDK.js" ></script>

<script type="text/plain" class="codigo-cookie-grupo">
  var OneSignal = window.OneSignal || [];
  OneSignal.push(function() {
    OneSignal.init({
      appId: "2733d6f1-5b7c-4fd8-9fa6-1563db7afe8a",
    });
  });
</script>

Substitua o “codigo-cookie-grupo” pelo seu código definido, sejam no grupo ou no cookie, que corresponde a esse script.

Pronto, com esse simples passo o seu website não inicializará mais aquele trecho de script a menos que o usuário conceda seu consentimento no grupo ou no cookie individualmente, ou aceite todos os cookies.

Note

Importante: Caso o seu script possua tanto a biblioteca quanto o código de inicialização no mesmo arquivo “javascript” então você não poderá fazer essa configuração. Recomendamos nesse caso o uso do “autoblock” (caso a biblioteca possa não ser executada sem prejudicar seu portal) ou da separação, colocando o trecho de inicialização no HTML e deixando apenas a biblioteca no arquivo externo.

Expand
titleIntegração auto-block

Passo 2.1 -

Mapeando arquivos javascript

Você precisa indicar para o sistema qual biblioteca Javascript é responsável pela criação de determinado cookie de modo que o autoblock possa prevenir essa biblioteca de ser executada antes do consentimento.

  1. Clique no menu “Gestão de cookies/Analisador de script”

  2. Procure o arquivo javascript (caso o ‘Monitoramento de sites’ tenha encontrado) que é importado pelo seu website e clique nele. Caso não encontre clique no botão “Adicionar Script” e cadastre a sua biblioteca.

  3. Vincule a biblioteca selecionada com um ou vários cookies. Você precisa saber quais cookies são criados por quais bibliotecas nesse caso.

Pronto. Com essa atividade feita o sistema irá bloquear o carregamento do arquivo Javascript mapeado, sem que você tenha que modificar nada em seu portal.

É possível excluir script localizado no ‘Analisador de script’, através do botão vermelho com a imagem de uma lixeira, conforme imagem a seguir:

Bloqueio de cookies

O Autoblock faz o bloqueio automático dos cookies através do primeiro script inserido no inicio do seu arquivo HTML, ao executar este script ele faz o reconhecimento dos cookie que seriam executados no website ao fazer o primeiro acesso e os bloqueia.

Pressionando este botão, aparecerá um pop-up, solicitando a confirmação de exclusão.

Confirmada a exclusão, o script é removido do seu Analisador de script.

Também, há a possibilidade de excluir todos os scripts de um website, caso deseje, para isso precisamos selecionar o site desejado e apertar o botão ‘Limpar Script’, conforme imagem a seguir:

Após clicar no botão ‘Limpar scripts' irá aparecer um pop-up solicitando a confirmação da requisição:

Clicando em ‘Ok’ a plataforma irá excluir todos os scripts adicionados a este site em especifico.

Note

Avisos e limitações: O autoblock funciona realizando o bloqueio da execução do arquivo javascript responsável pela criação do cookie. Ele só deve ser usado se você pode bloquear arquivos completos sem prejudicar a experiência do seu usuário. Por exemplo:


1. <script src="//cdn.onesignal.com/sdks/OneSignalSDK.js" ></script> ← Isso será bloqueado
2. <script> var OneSignal = window.OneSignal || []; ← Isso não será bloqueado mas como ele faz “||[]” o objeto não lançará erro no navegador do usuário e a linha seguinte poderá ser executada normalmente.
3. OneSignal.push(function() { OneSignal.init({ appId: "2733d6f1-5b7c-4fd8-9fa6-1563db7afe8a", }); }); </script> ← A linha 3 não surtirá nenhum efeito prático.