- O Google Tag Manager (GTM) permite acompanhar como os clientes navegam e compram na sua loja, enviando esses dados para o Google Analytics 4 (GA4) e outras ferramentas configuradas no seu container.
- Com o recurso ativado, as informações de cada página (produto, categoria, carrinho, busca e pedido finalizado) são organizadas e enviadas automaticamente, sem precisar mexer no código de cada página.
- Você só precisa ligar o recurso no painel e informar o ID do container que obtém na sua conta do Google Tag Manager.
- É útil principalmente para quem cuida de marketing e vendas e quer medir conversões com precisão.
#Passo a Passo por Escrito
#1. Acesse as configurações do Google Tag Manager no painel administrativo
Faça login no painel administrativo da sua loja e acesse Sistema → Configuração (em inglês, System → Configuration). No menu lateral, desça até a seção Serviços, localize e clique em Google Tag Manager.
Resultado esperado: A tela de configuração do recurso será exibida, com todos os campos disponíveis para preenchimento.
#2. Ative o recurso
Na seção Configurações (Settings), localize o campo Ativo (Active) e selecione Sim.
Por padrão, este campo vem como Não — ou seja, o recurso vem desativado. É necessário alterá-lo para Sim para que o Google Tag Manager comece a funcionar.
Resultado esperado: O recurso fica ativado e os demais campos de configuração passam a valer.
#3. Informe o ID do container (ID Público do Container)
No campo ID Público do Container (Container Public ID), informe o identificador do seu container do Google Tag Manager. Ele tem o formato GTM-XXXXXX.
Para usar mais de um container, informe os IDs separados por vírgula. Exemplo: GTM-AAAA111, GTM-BBBB222.
Para o recurso funcionar, é necessário ter Ativo = Sim e o ID Público do Container preenchido. Se faltar qualquer um dos dois, o Google Tag Manager fica inativo, mesmo com o módulo ligado. Esse ID é gerado na sua conta do Google Tag Manager — se você ainda não tem um, será necessário criá-lo antes de continuar.
Resultado esperado: O campo aceita o ID informado, no formato GTM-XXXXXX.
#4. Salve as configurações
Clique em Salvar configuração (Save Config), no canto superior direito da tela.
Resultado esperado: Uma mensagem de confirmação informando que a configuração foi salva aparece no topo da tela.
#5. Limpe o cache da loja
Após salvar, é necessário limpar o cache para que as mudanças apareçam na loja. Acesse Sistema → Gerenciamento de Cache (System → Cache Management) e limpe os caches da loja.
As alterações do Google Tag Manager só aparecem na loja depois que o cache é limpo. Sempre que alterar qualquer configuração, repita esta etapa.
Resultado esperado: O cache é limpo e o Google Tag Manager passa a ser carregado nas páginas da loja.
#Validação e Testes
Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.
Teste 1 — Confirmar que o Google Tag Manager está carregando na loja
Ação: Abra a sua loja em uma aba anônima do navegador. Pressione F12 para abrir as ferramentas do desenvolvedor, vá até a aba Rede (Network), atualize a página e procure por uma requisição para o endereço googletagmanager.com. Se a opção Aguardar Interação do Usuário estiver ativa, role a página ou clique em algum ponto antes de procurar — nesse modo o recurso só carrega após a primeira interação.
Resultado esperado: Uma requisição para googletagmanager.com aparece na lista, indicando que o recurso foi carregado na página.
Teste 2 — Acompanhar os dados pelo modo de visualização do Google Tag Manager
Ação: Na sua conta do Google Tag Manager, clique em Visualizar (Preview), informe o endereço da sua loja e navegue pelas páginas (página inicial, um produto, o carrinho).
Resultado esperado: O painel de visualização mostra as informações sendo registradas conforme você navega — por exemplo, ao abrir um produto ou adicioná-lo ao carrinho.
Teste 3 — Testar um pedido completo
Ação: Faça um pedido de teste na loja, do carrinho até a página de confirmação de compra.
Resultado esperado: Os dados da compra são registrados no modo de visualização do Google Tag Manager ao chegar na página de sucesso do pedido.
Se não funcionar, verifique:
- Se o campo Ativo (Active) está em Sim.
- Se o ID Público do Container (Container Public ID) está preenchido.
- Se o cache da loja foi limpo após salvar.
- Se a opção Aguardar Interação do Usuário (Wait for User Interaction) está ligada — nesse caso, o recurso só carrega após a primeira interação (rolar, clicar, tocar); abrir a página e não fazer nada pode dar a impressão de que "não funciona".
Pronto! Dessa forma realizamos a configuração do Google Tag Manager em sua loja virtual Magento 1.
#Observações Importantes
- Aguardar Interação do Usuário (Wait for User Interaction): quando ativada, o Google Tag Manager só começa a carregar depois que o cliente interage com a página (rola, clica, toca, usa o teclado ou a roda do mouse). Isso deixa a página mais rápida no início, mas tem um efeito colateral: visitantes que entram e saem sem nenhuma interação não chegam a ser rastreados — algumas sessões de rejeição (bounce) podem não aparecer nos seus relatórios.
- Modo Debug: existe uma opção de depuração que exibe, em um painel fixo no rodapé da loja, todas as informações que estão sendo enviadas ao Google Tag Manager. É útil para conferir os dados durante os testes, mas esse painel fica visível para qualquer visitante e pode mostrar dados de clientes logados.
Use o Debug apenas em ambiente de teste e desligue-o antes de colocar a loja em produção. Deixá-lo ligado expõe publicamente as informações enviadas ao Google Tag Manager, incluindo dados de clientes.
- Ambientes do GTM (Habilitar Ambientes / Enable Environments): permite usar versões diferentes do container para ambientes distintos (por exemplo, homologação e produção) sem afetar o container de produção. Ao ativar, preencha os campos GTM Auth e GTM Preview com os valores obtidos na sua conta do Google Tag Manager, em Administrador → Ambientes (Admin → Environments). Use apenas se você já tiver ambientes configurados no GTM.
- Vários containers: você pode usar mais de um container ao mesmo tempo, informando os IDs separados por vírgula no campo ID Público do Container. Cada container precisa estar configurado individualmente na sua conta do Google Tag Manager.
- Marca dos produtos: o recurso usa o atributo Fabricante (manufacturer) do produto para preencher a marca enviada ao Google. Se a sua loja usa outro atributo para identificar a marca, esse campo pode ficar vazio.
- Eventos de clique e carrinho dependem do tema: o registro de ações como clicar em um produto, adicionar e remover do carrinho depende de o seu tema estar preparado para o recurso. Em temas muito personalizados, esses eventos podem não ser enviados sem um ajuste técnico.
- Recurso de terceiro: este é um módulo da Yireo, não desenvolvido pela MageShop. Atualizações e correções dependem do fornecedor original.
#Referências e Relacionados
- Eventos padrão do Google Analytics 4 (GA4): entenda quais informações de e-commerce (visualização de produto, adição ao carrinho, compra, entre outras) são enviadas e o que cada uma representa.
- Google Tag Manager — criando a conta e o container: como criar a conta, gerar o container e obter o ID
GTM-XXXX no site do Google Tag Manager, pré-requisito para esta configuração.
- Configuração de cache da loja: sempre que alterar o Google Tag Manager, é necessário limpar o cache para que as mudanças apareçam na loja.
- Atributos de produto (marca/fabricante): como configurar o atributo de marca dos produtos, usado pelo Google Tag Manager para identificar a marca enviada ao Google.
Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br
- O Google Tag Manager (GTM) permite acompanhar como os clientes navegam e compram na sua loja, enviando esses dados para o Google Analytics 4 (GA4).
- Com o recurso ativado, ações como visualizar um produto, adicionar ao carrinho e finalizar uma compra passam a ser registradas automaticamente, sem precisar mexer no código de cada página.
- Você precisa ligar o recurso no painel, informar o ID do container da sua conta do Google Tag Manager e ajustar os demais campos conforme as recomendações deste guia.
- É útil principalmente para quem cuida de marketing e vendas e quer medir conversões com precisão.
#Passo a Passo por Escrito
#1. Acesse as configurações do Google Tag Manager no painel administrativo
Faça login no painel administrativo da sua loja e acesse Lojas → Configuração (em inglês, Stores → Configuration). No menu lateral, localize a seção Yireo e clique em Yireo GoogleTagManager.
Resultado esperado: A tela de configuração do recurso será exibida, com todos os campos disponíveis para preenchimento.
#2. Confira o escopo de configuração antes de alterar qualquer campo
Todos os campos deste recurso aceitam valores diferentes por escopo — ou seja, você pode ter uma configuração geral (Configuração Padrão) e valores específicos por Website e por Visão de Loja. O valor mais específico sempre vence: se existe um valor salvo no website ou na visão de loja, ele prevalece sobre o padrão.
Antes de alterar qualquer campo, confira o seletor Escopo, no canto superior esquerdo da tela, e confirme que você está no escopo certo.
Alterar um campo apenas no escopo Configuração Padrão não tem efeito se houver um valor específico salvo no escopo do website ou da visão de loja. Se uma alteração "não funcionar", verifique os outros escopos antes de qualquer outra coisa.
Resultado esperado: Você sabe em qual escopo está trabalhando e confirma que não há valores diferentes salvos nos outros escopos.
#3. Habilite o recurso
Na seção Configurações (Settings), localize o campo Habilitar (Enabled) e selecione Sim (Yes).
Por padrão, este campo vem como Não (No) — ou seja, o recurso vem desativado. É necessário alterá-lo para Sim (Yes) para que o Google Tag Manager comece a funcionar.
Resultado esperado: O recurso fica habilitado e os demais campos de configuração passam a valer.
#4. Informe o ID do container (Container Public ID)
No campo Container Public ID (ID público do container), informe o identificador do seu container do Google Tag Manager. Ele tem o formato GTM-XXXXXX e sempre começa com GTM-.
Para usar mais de um container, informe os IDs separados por vírgula. Exemplo: GTM-AAAA111, GTM-BBBB222.
Sem um ID de container válido (começando com GTM-), o recurso não envia nenhum dado ao Google Analytics. Esse ID é gerado na sua conta do Google Tag Manager — se você ainda não tem um, será necessário criá-lo antes de continuar. Além disso, se você digitar um valor que não comece com GTM-, a loja não permitirá salvar e exibirá um aviso de ID inválido.
Resultado esperado: O campo aceita o ID informado, no formato GTM-XXXXXX.
#5. Configure os demais campos com os valores recomendados
Ajuste os demais campos da tela conforme a tabela abaixo. Os nomes dos campos aparecem em inglês na tela — mantivemos o nome exato para você localizar cada um, com a explicação do que ele faz.
| Campo |
Valor recomendado |
O que faz |
| Depurar (Debug) |
Não |
Modo de diagnóstico: gera registros técnicos e mensagens no navegador. Em produção, manter sempre Não — ative apenas quando o suporte solicitar. |
| Wait for user interaction (aguardar interação do visitante) |
Não |
Com Sim, a medição só começa depois que o visitante rola, clica ou move o mouse — eventos do carregamento inicial podem se perder e, em testes sem interação, tudo "parece quebrado". |
| Maximum Products in Category (máximo de produtos medidos por página de categoria) |
Número de produtos por página da sua vitrine (ex: 12, 24, 36) |
Nunca use 0 — veja o alerta logo abaixo. |
| Product List Value on Category Page |
Product First Category |
Define como a listagem de produtos é identificada nos relatórios. |
| Product EAV Attributes (informações adicionais de produto) |
Apenas atributos relevantes ao negócio (ex: marca) |
Cada atributo selecionado passa a acompanhar os produtos nos relatórios do Google. |
| Category EAV Attributes (informações adicionais de categoria) |
Conforme necessidade |
Mesmo funcionamento, para as categorias. |
| Customer EAV Attributes (informações adicionais de cliente) |
Nenhum selecionado |
Crítico — envolve dados pessoais dos clientes. Veja a explicação abaixo. |
| view_cart occurances (onde o evento de carrinho dispara) |
Everywhere (including minicart) |
Padrão mageshop. Veja as duas opções válidas abaixo. |
| Server-Side Tracking (rastreamento pelo servidor) |
Não |
Deixe desativado, a menos que a sua loja tenha rastreamento server-side implantado. |
| Send Quote and Purchase data in base currency (enviar valores na moeda base) |
Não |
Com Não, os valores são enviados na moeda da loja. |
| Maximum Transaction Value (valor máximo de transação) |
0 |
Desabilitado. |
Se os dois últimos campos da tabela não aparecem na sua tela, a loja está com uma versão anterior do recurso. Recomendamos a atualização — entre em contato com o nosso suporte para verificar.
Customer EAV Attributes — dados pessoais dos clientes
Se atributos como e-mail, CPF/CNPJ, telefone ou data de nascimento estiverem selecionados neste campo, esses dados ficam expostos em texto puro na página para clientes logados — qualquer script de terceiro presente na loja consegue lê-los. Além do risco em relação à LGPD, encaminhar esses dados ao Google Analytics viola a política do Google.
Deixe o campo Customer EAV Attributes sem nenhum atributo selecionado, em todos os escopos (padrão, website e visão de loja). O container oficial da mageshop não usa nenhum desses campos — nada disso é necessário para a medição funcionar.
Para conversões avançadas futuras, o recurso já gera automaticamente versões criptografadas do e-mail, telefone, nome e endereço na página de confirmação do pedido. Esses campos criptografados são intencionais e podem permanecer — eles não expõem os dados do cliente.
Se o campo "não salvar" (voltar sozinho ao valor anterior): quando um campo de múltipla seleção está completamente vazio, a tela não envia o campo ao salvar e a loja mantém o valor anterior. Contorno validado:
- No escopo Configuração Padrão, deixe um atributo inofensivo selecionado (ex:
firstname) e salve.
- Mude para o escopo Website da loja, desmarque Usar Padrão no campo e salve com o campo vazio.
- O valor vazio do website sobrepõe o padrão, e a visão de loja herda do website. Resultado efetivo na loja: nenhum atributo.
Maximum Products in Category — atenção ao valor 0
A descrição do campo sugere que 0 desativa o limite, mas na prática 0 desativa a medição dos produtos da vitrine: o evento de listagem (view_item_list) dispara com a lista de produtos vazia, e os relatórios de vitrine do GA4 ficam em branco.
Configure o campo com o número de produtos por página da sua vitrine (ex: 12, 24 ou 36). Sintoma do valor errado: as páginas de categoria aparecem nos relatórios sem nenhum produto associado.
Comportamento do view_cart — duas configurações válidas
- Everywhere (including minicart) — padrão mageshop. O evento dispara na página do carrinho e nas interações com o mini-carrinho em qualquer página. Mede todo contato do cliente com o carrinho, ao custo de múltiplas contagens por visita — isso é esperado, não é duplicação. A opção complementar view_cart only with expanded minicart em Sim restringe o disparo a quando o mini-carrinho é de fato aberto, reduzindo o ruído.
- Cart-page only — alternativa válida para um funil mais enxuto. O evento dispara apenas na página do carrinho, ficando 1:1 com a etapa "viu o carrinho" do funil clássico. Perde a visibilidade das interações com o mini-carrinho.
Ao comparar métricas entre lojas ou entre períodos, confira qual das duas configurações estava ativa — a contagem de view_cart muda de patamar entre uma e outra.
Resultado esperado: Todos os campos da tela ficam preenchidos com os valores recomendados, e o campo Customer EAV Attributes está sem nenhum atributo selecionado em todos os escopos.
#6. Confira a configuração relacionada do carrinho
Em Lojas → Configuração → Vendas → Fechar Pedido/Checkout → Carrinho de Compras, o campo Depois de Adicionar um Produto, Reenvie para o Carrinho deve ficar em Não — padrão mageshop pela experiência de compra.
O registro do evento de adição ao carrinho acontece independentemente dessa opção — ela afeta apenas a experiência de navegação do cliente.
Resultado esperado: O campo está em Não e a experiência de compra segue o padrão recomendado.
#7. Salve as configurações
Clique em Salvar configuração (Save Config), no canto superior direito da tela.
Resultado esperado: Uma mensagem de confirmação informando que a configuração foi salva aparece no topo da tela.
#8. Limpe o cache da loja
Após salvar, acesse Sistema → Gerenciamento de Cache (System → Cache Management) e atualize os caches invalidados (Configuração e Cache de Página).
A loja continua exibindo as configurações antigas até o cache ser atualizado — testar sem atualizar o cache gera falsos negativos. Sempre que alterar qualquer configuração, repita esta etapa.
Resultado esperado: O cache é atualizado e o Google Tag Manager passa a ser carregado nas páginas da loja com as novas configurações.
#Validação e Testes
Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.
Teste 1 — Confirmar que o Google Tag Manager está carregando na loja
Ação: Abra a sua loja em uma aba anônima do navegador. Pressione F12 para abrir as ferramentas do desenvolvedor e vá até a aba Rede (Network). Atualize a página e procure por uma requisição para o endereço googletagmanager.com.
Resultado esperado: Uma requisição para googletagmanager.com aparece na lista, indicando que o recurso foi carregado na página.
Teste 2 — Acompanhar as ações pelo modo de visualização do Google Tag Manager
Ação: Na sua conta do Google Tag Manager, clique em Visualizar (Preview), informe o endereço da sua loja e navegue pelas páginas (página inicial, um produto, uma categoria, o carrinho).
Resultado esperado: O painel de visualização mostra as ações sendo registradas conforme você navega — por exemplo, ao abrir um produto, ver uma listagem com produtos ou adicionar um item ao carrinho.
Teste 3 — Testar um pedido completo
Ação: Faça um pedido de teste na loja, do carrinho até a página de confirmação de compra.
Resultado esperado: O evento de compra é registrado no modo de visualização do Google Tag Manager ao chegar na página de sucesso do pedido.
Teste 4 — Verificar que dados pessoais não estão expostos
Ação: Faça login na loja com um cliente de teste e abra qualquer página. Pressione F12, vá até a aba Console e digite dataLayer para ver as informações que a página disponibiliza para medição.
Resultado esperado: Os dados visíveis se limitam a identificadores internos (código do cliente e do grupo). Não aparecem nome, e-mail, CPF ou telefone em texto puro. Em caso de dúvida, solicite a verificação ao suporte.
Se não funcionar, verifique:
- Se o campo Habilitar (Enabled) está em Sim (Yes) — no escopo correto.
- Se o Container Public ID está correto e começa com
GTM-.
- Se o cache da loja foi atualizado após salvar.
- Se o container está publicado na sua conta do Google Tag Manager (um container criado, mas não publicado, não envia dados).
- Se o campo Wait for user interaction está em Não — com Sim, é preciso interagir com a página (rolar ou clicar) para a medição começar.
- Se não há um valor diferente salvo em outro escopo (website ou visão de loja) sobrepondo a sua alteração.
Pronto! Dessa forma realizamos a configuração do Google Tag Manager em sua loja virtual Magento 2.
#Observações Importantes
- Escopos de configuração: todos os campos aceitam valores diferentes por escopo (Configuração Padrão, Website e Visão de Loja), e o valor mais específico sempre prevalece. A maioria dos problemas de "configuração que não funciona" vem de um valor esquecido em outro escopo.
- Aguardar a interação do visitante (Wait for user interaction): quando esta opção está ativada, a medição só começa depois que o cliente interage com a página. Isso melhora a velocidade de carregamento, mas eventos do carregamento inicial podem se perder — por isso a recomendação é manter em Não.
- Vários containers: você pode usar mais de um container ao mesmo tempo, informando os IDs separados por vírgula no campo Container Public ID.
- Modo de depuração (Debug): com a opção em Não, nenhum registro técnico é gerado — esse é o comportamento esperado na operação normal. Ative apenas quando o suporte solicitar, e volte para Não depois.
- Rastreamento server-side (Server-Side Tracking): o recurso oferece os campos, mas não realiza o rastreamento server-side sozinho — isso exige uma solução adicional. Se a sua loja não tem essa solução implantada, mantenha desativado.
- Dados pessoais dos clientes: mantenha o campo Customer EAV Attributes sem nenhum atributo selecionado, em todos os escopos. Os campos criptografados gerados automaticamente na confirmação do pedido são intencionais e não expõem dados.
- Contagens múltiplas de
view_cart: com a opção Everywhere (including minicart), é esperado que o evento dispare várias vezes por visita — não é duplicação nem erro.
- Registro da compra antes da confirmação do pagamento: dependendo da forma de pagamento, a compra pode ser registrada antes de o pagamento ser confirmado. Isso é intencional — avalie com o seu time de analytics em que momento confiar nesse dado.
- Apenas Google Analytics 4: este recurso envia dados somente para o GA4. A versão antiga do Google Analytics (Universal Analytics) não é suportada.
- Depende dos scripts do navegador e do consentimento de cookies: se o cliente bloquear scripts ou recusar os cookies, os dados podem não ser enviados.
- Temas personalizados: em lojas com tema muito personalizado, o registro de cliques em produtos nas listagens pode precisar de ajuste técnico para funcionar corretamente.
#Referências e Relacionados
- Eventos padrão do Google Analytics 4 (GA4): entenda quais eventos de e-commerce (visualização de produto, adição ao carrinho, compra, entre outros) são enviados automaticamente e o que cada um representa.
- Google Tag Manager — criando a conta e o container: como criar a conta, gerar o container e obter o ID
GTM-XXXX no site do Google Tag Manager, pré-requisito para esta configuração.
- Configuração de cache da loja: sempre que alterar o Google Tag Manager, é necessário atualizar o cache para que as mudanças apareçam na loja.
- Consentimento de cookies (LGPD): como o envio de dados depende do consentimento do cliente, vale entender a configuração de cookies da loja.
Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br
