Funcionalidades

Instale o comando padrão personalizado

Use essa abordagem quando você mantiver sua própria implementação Google Consent Mode sequencial e precisar definir o estado de consentimento padrão diretamente na página. O Google documenta que o comando de consentimento padrão deve ser adicionado em todas as páginas e atualizado quando um visitante interage com seu banner de consentimento.

CookiePal já implementa este comando por padrão quando você usa sua configuração Google Consent Mode padrão. A instalação manual geralmente só é necessária para implementações personalizadas, por exemplo, quando você gerencia sua própria configuração gtag embutida, carrega tags fora de CookiePal ou Google Tag Manager ou precisa que o comando de consentimento padrão seja executado em uma ordem de script personalizada antes da execução de outras tags.

Instale o script personalizado no head de cada página, antes da tag do Google ou da inicialização Google Tag Manager e antes de qualquer comando gtag posterior que possa enviar dados de medição, como gtag('js', ...) , gtag('config', ...) ou gtag('event', ...) .

Esta ordem é importante. A orientação de solução de problemas do Google observa que carregar o comando padrão tarde demais pode acionar o erro Tag Assistant "Um estado de consentimento de leitura de tag antes de um padrão ser definido".

Se as atualizações do seu banner ou CMP consentirem de forma assíncrona, o valor wait_for_update fornecerá um window curto para enviar a atualização de consentimento correspondente antes que a medição seja enviada.

Exemplo de script personalizado

Exemplo de script embutido personalizado:

1<script>
2window.dataLayer = window.dataLayer || [];
3function gtag() {
4  dataLayer.push(arguments);
5}
6gtag('consent', 'default', {
7  'ad_personalization': 'denied',
8  'ad_storage': 'denied',
9  'ad_user_data': 'denied',
10  'analytics_storage': 'denied',
11  'functionality_storage': 'denied',
12  'personalization_storage': 'denied',
13  'security_storage': 'granted',
14  'wait_for_update': 500,
15});
16gtag('set', 'ads_data_redaction', true);
17gtag('set', 'url_passthrough', true);
18</script>

NOTA: Se você usar WordPress, consulte a seção WordPress. Se você usar Shopify , consulte a seção Shopify. Se você usar Next.js , consulte a seção Next.js.

Exemplo de configurações de região

O Google recomenda definir o escopo dos padrões negados para as regiões onde você realmente exibe um banner de consentimento. Isso ajuda a preservar a medição em outros lugares e evita deixar os visitantes com padrões negados, mas sem banner para atualizar o consentimento.

Você pode fazer isso com o parâmetro região. O Google documenta esses valores como códigos de região ISO 3166-2, portanto, códigos de país como GB e códigos de subdivisão como US-AK podem ser usados ​​quando apropriado.

Exemplo de comando específico da região:

1<script>
2window.dataLayer = window.dataLayer || [];
3
4function gtag() {
5  dataLayer.push(arguments);
6}
7// EU-specific settings
8gtag('consent', 'default', {
9  'ad_personalization': 'denied',
10  'ad_storage': 'denied',
11  'ad_user_data': 'denied',
12  'analytics_storage': 'denied',
13  'functionality_storage': 'denied',
14  'personalization_storage': 'denied',
15  'region': [
16    'AT', 'BE', 'BG', 'CH', 'CY', 'DE', 'DK', 'EE', 'ES', 'FI',
17    'FR', 'GB', 'GG', 'GR', 'HR', 'HU', 'IE', 'IM', 'IT', 'JE', 'LT', 'LU',
18    'LV', 'MT', 'NL', 'PL', 'PT', 'RO', 'SE', 'SI', 'SK',
19  ],
20  'wait_for_update': 500,
21});
22// Default settings
23gtag('consent', 'default', {
24    'ad_personalization': 'granted',
25    'ad_storage': 'granted',
26    'ad_user_data': 'granted',
27    'analytics_storage': 'granted',
28    'functionality_storage': 'granted',
29    'personalization_storage': 'granted',
30    'security_storage': 'granted',
31    'wait_for_update': 500,
32});
33gtag('set', 'ads_data_redaction', true);
34gtag('set', 'url_passthrough', true);
35</script>

NOTA: Se você usar um comando com escopo de região como este, certifique-se de que seu banner tenha como alvo as mesmas regiões e adicione qualquer comando padrão de fallback fora da região que sua política exige para visitantes fora dessa lista.

O que ads_data_redaction faz

Quando ad_storage é denied , o Google diz que os cookies de publicidade não estão definidos, mas os URLs de solicitação ainda podem conter informações de clique no anúncio. A configuração de gtag('set', 'ads_data_redaction', true) edita ainda mais os identificadores de clique em anúncios nas solicitações de rede Google Ads e Floodlight e envia essas solicitações por meio de um domínio sem cookies.

Esta configuração só tem efeito quando o modo de consentimento está sendo usado e ad_storage é negado. Se ad_storage for concedido, o Google documentará que ads_data_redaction não terá efeito.

Consulte a documentação oficial de redação de dados de anúncios do Google para obter o comportamento detalhado da redação de dados de anúncios.

O que url_passthrough faz

Quando ad_storage ou analytics_storage é negado, url_passthrough permite que o Google transmita informações de cliques no anúncio, clientes e sessões por meio de parâmetros de URL do mesmo domínio para que a medição possa continuar nas páginas sem depender de cookies.

O Google observa que isso funciona apenas em casos específicos, como quando o modo de consentimento é implementado e a navegação permanece no mesmo domínio. Como ele pode anexar parâmetros como gclid , dclid , gclsrc , _gl ou wbraid a URLs, certifique-se de que seus redirecionamentos os preservem e que seu site possa ignorá-los com segurança quando necessário.

Consulte a documentação oficial de passagem de URL do Google para obter os requisitos de configuração e as limitações da passagem de URL.

Instale-o em WordPress com WPCode

Se o seu site rodar em WordPress , você pode adicionar o comando padrão sem editar os arquivos do tema usando o plugin WPCode para inserir um snippet PHP.

Na área de administração do WordPress, vá para Plugins > Adicionar novo, pesquise WPCode, instale e ative o plugin.

Abra Snippets de código e crie um novo snippet. Escolha PHP Snippet como o tipo de código, cole o código a seguir e salve-o como um novo snippet.

1add_action('wp_head', function () {
2    ?>
3    <script>
4        window.dataLayer = window.dataLayer || [];
5        function gtag(){ dataLayer.push(arguments); }
6
7        gtag('consent', 'default', {
8            "ad_personalization": "denied",
9            "ad_storage": "denied",
10            "ad_user_data": "denied",
11            "analytics_storage": "denied",
12            "functionality_storage": "denied",
13            "security_storage": "granted",
14            "personalization_storage": "denied",
15            "wait_for_update": 500
16        });
17
18        gtag("set", "ads_data_redaction", true);
19        gtag("set", "url_passthrough", true);
20    </script>
21    <?php
22}, 0);

Nas configurações do snippet, defina o valor Priority como 0 para que o comando de consentimento padrão seja executado o mais cedo possível no cabeçalho da página.

Certifique-se de que o snippet esteja marcado como Ativo e clique em Atualizar para salvá-lo.

Após salvar, confirme se o snippet aparece na lista WPCode com Tipo de código definido como PHP, Prioridade definido como 0 e a alternância de status habilitada.

Instale-o em Shopify

Se sua loja for executada em Shopify , você poderá adicionar o comando padrão diretamente no código do seu tema usando o mesmo script mostrado na seção Exemplo de script personalizado acima.

No admin do Shopify, vá para Loja Online > Temas. Abra o menu do seu tema atual e clique em Editar código.

No editor de código, abra Layout > theme.liquid. Encontre a tag de abertura <head> e cole o comando padrão do exemplo anterior imediatamente após ele, antes do script de banner da CookiePal, da tag do Google ou da inicialização Google Tag Manager.

Clique em Salvar no canto superior direito para publicar a alteração.

Instale-o em Next.js

Se o seu site for executado em Next.js , adicione o comando padrão no seu layout raiz, como app/layout.tsx, antes do script de banner da CookiePal, tag do Google ou inicialização Google Tag Manager.

Mantenha o conteúdo do script como uma string dentro do elemento <script>. Não cole o objeto diretamente como JSX, ou Next.js tentará interpretá-lo em vez de renderizá-lo como conteúdo de script embutido.

Use o mesmo comando padrão mostrado no Exemplo de script personalizado, mas adapte-o para que o corpo JavaScript fique dentro de uma string, assim:

1<script>
2  {`window.dataLayer = window.dataLayer || [];
3  function gtag() {
4    dataLayer.push(arguments);
5  }
6  gtag('consent', 'default', {
7    'ad_personalization': 'denied',
8    'ad_storage': 'denied',
9    'ad_user_data': 'denied',
10    'analytics_storage': 'denied',
11    'functionality_storage': 'denied',
12    'personalization_storage': 'denied',
13    'security_storage': 'granted',
14    'wait_for_update': 500,
15  });
16  gtag('set', 'ads_data_redaction', true);
17  gtag('set', 'url_passthrough', true);`}
18</script>

Salve suas alterações e implante a versão atualizada do seu site Next.js.

Nota importante sobre pedido

O comando padrão personalizado deve ser executado antes de qualquer comando gtag posterior e antes de qualquer evento que possa ser acionado no carregamento da página. O Google também recomenda registrar a atualização de consentimento na mesma página onde o visitante interage com o banner, antes de qualquer transição de página.