⏱️ Tempo estimado: 20 minutos
Nível: ⭐⭐⭐☆☆ (Intermediário)
Antes de começar, você precisa:
Ter uma conta ativa na Loja Integrada
Ter um container do Google Tag Manager criado e o ID dele em mãos (formato GTM-XXXXXXX)
Ter acesso de edição ao container no painel do GTM, caso vá configurar tags e gatilhos
A Loja Integrada tem um aplicativo nativo do Google Tag Manager. Com ele, a própria plataforma envia para o seu container os dados de cada página e de cada ação do visitante: produtos vistos, itens no carrinho, cupom aplicado, frete e pagamento escolhidos, compra concluída. Tudo chega pronto no dataLayer, sem código extra na loja.
No checkout, o aplicativo carrega o GTM em um ambiente isolado. Isso protege os dados de pagamento dos seus clientes e mantém o envio de todos os eventos dessa etapa, para você enxergar com precisão em que ponto o cliente desiste da compra.
O GTM é diferente dos aplicativos de Google Analytics 4, Pixel da Meta e Google Ads, que funcionam de forma automática assim que são instalados. No GTM, a plataforma entrega os dados, e as tags e os gatilhos são montados por você (ou pela sua agência) dentro do painel do Google Tag Manager.
O que muda no checkout a partir de 01/10/2026
A partir de 01/10/2026, o Google Tag Manager passa a carregar isolado no checkout em todas as lojas. O impacto depende de como o GTM está instalado na sua loja.
Se você usa o aplicativo
Os eventos da plataforma continuam sendo enviados normalmente, inclusive no checkout. O que muda é a forma como o GTM enxerga essa etapa: no checkout, ele deixa de ter acesso aos elementos da página, como botões, campos e formulários.
⚠️ Atenção: se algum acionador do seu container depende de clique, visibilidade de elemento, envio de formulário ou de informações lidas direto do HTML, ele para de disparar no checkout. Antes de 01/10/2026, revise seus acionadores seguindo o passo a passo em Como revisar seus acionadores do checkout, mais abaixo.
Se você colou o script do GTM manualmente na loja
A Loja Integrada vai remover o código.
💡 Dica: para continuar recebendo os eventos do checkout, como escolha de frete, de pagamento e compra concluída, instale o aplicativo do Google Tag Manager.
Instalando o aplicativo
01 - Acesse o painel da sua loja e vá em Soluções > Aplicativos.
02 - Localize o aplicativo Google Tag Manager e clique em Instalar.
03 - Informe o ID do seu container.
04 - Clique em Salvar.
A partir daí a plataforma carrega o container e envia os dados para o dataLayer automaticamente.
⚠️ Atenção: se você também tem o script do GTM colado manualmente na loja, remova esse código depois de instalar o aplicativo. Com os dois ativos, o container carrega duas vezes nas mesmas páginas e suas conversões são contadas em dobro.
Eventos que sua loja envia
Cada ação do visitante gera um envio para o dataLayer com o campo event preenchido. São esses nomes que você usa para configurar os gatilhos no GTM.
Evento | Quando dispara |
| Visita à home |
| Visita a uma listagem |
| Visita à página de produto |
| Clique em um produto da vitrine |
| Busca realizada |
| Filtro ou ordenação aplicados |
| Seleção de variação do produto |
| Visualização do carrinho |
| Ações dentro do carrinho |
| Cupom aplicado |
| Início do checkout |
| Escolha de frete e de pagamento |
| Login do cliente |
| Compra concluída |
Os eventos de carrinho e de compra trazem um objeto ecommerce no padrão do Google Analytics 4, com os itens, o valor e o identificador do pedido. Suas tags de conversão leem essas informações direto do dataLayer, sem código extra na loja.
💡 Dica: cada evento também traz um campo eventID. Use esse valor nas tags que oferecem deduplicação, para que a mesma venda não seja contada duas vezes quando houver envio por navegador e por servidor.
Configurando seus gatilhos
Para disparar uma tag a partir de uma ação do visitante, crie no GTM um gatilho do tipo Evento personalizado e informe exatamente um dos nomes da tabela de eventos.
01 - No painel do GTM, acesse Acionadores e clique em Novo.
02 - Em Configuração do acionador, selecione Evento personalizado.
03 - No campo Nome do evento, digite o nome do evento, como add_to_cart ou purchase.
04 - Salve e associe o gatilho às tags que devem disparar nesse momento.
🔑 Os nomes diferenciam maiúsculas de minúsculas. Um gatilho configurado como Purchase não dispara com o evento purchase.
Gatilhos no checkout
No checkout, o GTM carrega em um ambiente isolado. Os gatilhos do tipo Evento personalizado continuam funcionando normalmente, porque dependem dos eventos que a plataforma envia. Já os gatilhos que dependem de elementos da página deixam de disparar nessa etapa.
Para as etapas principais, existe um evento equivalente:
Se hoje você rastreia... | Use o evento |
Clique em "Finalizar compra" |
|
Escolha da forma de envio |
|
Escolha da forma de pagamento |
|
Login do cliente |
|
Página de pedido concluído |
|
❗ Importante: ações mais específicas do checkout, como cliques em campos, preenchimento de endereço ou interações com elementos que você mesmo configurou, não têm um evento equivalente. Esses acionadores deixam de funcionar no checkout e não há como substituí-los.
Como revisar seus acionadores do checkout
01 - No painel do GTM, acesse Acionadores.
02 - Abra cada acionador que é usado em tags do checkout e confira o campo Tipo de acionador.
03 - Separe os que são do tipo Evento personalizado. Confira se o nome do evento está escrito exatamente como na tabela de eventos deste artigo. Se estiver, ele continua funcionando.
04 - Os acionadores dos tipos Clique - Todos os elementos, Clique - Somente links, Visibilidade do elemento, Envio de formulário e Profundidade de rolagem param de disparar no checkout. Troque pelo evento equivalente, quando existir.
05 - Acesse Variáveis e procure as do tipo Elemento DOM, Variável JavaScript ou JavaScript personalizado que leem dados da página do checkout. Elas passam a chegar vazias nessa etapa.
06 - Acesse Tags e revise as do tipo HTML personalizado que alteram ou leem elementos do checkout. Elas deixam de ter efeito nessa etapa.
07 - Depois dos ajustes, teste no modo de visualização, seguindo a seção Testando antes de publicar.
💡 Dica: se o seu container foi montado por uma agência, envie este artigo para ela fazer a revisão. Cada container tem configurações próprias, e só quem montou sabe quais acionadores dependem da página.
Se você usava nomes de evento próprios
Se o seu container foi montado com eventos criados por você ou pela sua agência, compare sua lista com a tabela de eventos. Gatilhos que esperam um nome que a plataforma não envia não vão disparar.
Por exemplo, um gatilho configurado para change_payment_info não dispara, porque o evento enviado pela plataforma na escolha do pagamento é add_payment_info. Nesse caso, basta alterar o nome do evento no acionador.
Dados de página disponíveis
No carregamento de cada página, a plataforma também envia informações sobre a página atual. Para usá-las nas suas tags, crie no GTM variáveis do tipo Variável da camada de dados com exatamente estes nomes.
Em qualquer página
Campo | Descrição |
| Título da página |
| URL completa |
| Identificador anônimo do visitante |
|
|
| Grupo do cliente |
|
|
|
|
Nas listagens (categoria, busca e marca)
Campo | Descrição |
| ID da categoria |
| SKUs dos produtos exibidos na vitrine |
Na página de produto
Campo | Descrição |
| SKU do produto |
| Nome do produto |
| Preço cheio e preço de venda |
| Marca |
| Categoria principal |
| SKUs das variações do produto |
🔑 Os nomes diferenciam maiúsculas de minúsculas. Para o GTM, PageType e pagetype são variáveis diferentes.
Evitando conversões duplicadas
Google Analytics 4, Pixel da Meta e Google Ads têm aplicativos próprios na plataforma. Se você usa esses aplicativos, confira se o seu container não envia as mesmas conversões.
❗ Importante: enviar a mesma conversão pelo aplicativo e pelo GTM infla seus relatórios e prejudica a otimização das campanhas. Escolha um caminho para cada ferramenta.
Cuidados com o identificador do visitante
O userSessionId é um identificador anônimo gerado por navegador e guardado no cookie li_user_session_identifier. Ele não é o ID do cliente na plataforma nem o e-mail dele.
🚫 Não use o userSessionId nos campos de correspondência avançada de e-mail ou telefone da Meta e do Google. Ele não corresponde a uma conta real e reduz a qualidade das correspondências. Se quiser aproveitá-lo, use como user_id ou client_id para montar audiências e unir a navegação de uma mesma sessão.
Testando antes de publicar
01 - No painel do GTM, clique em Visualizar e informe o endereço da sua loja.
02 - Navegue pela home, por uma categoria e por uma página de produto, conferindo se as variáveis chegam preenchidas.
03 - Adicione um produto ao carrinho e confira se o evento add_to_cart aparece com o objeto ecommerce.
04 - Avance no checkout e confirme se os eventos add_shipping_info e add_payment_info aparecem ao escolher frete e pagamento.
05 - Finalize um pedido de teste e confirme o evento purchase com o valor e o identificador da transação.
06 - Volte ao GTM e clique em Enviar para publicar a versão.
Dúvidas Frequentes
Já uso o aplicativo do GTM. Preciso fazer alguma coisa?
Depende de como seus acionadores foram montados. Se todos são do tipo Evento personalizado com os nomes da tabela deste artigo, não. Se algum depende de clique, visibilidade de elemento, envio de formulário ou de dados lidos da página, ele para de funcionar no checkout a partir de 01/10/2026 e precisa ser revisto.
O que para de funcionar no checkout?
Apenas configurações do GTM que alteram elementos da página, como textos, campos ou botões, ou que capturam informações direto do HTML. Os eventos enviados pela plataforma não mudam.
Meus gatilhos atuais continuam funcionando?
Fora do checkout, sim. No checkout, apenas os do tipo Evento personalizado que usam os nomes da tabela deste artigo. Gatilhos baseados em elementos da página deixam de disparar nessa etapa a partir de 01/10/2026.
O evento que eu uso não está na tabela. O que faço?
Veja se alguma das ações da tabela cobre o que você rastreia e troque o gatilho pelo evento correspondente. Se não houver equivalente, esse rastreamento deixa de funcionar no checkout. A plataforma envia os eventos principais da jornada de compra, e ações muito específicas de cada container não são cobertas.
Como sei se meu GTM vai parar de rastrear algo no checkout?
Siga o passo a passo em Como revisar seus acionadores do checkout. Depois, faça um pedido de teste no modo de visualização e confira se todas as tags que você espera aparecem disparadas.
Colei o script do GTM na loja. Ele vai parar de funcionar?
Só no checkout. A partir de 01/10, o código passa a carregar em todas as páginas exceto o checkout. Para rastrear o checkout, instale o aplicativo.
Tenho o aplicativo e o script ao mesmo tempo. O que faço?
Remova o script manual. Nas páginas fora do checkout, os dois carregariam o container duas vezes e duplicariam suas conversões.
Instalar o GTM substitui os aplicativos do GA4, do Pixel da Meta e do Google Ads?
Não. Esses três funcionam de forma automática pelos aplicativos deles. O GTM é uma camada à parte, que você programa. Para cada ferramenta, use um caminho só.
Preciso mexer no código da loja para o GTM funcionar?
Não. A instalação do aplicativo é suficiente: a plataforma carrega o container e envia os dados para o dataLayer automaticamente.
Posso enviar o e-mail do cliente pelo GTM para melhorar a correspondência das campanhas?
O campo disponível no dataLayer é o userSessionId, que é anônimo e não corresponde a nenhum dado pessoal. Ele não deve ser usado nos campos de correspondência avançada.
Não vejo os dados no modo de visualização do GTM. O que verificar?
Confira se o aplicativo está instalado com o ID de container correto, se não há um script manual do GTM carregando junto e se os nomes das variáveis e eventos estão escritos exatamente como nas tabelas, respeitando maiúsculas e minúsculas.
Resumo dos passos principais
Se você usa o aplicativo do GTM, os eventos continuam sendo enviados no checkout, mas revise os acionadores que dependem de elementos da página até 01/10/2026
Se usa o script manual, instale o aplicativo em Soluções > Aplicativos para manter o rastreamento do checkout
Remova o script manual depois de instalar o aplicativo
Configure seus gatilhos como Evento personalizado usando os nomes de evento da plataforma
Revise gatilhos e configurações do GTM que dependem de elementos do checkout e use os eventos da plataforma no lugar
Confira se nenhuma conversão está duplicada com os aplicativos de GA4, Meta e Google Ads
Teste no modo de visualização e publique a versão
Pronto! Seu GTM segue recebendo os dados de toda a jornada de compra, com o checkout protegido.
#google-tag-manager #gtm #rastreamento #datalayer #checkout #gatilhos #conversoes #integracoes