Este artigo é destinado a pessoas que usam a tag do Google ou o Gerenciador de tags e precisam resolver problemas de configuração de inclusão de tag.
O Assistente de tags é uma ferramenta que ajuda você a resolver problemas com a configuração de inclusão de tags. Com o Assistente de tags, você pode:
- Verificar quais tags estão em um site.
- Conferir quais eventos foram disparados.
- Revisar os dados que estão sendo transmitidos para a camada de dados.
- Exportar uma sessão de depuração para compartilhar com outra pessoa, como o Suporte do Google.
- Importar sessões de depuração de outra pessoa.
- Compartilhar um URL de depuração para que outra pessoa possa depurar para você.
Quando o site contém a tag do Google, o Assistente de tags adiciona as páginas com e sem tag ao Resumo da cobertura da tag. Assim, você tem uma visão geral do status de inclusão de tag no seu site.
Neste artigo:- Instalar a extensão Tag Assistant Companion do Chrome
- Sobre o parâmetro de depuração
- Iniciar uma nova sessão de depuração
- Sobre a interface do Assistente de tags
- Exportar uma sessão de depuração
- Importar uma sessão de depuração
- Compartilhar o acesso de depuração com outra pessoa
- Sair do modo de depuração
- Verificar as ações de conversão do Google Ads com o Assistente de tags
- Resolver problemas de conexão
Instalar a extensão Tag Assistant Companion do Chrome
A extensão Tag Assistant Companion do Chrome funciona como um complemento do depurador sem extensão. Para melhores resultados de depuração, instale a extensão Tag Assistant Companion do Chrome. Quando a extensão do Chrome está instalada, os seguintes recursos são ativados:
- Detecção da tag do Google em um iframe.
- Depuração de janelas pop-up ou novas guias abertas pela janela atual.
- A janela de depuração é aberta em uma nova guia do navegador, em vez de uma janela pop-up. Isso permite que o usuário manipule a barra de URL do navegador e facilita a depuração de ações com base no referenciador.
- Várias janelas podem ser depuradas na mesma sessão. Cada janela é marcada com um símbolo na árvore de eventos para facilitar a identificação.
Sobre o parâmetro de depuração
O Assistente de tags definirá automaticamente um parâmetro "depuração" (_dbg) para hits enviados a um ID de métricas App + Web. Isso ajuda você a ver os hits exibidos em outras plataformas de depuração, como o DebugView da propriedade App + Web. Para que você possa inspecionar os hits individualmente, a propriedade App + Web não os envia em lote.
Iniciar uma nova sessão de depuração
Para iniciar uma nova sessão de depuração, faça o seguinte:
- Abra o Assistente de tags.
- Clique em Adicionar domínio.
- Insira o URL da página que você quer depurar.
- Clique em Iniciar. O Assistente de tags carrega o site para depurar em uma nova guia.
- Alguns sites podem não funcionar quando há um parâmetro de depuração adicionado ao URL. Nesse caso, desmarque a caixa Incluir o indicador de depuração no URL.
Para retomar uma sessão de depuração ativa ou encerrada, clique no nome de domínio em Domínios ativos ou Histórico na página inicial do Assistente de tags.
Depois de ativar o modo de depuração, uma nova janela será aberta para a página inserida, e a janela do Assistente de tags exibirá a IU de depuração. As informações detalhadas sobre seus comandos e eventos da gtag(), incluindo como as tags são disparadas e quais dados estão sendo processados, serão exibidas nessa janela. As informações de depuração não ficam visíveis para os visitantes comuns do site. A janela vai permanecer aberta e mostrar informações de depuração enquanto você navega no mesmo domínio, desde que haja uma tag do Google na página.
Ao clicar no site, a janela de depuração atualiza as informações sobre como suas tags são disparadas. Você pode usar esses dados para ver se uma tag foi disparada, o que acionou (ou não) o disparo e quais solicitações de rede foram feitas quando a tag foi disparada.
Sobre a interface do Assistente de tags
Quando o Assistente de tags é aberto pela primeira vez, você tem acesso à visualização padrão Resumo com uma visão geral dos eventos e informações da tag da página solicitada.Se várias tags do Google ou contêineres do Gerenciador de tags forem detectados, selecione um para ver todos os hits dessa tag ou contêiner específico.
Observação: os eventos do navegador podem ser aplicados a todos os contêineres, mas os hits são filtrados pelo contêiner selecionado.
O lado esquerdo da tela exibe uma lista de eventos. A seção Saída mostra um card para cada hit detectado do ID selecionado.
Os eventos são agrupados pela página em que ocorreram. Clique no título de uma página na barra de navegação à esquerda para ver um resumo no nível da página. Um novo grupo de páginas é adicionado à parte superior da lista quando o usuário acessa outra página que tem uma tag do Google.
Os eventos aparecem e são numerados na ordem em que foram disparados. Os eventos marcados com 
Em Chamada de API, é possível ver o JavaScript usado para configurar os dados do evento selecionado, que será uma chamada gtag() ou datalayer.push().
Em Saída, você verá para onde foram enviados os hits, as atualizações na camada de dados e outros erros.
Detalhes dos hits
A guia Hits enviados mostrará para onde um hit foi enviado e de que tipo ele é:
Ao clicar nesse hit, uma janela de detalhes é exibida. Essa visualização mostra detalhes sobre os parâmetros enviados com cada hit.
Camada de dados
A guia Camada de dados mostra valores encontrados no objeto dataLayer. Ao selecionar a opção Resumo, as informações enviadas à camada de dados e o estado atual dela são exibidos para cada evento.
Exportar uma sessão de depuração
Exportar uma sessão do Assistente de tags é útil quando você precisa de ajuda para depurar tags. O arquivo exportado armazena seu histórico de depuração, que outra pessoa pode importar para a janela do navegador do Assistente de tags dela.
Para exportar uma sessão de depuração:
- Abra o Assistente de tags.
- Navegue pelo site para preencher as informações de depuração no Assistente de tags.
- Quando estiver tudo pronto para exportar a sessão de depuração, clique no menu flutuante
Exportar sessão.
- Leia a exoneração de responsabilidade e clique em Exportar.O arquivo será salvo no seu computador. Não modifique o nome nem o conteúdo do arquivo, porque isso pode corromper o conteúdo.
- Compartilhe o arquivo com a pessoa que ajuda você a depurar a inclusão de tag, para que ela possa importar a sessão de depuração.
Exportar sessão.Importar uma sessão de depuração
Você pode importar uma sessão de depuração do Assistente de tags para saber mais sobre as etapas que alguém seguiu para testar a configuração de inclusão de tags. As sessões de depuração importadas são abertas no modo somente leitura, ou seja, não é possível continuar a depuração. Nenhum hit ou tag novo pode ser disparado em uma sessão importada. Se você precisar testar um site em nome de outra pessoa, peça para ela compartilhar o acesso de depuração.
Para importar uma sessão de depuração:
- Abra o Assistente de tags.
- No menu flutuante
, selecione Importar sessão.
- Faça upload do arquivo da sessão de depuração. A sessão importada é aberta no modo somente leitura.
Compartilhar o acesso de depuração com outra pessoa
Se precisar de ajuda para depurar a configuração da inclusão de tag, conceda a outra pessoa acesso ao Assistente de tags.
Para compartilhar o acesso de depuração:
- Abra o Assistente de tags.
- Inicie uma nova sessão de depuração.
- No menu flutuante
- Revise as configurações de depuração e clique em Copiar link.
- Compartilhe o link de depuração com a pessoa que ajuda você.
Sair do modo de depuração
Para sair do modo de depuração, faça o seguinte:
- Mude para a guia do navegador da Web que está com o modo de depuração ativo.
- Clique em Parar a depuração na janela flutuante, na página inicial ou no X no canto superior esquerdo da janela de depuração.
Verificar as ações de conversão do Google Ads com o Assistente de tags
A integração do Assistente de tags com o Google Ads inclui um modo guiado para facilitar a verificação das ações de conversão.
A página de resumo de conversões do Google Ads inclui links para resolver problemas dessas ações não verificadas. Isso inicia o Assistente de tags, e lá você pode acessar o modo de depuração, conforme descrito acima.
A sobreposição do Assistente de tags na página exibe orientações para verificar as ações de conversão. Após terminar, clique em Concluir para ver um resumo na janela do Assistente de tags especificando as ações de conversão testadas. Esses resultados aparecem na página "Resumo de conversões do Google Ads" depois de algum tempo. Saiba mais.
Como resolver problemas de conexão
Se a janela de depuração não se conectar à sua página, tente estas soluções:
- Talvez o URL que você inseriu não tenha uma tag do Google na página. Tente usar um URL diferente no seu site em que uma tag do Google está instalada.
- O parâmetro de depuração adicionado ao URL da página pode interferir no comportamento dela. Para resolver esse problema, edite o domínio inserido no modo de depuração e desmarque a caixa de seleção Incluir o indicador de depuração no URL.
- O script da tag do Google será carregado depois que o Assistente de tags tentar se conectar à página. Clique em Tentar novamente para se conectar mais uma vez.
- Sua página usa a tecnologia AMP. No momento, o Assistente de tags não é compatível com páginas AMP.
- A página carrega a tag do Google em um iframe, e as configurações dessa tag só vão poder ser depuradas quando a extensão do Chrome Tag Assistant Companion também estiver instalada.
- Um número excessivo de redirecionamentos do navegador pode impedir o carregamento da janela de depuração.
- Os bloqueadores de anúncios instalados no seu navegador da Web podem impedir a execução da tag do Google. Desative-os nas páginas que você precisa testar.
- Se a extensão Tag Assistant Companion estiver instalada, verifique se ela tem permissão para ler e mudar os dados do site nas páginas que você precisa testar.
- As ferramentas de gerenciamento de consentimento podem bloquear tags do Google. Configure-as de modo a permitir a interação com a API de consentimento do Google.