...
O sistema de gerenciamento de cookies possui diversos modos e formatos de integração a depender da estrutura e tecnologia do seu portal.
| Info |
|---|
Premissa 1: Você já criou e personalizou a sua barra e janela de cookies na plataforma da PrivacyTools e agora você quer saber como colocar no ar. Se ainda não fez essa configuração faça primeiro antes de continuar aqui. Premissa 2: Você já fez Siga essa documentação caso você já tenha feito o mapeamento de todos os seus cookies (menu ‘Mapeamento’) em suas devidas categorias. Caso não tenha feita, saiba como aqui. |
...
Passo 1 - Colocando o script em seu portal
O primeiro passo será a publicação simples em seu portal mesmo que ainda os cookies não estejam sendo bloqueados, mas você aprenderá a como colocar o script.
| Expand |
|---|
title | Integração padrão| Info |
|---|
Acesse em: Marketing & UX → Gestão de Cookies → Integrações |
É possível inserir seu banner no portal por meio de 3 tipos de integrações, sendo elas:
Integração Manual:
Acesse o menu “Integrações” e clique no botão “Integração
...
Manual”
Selecione o website e selecione o seu banner já criado.
Defina a posição do seu Banner.
Copie o código indicado no campo de script.
No HTML do seu portal coloque esse script imediatamente antes do fechamento da tag “</body>”
| Note |
|---|
| Importante: Não tente alterar o formato do script ou a sua ordem de execução no código. |
Exemplo:
| Code Block |
|---|
|
SCRIPT_COPIADO
</body>
</html> |
...
Integração Automática:
Acesse o menu “Integrações” e clique no botão “Integração Manual”
Selecione o website e selecione o seu banner já criado.
| Expand |
|---|
| title | Autoblock: Diferença entre as versões |
|---|
|
Autoblock V1: Implementação básica que bloqueia cookies não essenciais antes do consentimento. Autoblock V2: Suporte aprimorado com categorização de cookies, como "Essenciais", "Analíticos" e "Publicidade". Autoblock V3: Solução mais avançada, com bloqueio dinâmico em tempo real e detecção automática de scripts e cookies.
|
Copie o código indicado no campo de script.
Insira o código abaixo no início da tag head do seu site (Passo 3)
Insira o código abaixo no final da tag bod (Passo 4)
| Expand |
|---|
| title | Integração auto-block |
|---|
|
| 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. |
Acesse o menu “Integrações” e clique no botão “Integração auto-block”; Selecione o website e o banner que irá utilizar na integração; Escolha a versão de Autoblock: ‘autoblock v2’; Em seu HTML Insira o primeiro script imediatamente APÓS a ABERTURA da tag <body> ou tag <head>; Em seu HTML insira o segundo script imediatamente ANTES do FECHAMENTO da tag </body> ou tag </head>; 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 |
|---|
| <html>
<body>
<<PRIMEIRO SCRIPT - AUTO-BLOCK>>
...
<<SEGUNDO SCRIPT>>
</body>
</html> |
Exemplo do script no head: | Code Block |
|---|
| <html>
<head>
<<PRIMEIRO SCRIPT - AUTO-BLOCK>>
...
<<SEGUNDO SCRIPT>>
</head>
</html> |
|
Pronto, agora você já sabe ...
Integração Google Tag Manager
Clique aqui para ser direcionado até a documentação de tal integração.
...
Agora com o já conhecimento de como colocar o script da barra e janela de cookies e nesse momento , elas já devem aparecer no seu website com o estilo, cores e comportamento que você escolheu escolhidos ao criar o componente.
Mas espere, Como os cookies ainda estão sendo criados, certo? Vamos aprender a iremos ver como fazer o bloqueio agora.dos cookies:
...
Passo 2 - Bloqueando cookies
...
| Expand |
|---|
|
Passo 2.1 - Definindo códigos para cada grupo ou cookieO 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 HTMLAgora 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 |
|---|
| title | Integração auto-block |
|---|
|
Passo 2.1 - Bloqueio de cookiesO 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 cookies que seriam executados no website ao fazer o primeiro acesso e os bloqueia.  Image Removed
Pressionando este botão, aparecerá um pop-up, solicitando a confirmação de exclusão.É possível adicionar o script do autoblock em “Analisador de Script”:  Image Added
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: | Note |
|---|
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.
|
|
...
Ficou com dúvidas? Chame o Time de Suporte 👈