O Google Tag Manager (GTM) é uma ferramenta que permite gerenciar e implantar tags (snippets de código ou pixels de rastreamento) em seu site sem precisar modificar o código do site.
Se você usar o Google Tag Manager (GTM) para injetar cookies em seu site e gerenciar o conteúdo do site, você pode configurá-lo para que os scripts sejam controlados pelas opções de preferências de consentimento selecionadas pelos visitantes.
Isso pode ser mais eficiente do que usar os métodos auxiliares padrão descritos Gerenciamento de cookies do ponto de vista do cliente na seção deste guia. No entanto, há algumas diferenças de comportamento devido ao funcionamento do GTM.
Esta seção do guia explica como configurar o GTM para aproveitar essas mudanças.
Nota
Este não se destina a ser um guia completo para o Google Tag Manager. Consulte a documentação oficial do Google Tag Manager para obter informações mais detalhadas sobre como configurar e usar o GTM.
Como funciona
Para passar dados para o Google Tag Manager, a ferramenta conformidade com cookies usa Variáveis. Ele oferece suporte a variáveis JavaScript e Data Layer. Recomendamos o uso da Camada de dados GTM e das variáveis da Camada de dados.
A Conformidade de cookies usa o objeto dataLayer existente ou cria um novo se ele ainda não existir. Se o seu site criar um objeto dataLayer, certifique-se de que isso não substitua aquele criado pela Conformidade de cookies.
Ele adiciona uma chave chamada OnetrustActiveGroups com um valor de uma string delimitada por vírgulas dos IDs de categoria ativos atuais, conforme selecionado pelo visitante (ou a configuração padrão). Essa chave é preenchida novamente em cada carregamento de página quando o script é executado.
Quando um usuário atualiza seu consentimento, um evento do dataLayer OneTrustGroupsUpdated é acionado. Você usará esse evento ao criar acionadores para aplicar às suas tags.
Ao criar Acionadores e uma Variável personalizada do GTM, você pode fazer com que as tags do GTM sejam acionadas somente quando grupos de consentimento específicos dentro do OntrustActiveGroups estiverem presentes.
Você pode implementar essa integração de duas maneiras: carregando e mesclando um arquivo de contêiner fornecido ou estabelecendo manualmente acionadores para cada tag.
Observações importantes sobre a integração do Google Tag Manager
O operador de regras e os campos de valor do Google Tag Manager podem ser personalizados se um comportamento diferente for necessário nos exemplos nesta seção.
-
O bloqueio automático é capaz de bloquear o Google Tag Manager. Se isso ocorrer, use um dos seguintes métodos para desbloquear o Google Tag Manager:
j.setAttributeNode(d.createAttribute('data-ot-ignore'));
j.setAttribute('class','optanon-category-C0001');
Como criar uma variável nova
Abra seu contêiner no Gerenciador de tags do Google
Selecione a guia Variáveis no menu principal. É exibida a tela Variável.
Crie uma nova Variável definida pelo usuário.
-
Nomeie a variável.
Dica
Sugerimos nomear a variável OnetrustActiveGroups para que você saiba a que ela se refere.
Defina o Tipo de variável como Variável de camada de dados na seção Variáveis de página.
-
Defina o Nome da variável da Camada de dados como OnetrustActiveGroups.
Nota
O Nome da Variável da Camada de dados deve ser definido como OnetrustActiveGroups para que o código funcione como esperado
Pressione o botão Salvar.
Importante
[en] Custom data layer variables are only supported by OneTrust 6.29 and up.
Para implantar o script de banner em uma tag
Se estiver usando uma tag personalizada do tipo HTML no Google Tag Manager, o conteúdo da tag pode ser um dos seguintes:
Selecione a guia Tags no menu principal. É exibida a tela Tags.
Pressione Novo. É exibido o modal Tag.
Nomeie a tag Script do banner de cookies
Em Configuração de tags, pressione o botão editar. É exibido o modal Escolher tipo de tag.
Selecione HTML personalizado.
[en] Paste the published script into the HTML editor.
-
Cole o script publicado no editor de HTML e marque a caixa Support document.write.
<!-- OneTrust Cookies Consent Notice start -->
<script src="https://cdn.cookielaw.org/scripttemplates/otSDKStub.js"
type="text/javascript" charset="UTF-8" data-domain-script="YOUR DATA DOMAIN SCRIPT ID"></script>
<script type="text/javascript">
function OptanonWrapper()
</script>
<!-- OneTrust Cookies Consent Notice end -->
Clique no ícone Acionamento. É exibido o modal Escolher um acionador.
Selecione Todas as páginas.
Clique em Salvar.
No GTM, os acionadores exibem tags para disparar ou não em certos critérios. Talvez você já tenha uma variedade de acionadores diferentes aplicados às suas tags.
Como parte da integração de Conformidade de cookies com o GTM, você criará um acionador associado a cada categoria de cookie.
Quando você aplica esses acionadores às suas tags, isso fará que elas sejam acionadas ou não com base na ativação da Categoria de cookies, ou no consentimento dado pelo usuário.
Você precisará de um acionador separado para cada uma das Categorias de cookies em que você bloqueará os cookies. Por exemplo, você pode ter um grupo denominado "Cookies de desempenho", que tem um id de categoria C0002 e contém os cookies definidos por sua tag do Google Analytics.
Cada acionador precisa estar de acordo com os ids de categoria definidos em seu aplicativo de consentimento de cookies. Você pode encontrar os IDs de categoria de cookie no aplicativo de consentimento de cookie em Categorizações.
Queremos que os acionadores do id da categoria de cookies OneTrust que você cria ou carrega sejam aplicados às suas tags existentes, de tal forma que o acionador do OneTrust seja o fator limitante para o acionamento da tag. Isso pode ser feito de várias maneiras diferentes. Três maneiras diferentes são descritas abaixo.
Criando um Acionador que dispara
Como usar acionadores que disparam em tags existentes e criar um grupo de acionadores
Criando Acionadores de exceção
Como criar um acionador que dispara
Abra seu contêiner no Gerenciador de tags do Google
Selecione a guia Acionadores no menu principal. É exibida a tela Acionadores.
Pressione Novo. É exibida a tela Configuração do acionador.
Nomeie-o de acordo, por ex. Cookies de desempenho ativos.
Pressione Configuração do acionador e defina o Tipo de acionador como Evento personalizado.
Defina o Nome do evento como OneTrustGroupsUpdated. Este evento está incorporado ao script.
-
Selecione Algumas visualizações de páginas e defina-as para serem acionadas quando o seguinte for verdadeiro:
[OnetrustActiveGroups] [matches RegEx] [,C0002,]
Salve o acionador.
Repita este processo para as restantes Categorias de cookies.
Aplique os acionadores a tags como um gatilho de disparo.
Nota
Se uma tag for bloqueada e, em seguida, permitida, ela será ativada sem a necessidade de recarregar a página, devido à escuta do OneTrustGroupsUpdated. Se tivesse sido permitida anteriormente e então bloqueada, a tag seria bloqueada nos carregamentos subsequentes da página.
Para criar um acionador de exceção
Você também pode configurar um acionador de exceção para acionar o script se uma categoria de cookies não estiver ativa.
Você só vai querer usar um acionador de exceção se você já tiver um acionador de disparo diferente configurado em sua tag.
Nota
No Google Tag Manager, os acionadores de bloqueio devem disparar no mesmo evento que os acionadores ativos.
Por exemplo, defina um acionador para disparar quando os Grupos ativos do OneTrust não contiverem C0002 (onde C0002 é o id para cookies de desempenho). Aplique esse acionador de bloqueio como uma exceção a tags neste grupo.
Selecione a guia Acionadores no menu principal. É exibida a tela Acionadores.
Pressione Novo. É exibida a tela Configuração do acionador.
Crie um novo acionador e o nomeie de acordo, por exemplo Bloquear cookies de desempenho.
Pressione Configuração do acionador e defina o Tipo de acionador como Evento personalizado.
Defina o Nome do evento como .*. Esse evento se aplica a todos os eventos e permitirá que o acionador de exceção substitua o evento que está no acionador de acionamento.
Defina o Acionador para disparar em Alguns eventos personalizados.
-
Selecione Visualizações de algumas páginas e defina o Acionador para ser acionado quando o seguinte for verdadeiro:
[OnetrustActiveGroups] [does not match RegEx] [,C0002,]
Salve o acionador.
Repita este processo para as restantes Categorias de cookies.
Aplicar o acionador a tags como uma exceção.
Como usar acionadores que disparam em tags existentes e criar um grupo de acionadores
Ao usar um acionador que dispara, você deseja fazer com que o acionador OneTrust seja o fator limitante para o disparo da tag.
Você só desejará usar um grupo de acionadores se já tiver um acionador de disparo configurado na sua tag.
Os grupos de acionadores utilizam as condições "AND", onde, como aplicação direta de vários acionadores a uma tag a ser acionada, utiliza uma condição "OR".
Acionadores que disparam aplicados diretamente:
Dentro do grupo de acionadores:
Este é outro método para configurar os acionadores OneTrust e aplicá-los às suas tags, de modo que esses sejam o fator limitante para o acionamento das tags.
Selecione a guia Acionadores no menu principal. É exibida a tela Acionadores.
Pressione Novo. É exibida a tela Configuração do acionador.
Crie um novo acionador e nomeie-o de acordo, por exemplo, Grupo de acionadores de exemplo.
Pressione Configuração do acionador e defina o Tipo de acionador como Grupo de acionadores.
Usando um contêiner para integração com o Google Tag Manager
Para importar um contêiner
Abra seu contêiner no Gerenciador de tags do Google
-
Acesse a guia Admin.
Faça download do contêiner a partir do link no final do artigo.
-
Clique em Importar contêiner.
Selecione o arquivo de contêiner baixado.
Selecione Mesclar e, em seguida, Substituir tags, acionadores e variáveis conflitantes como a opção de importação.
Clique no botão Confirmar.
Para adicionar os acionadores às tags
No menu de navegação principal do Google Tag Manager, selecione .
Selecione uma tag para aplicar o Acionador de categoria de cookie OneTrust apropriado.
Aplique o Acionador de disparo, Grupo de acionamento ou Acionador de exceção apropriado que você criou.
Clique no botão Salvar.
Como bloquear tags usando o cookie OptanonConsent
Além da variável de camada de dados OneTrustActiveGroups, o arquivo OTSDKstub.js também define o cookie interno, OptanonConsent, para capturar o consentimento do usuário. Ao decodificar o valor do cookie OptanonConsent, o consentimento atual pode ser lido. Para obter mais informações, consulte Cookies OneTrust.
Como criar uma variável nova
Abra seu contêiner no Gerenciador de tags do Google
Selecione a guia Variáveis no menu principal. É exibida a tela Variável.
Crie uma nova Variável definida pelo usuário.
-
Nomeie a variável.
Dica
Sugerimos nomear a variável OptanonConsent para que você saiba a que ela se refere.
Defina o Tipo de variável como Variável interna na seção Variáveis de página.
-
Defina o Nome da variável da Camada de dados como OptanonConsent.
Nota
O Nome da Variável da camada de dados deve ser definido como OptanonConsent para que o código funcione como esperado. Além disso, a opção cookie de decodificação URI deve estar ativada.
Pressione o botão Salvar.
Semelhante à configuração da variável de camada de dados OnetrustActiveGroups, os acionadores ativos e de bloqueio serão criados para cada categoria de cookie dentro da conta. Como o cookie OptanonConsent está configurado no carregamento da página, isto permite que você acione as tags cliente antes do evento OneTrustGroupsUpdated, normalmente usado pela variável da camada de dados, para bloquear Categorias de cookies.
Por exemplo, se você estiver usando um evento de comércio eletrônico definido na camada de dados, você pode usar o cookie OptanonConsent pela variável de camada de dados OneTrustActiveGroups para acionar suas tags analíticas no evento de comércio eletrônico em vez de no OneTrustGroupsUpdated.
Como criar um acionador que dispara
Abra seu contêiner no Gerenciador de tags do Google
Selecione a guia Acionadores no menu principal. É exibida a tela Acionadores.
Pressione Novo. É exibida a tela Configuração do acionador.
Nomeie-o de acordo, por exemplo, Cookie interno - Desempenho ativo - OT.
-
Pressione Configuração do acionador e defina o Tipo de acionador ao caso de uso relevante.
Nota
A adição de acionamentos de Visualização de página ou DOM pronto, provavelmente fará com que os acionadores não sejam acionados no carregamento da primeira página.
Configure o Nome do evento para o evento no qual a tag afetada será ativada. Isso difere da variável da camada de dados OneTrustActiveGroups, que deve ser acionada no evento OneTrustGroupsUpdated.
-
Selecione o acionador relevante e defina-o para disparar quando o seguinte for verdadeiro:
[OptanonConsent] [contains] [C0002:1]
Salve o acionador.
Repita este processo para as restantes Categorias de cookies.
Aplique os acionadores a tags como um gatilho de disparo.
Para criar um acionador de exceção
Abra seu contêiner no Gerenciador de tags do Google
Selecione a guia Acionadores no menu principal. É exibida a tela Acionadores.
Pressione Novo. É exibida a tela Configuração do acionador.
Nomeie-o de acordo, por exemplo, Cookie interno - Desempenho de bloqueio - OT.
Pressione Configuração do acionador e defina o Tipo de acionador ao caso de uso relevante.
Configure o Nome do evento para o evento no qual a tag afetada será ativada. Isso difere da variável da camada de dados OneTrustActiveGroups, que deve ser acionada no evento OneTrustGroupsUpdated.
-
Selecione o acionador relevante e defina-o para disparar quando o seguinte for verdadeiro:
[OptanonConsent] [does not contain] [C0002:1]
Salve o acionador.
Repita este processo para as restantes Categorias de cookies.
Aplique os Acionadores às Tags como um acionador de exceção.
Para aproveitar os atributos de dataLayer
Usando os seguintes atributos do dataLayer, você pode impedir que o OneTrust CDN seja enviado ao window.dataLayer ou criar um novo dataLayer para que você tenha controle sobre como as mensagens são enviadas ao GTM.
Desativar o CDN enviado para window.dataLayer
-
Insira o atributo data-dLayer-ignore em seu script.
Exemplo:
<script src="https:/cdn.cookielaw.org/scripttemplates/otSDKStub.js"
type="text/javascript" charset="UTF-8" data-domain-script="XXXXX"
data-dLayer-ignore="true"></script>
Ativar o CDN enviado a uma nova camada de dados
-
Insira o atributo data-dLayer-name seu script.
Exemplo:
<script src="https://cdn.cookielaw.org/scripttemplates/otSDKStub.js"
type="text/javascript" charset="UTF-8" data-domain-script="XXXXXX"
data-dLayer-name="dataLayerOneTrust"></script>
Isso permite que o CDN seja enviado somente para sua dataLayer. Envios ao widow.dataLayer estão desativados.
Solução de problemas: Support Document.Write
Se você estiver usando o Google Tag Manager e tiver mais de uma tag ou contêiner com a caixa de seleção ‘Support Document.Write’ marcada, isso pode impedir que o script seja acionado corretamente.
Para confirmar, bloqueie o URL de solicitação do contêiner que não contém a tag CookiePro/OneTrust tag.
Para resolver esse problema, defina a tag que está causando o conflito após o script CookiePro/OneTrust ter sido completamente carregado.
Isso pode ser feito configurando a tag em questão para usar um acionador de acionamento que depende do evento OnetrustGroupsUpdated que é pressionado dentro da camada de dados assim que o script é concluído. Esta correção é semelhante ao método usado para garantir que os cookies não sejam descartados para os usuários com base nas preferências de consentimento.
