Resolver problemas no modo de consentimento com o Assistente de tags

Este artigo é destinado a desenvolvedores e administradores que gostariam de verificar e solucionar problemas relacionados à implementação do modo de consentimento no site. No caso de implementações em sites, consulte Resolver problemas do TCF. Se quiser verificar implementações em apps, confira as instruções para Android e iOS.

É possível verificar a implementação do modo de consentimento para saber:

  • Se o site define o estado de consentimento padrão certo antes de as tags serem disparadas. O padrão apropriado depende das políticas da sua organização.
  • Se o site atualiza corretamente os estados de consentimento após os visitantes darem ou negarem permissão.
  • Quais tipos de consentimento cada tag verifica.
  • Se os tipos de consentimento necessários foram concedidos quando cada tag foi acionada, e se a tag passou nas verificações para qualquer outro consentimento necessário.

O Assistente de tags é compatível com os seguintes mecanismos de consentimento:

Antes de começar

Você pode usar o Assistente de tags em todos os navegadores. Para conseguir resolver melhor os problemas, utilize o Google Chrome e instale a extensão Tag Assistant Companion no navegador.

Verificar se o modo de consentimento funciona

As etapas a seguir mostram como depurar o modo de consentimento. Caso você tenha definido padrões ou banners de consentimento específicos das regiões, repita essas etapas com outras localizações geográficas simuladas. Saiba como definir locais no Chrome.

gtag.js

Se quiser verificar sua configuração de consentimento para sites, inicie uma nova sessão do Assistente de tags:

  1. Abra o Assistente de tags do Google.

  2. Insira o URL do seu site. Uma nova guia com o site será aberta.

  3. No seu site, abra o banner de consentimento e aceite todos os parâmetros.

  4. No Assistente de tags, verifique se a página definiu o consentimento padrão de forma correta:

    1. Em Resumo, selecione o evento de consentimento mais antigo.
    2. Na seção Chamada de API, verifique se os parâmetros a seguir foram definidos: ad_storage, ad_personalization, ad_user_data e analytics_storage.

    3. Outra opção é selecionar a guia Consentimento na coluna Saída da seção da tag e verificar a coluna Padrão na página.

      Captura de tela do Assistente de tags mostrando as configurações de consentimento padrão

  5. Verifique se a página atualizou o consentimento com base na sua interação com o banner:

    1. Em Resumo, selecione o evento de consentimento mais recente.
    2. Na seção Chamada de API, verifique se os parâmetros a seguir foram atualizados: ad_storage, ad_personalization ad_user_data e analytics_storage.

    3. Outra opção é selecionar a guia Consentimento na coluna Saída da seção da tag e verificar a coluna Atualização na página.

      Captura de tela do Assistente de tags mostrando as configurações de consentimento atualizadas

Gerenciador de tags

Se quiser verificar sua configuração de consentimento para sites, inicie uma nova sessão do Assistente de tags:

  1. Abra o Assistente de tags do Google.

  2. Insira o URL do seu site. Uma nova guia com o site será aberta.

  3. No seu site, abra o banner de consentimento e aceite todas as opções.

  4. No Assistente de tags, verifique se a página definiu o consentimento padrão de forma correta:

    1. Em Resumo, selecione o evento de consentimento mais antigo.
    2. Na seção Chamada de API, verifique se os parâmetros a seguir foram definidos: ad_storage, ad_personalization, ad_user_data e analytics_storage.

    3. Outra opção é selecionar a guia Consentimento na coluna Saída da seção da tag e verificar a coluna Padrão na página.

      Captura de tela do Assistente de tags mostrando as configurações de consentimento padrão

  5. Verifique se a página atualizou o consentimento com base na sua interação com o banner:

    1. Em Resumo, selecione o evento de consentimento mais recente.
    2. Na seção Chamada de API, verifique se os parâmetros a seguir foram atualizados: ad_storage, ad_personalization ad_user_data e analytics_storage.

    3. Outra opção é selecionar a guia Consentimento na coluna Saída da seção da tag e verificar a coluna Atualização na página.

      Captura de tela do Assistente de tags mostrando as configurações de consentimento atualizadas

  6. Verifique quais tags foram disparadas ou bloqueadas pelo estado de consentimento:

    1. Em Resumo, selecione a guia Tags.
    2. Clique em uma tag para verificar se o comportamento dela seguiu as configurações de consentimento:

Selecione um problema para conferir instruções sobre como resolvê-lo:

A guia Consentimento do Assistente de tags fica vazia quando o modo de consentimento não está implementado na página.

Para corrigir o problema, é necessário implementar o modo de consentimento. Nas instruções abaixo, consideramos que você já tem um banner de consentimento no seu site.

gtag.js

Vídeo: como configurar o modo de consentimento

gtag('consent', 'default', {
      'ad_storage': 'denied',
      'analytics_storage': 'denied',
      'ad_user_data': 'denied',
      'ad_personalization': 'denied',
});

Instruções: como configurar o modo de consentimento

Se você usa uma plataforma de gestão de consentimento (CMP) para carregar um banner de consentimento:

  1. Descubra se a sua CMP é compatível com o modo de consentimento do Google.
  2. Revise as configurações da CMP para ativar o modo de consentimento do Google.
  3. Verifique se o modo de consentimento funciona.

Se você tem um banner próprio de consentimento, ou sua CMP não se integra automaticamente ao modo de consentimento, faça a implementação de forma manual.

Gerenciador de tags

Se você usa o Gerenciador de tags, a abordagem recomendada para a implementação é utilizar uma plataforma de consentimento que oferece um modelo do Gerenciador de tags. Para configurar um banner de consentimento usando o Gerenciador de tags:

  1. Abra o Gerenciador de tags do Google.
  2. No espaço de trabalho, abra o menu Tags.
  3. Configure uma nova tag. Clique em Configuração da tag e abra a Galeria de modelos da comunidade.
  4. Pesquise a tag do provedor da sua CMP e clique em Adicionar ao espaço de trabalho.
  5. Preencha os campos no modelo de tag. O provedor da CMP tem mais informações sobre os campos obrigatórios.
  6. Em "Acionamento", escolha o acionador Inicialização de consentimento: todas as páginas.
  7. Salve a tag e confira uma prévia do contêiner para verificar se o modo de consentimento funciona.

Se você tem um banner próprio de consentimento, ou sua CMP não se integra automaticamente ao modo de consentimento, faça a implementação de forma manual.

É fundamental definir um consentimento padrão em todos os parâmetros do modo de consentimento para corrigir a implementação. Saiba mais sobre os requisitos de consentimento do Google.

gtag.js

Mova todo o código que chama os comandos padrão de consentimento da gtag para o início da página, acima de todos os snippets de tag ou outros códigos que possam estar usando o consentimento.

Defina os seguintes parâmetros de consentimento:

gtag('consent', 'default', {
      'ad_storage': 'denied',
      'analytics_storage': 'denied',
      'ad_user_data': 'denied',
      'ad_personalization': 'denied',
});

Não defina os estados de consentimento padrão de forma assíncrona.

Gerenciador de tags

Se você usa um modelo de tag da CMP no Gerenciador de tags, confira a documentação dessa plataforma para saber como definir o consentimento padrão usando o modelo do Gerenciador de tags.

A tag precisa carregar os padrões de consentimento pelo menos nestes 4 parâmetros:

  • ad_storage
  • ad_user_data
  • ad_personalization
  • analytics_storage

Se você tem um banner próprio de consentimento, ou sua CMP não se integra automaticamente ao modo de consentimento, faça a implementação de forma manual.

O site precisa definir o estado de consentimento padrão antes de qualquer tag ou outro código usar ou atualizar o consentimento. Talvez você não consiga o efeito esperado se demorar para definir o padrão. Saiba mais sobre os requisitos de consentimento do Google.

Por exemplo, no cenário a seguir, a tag de anúncio já leu ou gravou um cookie antes de o consentimento padrão ser definido:

  1. O visitante abre a página.
  2. A tag de anúncio é disparada.
  3. O consentimento padrão é definido como "negado".

O Assistente de tags informa um erro: Erro do Assistente de tags

gtag.js

Mova todo o código que chama os comandos padrão de consentimento da gtag para o início da página, acima de todos os snippets de tag ou outros códigos que possam estar usando o consentimento.

Defina os seguintes parâmetros de consentimento:

gtag('consent', 'default', {
      'ad_storage': 'denied',
      'analytics_storage': 'denied',
      'ad_user_data': 'denied',
      'ad_personalization': 'denied',
});

Não defina os estados de consentimento padrão de forma assíncrona.

Gerenciador de tags

Se uma tag de modelo definiu o consentimento padrão:

  1. Edite o acionador da tag de modelo de gravação para que seja disparada na inicialização do consentimento.
  2. Para todas as outras tags: faça o disparo antes da inicialização do consentimento. Por exemplo, para acionar uma tag no carregamento de página, use o acionador Inicialização: todas as páginas.

Quando um visitante do site interage com seu banner, ele deve enviar um comando update de consentimento. Se o estado de consentimento não mudar, verifique se você implementou um mecanismo de atualização.

gtag.js

Use o comando update da gtag.js para atualizar o estado de consentimento depois que um visitante interagir com seu banner. Verifique se você tem um mecanismo de atualização para todo parâmetro em que define um consentimento padrão. Confira também se o usuário consegue atualizar o consentimento para granted e denied.

O exemplo a seguir mostra como a função consentGrantedAdStorage atualiza o estado de consentimento quando um visitante aceita os cookies do Google Ads em um banner.

<script>
function consentGrantedAdStorage() {
  gtag('consent', 'update', {
    'ad_storage': 'granted'
  });
  }
</script>
<!-- Invoke your consent function when a user interacts with your banner -->
<body>
  ...
  <button onclick="consentGrantedAdStorage()">Yes</button>
  ...
</body>

Gerenciador de tags

Se você usar uma tag de modelo de consentimento para definir o consentimento padrão, garanta que ela também atualize o estado. Consulte a documentação do provedor da sua CMP para mais informações.

É possível definir padrões de consentimento diferentes com base na região do visitante. Se você implementou padrões para regiões diferentes, siga as etapas abaixo para verificar se as configurações funcionam.

gtag.js

  1. No seu navegador, defina o local do visitante como uma região que você quer verificar. Saiba como definir locais no Chrome.
  2. Verifique se o modo de consentimento funciona.

  3. Se o modo de consentimento não se adaptar à região do usuário, verifique seu código-fonte. Exemplo:

      gtag('consent', 'default', {
    'analytics_storage': 'denied',
    'region': ['ES', 'US-AK']
  });

  gtag('consent', 'default', {
    'ad_storage': 'denied'
  });

    O exemplo define um consentimento padrão regional para um parâmetro, mas não para o outro. Quando você verifica o comportamento regional, todos os parâmetros precisam funcionar de acordo com as políticas da organização. Saiba como configurar regiões geográficas.

Gerenciador de tags

  1. No seu navegador, defina o local do visitante como uma região que você quer verificar. Saiba como definir locais no Chrome.
  2. Verifique se o modo de consentimento funciona.
  3. Se o modo de consentimento não se adaptar à região do usuário, verifique as configurações da tag de consentimento. Saiba como configurar regiões geográficas.

Próximas etapas

A tag do Google reconhece o consentimento, então ajusta o comportamento com base na escolha do usuário. Se você bloquear o carregamento da tag do Google até um usuário autorizar, suas conversões estimadas serão menos exatas, e o modelagem comportamental no Google Analytics 4 vai estar indisponível. Desbloqueie sua tag do Google para ter os melhores resultados de medição.

Saiba mais sobre o impacto do modo de consentimento.