• Este guia explica quais ações dos seus clientes são medidas na loja (os "eventos"), o que cada uma significa e como acompanhá-las no Google Analytics 4 (GA4).
• Você vai aprender a importar o container de exemplo da mageshop no seu Google Tag Manager (GTM) — um arquivo pronto, com toda a configuração de eventos já montada no padrão oficial do Google.
• Ao final, sua loja passa a alimentar automaticamente os relatórios de vendas do GA4: produtos vistos, adições ao carrinho, checkouts iniciados e compras.
• Feito para você executar por conta própria, apenas consultando esta documentação.

#O que é um evento?

Um evento é o registro de algo que aconteceu na sua loja: um cliente viu um produto, adicionou ao carrinho, finalizou uma compra. Cada evento carrega os dados daquele momento — qual produto, qual preço, qual quantidade — e é enviado ao Google Analytics 4, onde vira relatório.

O caminho do dado é sempre o mesmo: sua loja registra o que aconteceu → o Google Tag Manager organiza a informação → o GA4 exibe nos relatórios.

#A jornada de compra que a sua loja mede

Pense na jornada do seu cliente como uma história. Cada capítulo dela é um evento:

Com esses eventos, o GA4 mostra onde os clientes avançam e onde desistem — por exemplo, quantos veem um produto mas não adicionam ao carrinho, ou quantos começam o checkout e não concluem.

#O container de exemplo da mageshop

O container de exemplo é um arquivo (.json) com toda a configuração dos eventos acima já montada e testada. Em vez de criar cada configuração manualmente no GTM, você importa o arquivo e tudo entra pronto — só é preciso informar o identificador da sua conta do GA4.

Você vai precisar de:

1. O arquivo do container de exemplo — solicite o arquivo ao nosso time de suporte através do chat online da sua loja ou pelo e-mail web@tryideas.com.br.
2. O ID de medição do seu GA4, no formato G-XXXXXXXXXX. Para encontrá-lo: na sua conta do GA4, acesse Administrador → Coleta e modificação de dados → Fluxos de dados, clique no fluxo da sua loja e copie o "ID da métrica" (Measurement ID).

#Passo a Passo por Escrito

#1. Importe o arquivo no Google Tag Manager

Acesse tagmanager.google.com e abra o container da sua loja (o mesmo cujo ID GTM-XXXXXX está configurado no painel administrativo). Clique na aba Administrador (Admin) e, na coluna do contêiner, clique em Importar contêiner.

Preencha as três opções:

1. Selecionar arquivo do contêiner: escolha o arquivo do container de exemplo que você recebeu do suporte (formato .json).
2. Escolher espaço de trabalho: clique em Novo e dê um nome, por exemplo "Eventos GA4".
3. Escolher uma opção de importação: selecione Substituir (Overwrite) se o seu container está vazio ou se deseja usar apenas o padrão mageshop. Selecione Combinar (Merge) apenas se já possui outras configurações no container que precisa manter.

Clique em Confirmar.

#2. Informe o seu ID de medição do GA4

No menu lateral esquerdo do GTM, clique em Variáveis. Na lista, localize e clique na variável GA4 - ID de Medição. No campo Valor, apague o G-XXXXXXXXXX e cole o ID de medição real da sua propriedade GA4. Clique em Salvar.

#3. Teste e publique

Antes de publicar, teste com o modo de visualização:

1. No canto superior direito do GTM, clique em Visualizar (Preview), informe o endereço da sua loja e conecte. A loja abre em uma nova aba, acompanhada do painel Tag Assistant.
2. Navegue: abra uma categoria, clique em um produto, adicione ao carrinho, abra o carrinho, inicie o checkout.
3. No painel do Tag Assistant, confira os eventos disparando a cada ação (por exemplo, view_item ao abrir um produto).

Quando estiver tudo certo, volte ao GTM, clique em Enviar (Submit) no canto superior direito, dê um nome à versão (por exemplo, "Eventos GA4 - padrão mageshop") e clique em Publicar.

#Validação e Testes

Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.

Teste 1 — Acompanhar os eventos em tempo real no GA4

Ação: Na sua conta do GA4, acesse Administrador → Exibição de dados → DebugView. Com o modo Visualizar do GTM ativo em outra aba, navegue pela loja.

Teste 2 — Eventos de vitrine e seleção de produto

Ação: Com o modo Visualizar do GTM ativo, abra uma página de categoria da loja e, em seguida, clique em um dos produtos da listagem. Acompanhe o painel do Tag Assistant.

Teste 3 — Pedido de teste completo

Ação: Faça um pedido de teste do início ao fim, do produto até a página de confirmação de compra.

Se não funcionar, verifique:

• Se a versão foi publicada no GTM (rascunho não vai ao ar).
• Se a variável GA4 - ID de Medição contém o seu ID real.
• Se o módulo do GTM está ativo na loja e o cache foi limpo (ver a doc de Configuração do GTM).
• No caso do add_to_cart e remove_from_cart, veja a observação sobre o comportamento do carrinho, abaixo.

#Observações Importantes

• Adicionar ao carrinho e o modo do carrinho: para o evento add_to_cart funcionar, a loja deve estar configurada para abrir o carrinho após adicionar o produto (e não redirecionar direto para a página do carrinho). Essa opção fica em Sistema → Configuração → Fechar Pedido → Carrinho de Compras → "Após Adicionar Produto Redirecionar p/ Carrinho" = Não. Com o redirecionamento ligado, a adição ao carrinho não é registrada.
• Marca dos produtos: a marca enviada ao Google vem do atributo de marca configurado nos seus produtos. Produtos sem a marca preenchida no cadastro aparecem sem marca nos relatórios — vale manter esse campo em dia.
• Produtos com variação (cor, tamanho): a variação comprada aparece no GA4 como um detalhe do produto principal (campo "variante do item"), e não como um produto separado. Isso é o comportamento correto: a jornada inteira (ver → adicionar → comprar) fica ligada ao mesmo produto.
• Compra contada uma única vez: o GA4 identifica cada compra pelo número do pedido. Se o cliente recarregar a página de confirmação, a compra não é contada duas vezes.
• Não duplique a medição: se a sua loja já enviava dados ao Google Analytics por outro meio (outro módulo ou integração direta de GA4), desative-o ao usar este container — os dois juntos contam cada visita e cada venda em dobro.
• Dependência do navegador e consentimento: a medição acontece no navegador do cliente. Visitantes que bloqueiam scripts ou recusam cookies podem não ser medidos — isso é esperado e vale para qualquer ferramenta de analytics.
• Versões e reversão: cada publicação no GTM vira uma versão numerada. Se algo sair errado, é possível voltar à versão anterior com um clique, em Versões.
• Requisito de versão da loja: os eventos de interação (select_item, add_to_cart, remove_from_cart) dependem da versão atualizada do recurso de Tag Manager nas lojas mageshop. Se esses três eventos não dispararem mesmo com tudo configurado, entre em contato com o suporte para verificar a atualização.

#Referências e Relacionados

• Configuração do Google Tag Manager (GTM): ativação do recurso no painel da loja (módulo, ID do container, cache) — pré-requisito deste guia.
• Google Tag Manager — criando a conta e o container: como criar a conta, gerar o container e obter o ID GTM-XXXX.
• Atributos de produto (marca/fabricante): como preencher a marca dos produtos, usada nos relatórios do Google.
• Consentimento de cookies (LGPD): o envio de dados depende do consentimento do visitante.