• 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. Encontre o seu ID de medição: na sua conta do Google Analytics 4, acesse Administrador → Coleta e modificação de dados → Fluxos de dados, clique no fluxo do seu site e copie o ID da métrica (Measurement ID). Ele tem o formato G-XXXXXXXXXX.

Acesse o painel analytics e crie uma para sua loja.

3. Edite o arquivo: abra o arquivo .json recebido do suporte em um editor de texto simples (como o Bloco de Notas do Windows). Pressione Ctrl+F, busque por G-XXXXXXXXXX e substitua pelo seu ID de medição, mantendo as aspas ao redor do valor. Essa troca aparece uma única vez no arquivo, dentro da variável "GA4 - ID de Medição".

4. Salve o arquivo, mantendo o nome e a extensão .json, e siga para a importação no Tag Manager.

#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) — e confira também que o evento purchase não aparece durante a navegação comum.

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 — Onde os eventos NÃO devem disparar

Tão importante quanto ver os eventos dispararem no lugar certo é confirmar que eles não disparam no lugar errado.

Ação: Com o modo Visualizar do GTM ativo, navegue pela loja sem comprar nada: abra a página inicial, uma categoria e uma página de produto. A cada página, confira no painel do Tag Assistant a lista de tags disparadas.

Teste 4 — 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.
• Se aparecerem compras que não existem nos relatórios (ou conversões de R$1 no Google Ads), veja o Teste 3 — o evento de compra pode estar disparando fora da página de confirmação.

#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.

• 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 do GA4: produtos vistos, adições ao carrinho, frete e pagamento escolhidos, compras, favoritos, logins e novas contas.
• 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:

Além do funil de compra, o container também mede o relacionamento do cliente com a loja:

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 seu ID de medição: na sua conta do Google Analytics 4, acesse Administrador → Coleta e modificação de dados → Fluxos de dados, clique no fluxo do seu site e copie o ID da métrica (Measurement ID). Ele tem o formato G-XXXXXXXXXX.

#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-XXXXXXX 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 Combinar (Merge) e, em seguida, Renomear tags, acionadores e variáveis conflitantes. Essa é a opção recomendada — ela preserva tudo o que já existe no seu container. Use Substituir (Overwrite) apenas se o container for novo e estiver completamente vazio.

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. Confira se a loja não vai medir em dobro

Se a sua loja já enviava dados ao Google Analytics por outro caminho, é preciso desativá-lo — duas fontes ativas contam cada visita e cada venda duas vezes.

No painel administrativo, acesse Lojas → Configuração → Vendas → API do Google → Google GTag → Google Analytics4. Se estiver como Sim, altere Habilitar para Não, clique em Gravar Configuração e atualize o cache em Sistema → Gerenciamento de Cache.

Depois, ainda no GTM, verifique se existem tags antigas do Google Analytics criadas manualmente no container. Se existirem, pause-as (a pausa é reversível — você pode reativá-las se precisar). Não mexa nas tags de anúncios do Google Ads (as que começam com AW-).

#4. 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 e avance escolhendo frete e pagamento.
3. No painel do Tag Assistant, confira os eventos disparando a cada ação (por exemplo, view_item ao abrir um produto) — e confira também que o evento purchase não aparece durante a navegação comum.

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 — Frete e pagamento no checkout

Ação: Com o modo Visualizar ativo, adicione um produto ao carrinho e avance no checkout: confirme a forma de entrega e, em seguida, selecione a forma de pagamento.

Teste 4 — Onde os eventos NÃO devem disparar

Tão importante quanto ver os eventos dispararem no lugar certo é confirmar que eles não disparam no lugar errado.

Ação: Com o modo Visualizar do GTM ativo, navegue pela loja sem comprar nada e sem interagir com o mini-carrinho: abra a página inicial, uma categoria e uma página de produto. A cada página, confira no painel do Tag Assistant a lista de tags disparadas.

Teste 5 — 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 atualizado em Sistema → Gerenciamento de Cache (ver a doc de Configuração do GTM).
• Se a vitrine aparece sem produtos nos relatórios, veja a observação sobre produtos por página, abaixo.
• Se o evento de frete não aparece, veja a observação sobre checkout de etapa única, abaixo.
• Se aparecerem compras que não existem nos relatórios (ou conversões de R$1 no Google Ads), veja o Teste 4 — o evento de compra pode estar disparando fora da página de confirmação.

#Observações Importantes

• Vitrine medida como vazia: a quantidade de produtos por página da sua vitrine precisa estar informada na configuração do módulo de Tag Manager (campo Maximum Products in Category). Com o valor 0, o evento de vitrine dispara com a lista de produtos vazia e os relatórios de listagem ficam em branco. Essa configuração é detalhada na doc de Configuração do Google Tag Manager (GTM).
• Carrinho contado mais de uma vez: no padrão mageshop, o evento de "viu o carrinho" também é registrado nas interações com o mini-carrinho, em qualquer página. Ver várias contagens de view_cart na mesma visita é o comportamento esperado — não é duplicação.
• Checkout de etapa única: o evento de escolha de frete (add_shipping_info) existe apenas em checkouts de duas etapas. Se a sua loja usa checkout de etapa única, esse evento não é registrado e o funil do GA4 vai direto do início do checkout para a escolha do pagamento. É um comportamento conhecido, não um defeito.
• Compra registrada no momento do pedido: o evento de compra dispara quando o pedido é realizado, antes da confirmação do pagamento. Pedidos aguardando boleto ou Pix, por exemplo, já contam como compra no GA4 — mesmo que o pagamento não se concretize depois.
• 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.
• Produtos com variação (cor, tamanho): nos relatórios por item do GA4, a jornada de um produto com variações pode aparecer dividida entre códigos diferentes — o clique na vitrine e as etapas de carrinho usam identificadores distintos do da página do produto. É um comportamento conhecido, com correção em andamento; a receita e os totais de venda não são afetados. Em caso de dúvida, fale com o suporte.
• Dados pessoais dos seus clientes: o container não envia nome, e-mail, CPF ou telefone dos clientes ao Google. Para manter essa proteção, o campo de atributos de cliente na configuração do módulo deve permanecer sem nenhuma seleção — ver a doc de Configuração do GTM.
• 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.

#Referências e Relacionados

• Configuração do Google Tag Manager (GTM): ativação do recurso no painel da loja e configurações do módulo que afetam os eventos (produtos por página, atributos, cache) — pré-requisito deste guia.
• Como atualizar o cache: as alterações de configuração só chegam ao visitante depois de atualizar o cache da loja.
• Google Tag Manager — criando a conta e o container: como criar a conta, gerar o container e obter o ID GTM-XXXX.
• Consentimento de cookies (LGPD): o envio de dados depende do consentimento do visitante.