Visão geral
O Martz Tag Manager é a solução própria da Martz para capturar e centralizar os eventos de navegação e compra do seu site: visualização de página, visualização de produto, adicionar ao carrinho, início de checkout, compra e busca. É esse rastreamento que alimenta a tela Analytics, com métricas como sessões, taxa de conversão, receita, funil de conversão e distribuição por dispositivo.
Enquanto o Tag Manager não está instalado no site, a tela Analytics mostra o aviso O Martz Tag Manager não está instalado e as métricas aparecem zeradas, mesmo que a loja esteja recebendo visitas e vendas normalmente. Isso é esperado: o painel só exibe dados a partir do momento em que o rastreamento começa a captar eventos.
Onde acessar
No painel da Martz, vá em Configurações › Tag Manager, ou acesse direto pelo link:
A tela tem dois caminhos de instalação: a instalação automática, pela integração da sua loja, e a instalação manual, colando o código no HTML do site.
Opção 1 — Instalação automática (sem colar código)
Se a sua loja está integrada à Martz por uma plataforma que permite a instalação automática, o Tag Manager pode ser instalado com um clique. Hoje isso funciona para Loja Integrada, Shopify, Tray, WBuy, CartPanda e Nuvemshop.
Passo 01 — Escolha a plataforma
Na seção Instalação, cada integração de e-commerce ativa aparece em uma linha. As plataformas que aceitam a instalação automática mostram Pronto para instalar; as demais indicam que é preciso usar o código. Clique em instalar na linha da sua plataforma.
Passo 02 — Escolha o modo e confirme
Na janela Instalar em …, escolha o modo de integração e clique em instalar:
Compatível com GA4/GTM: captura automática para quem já dispara eventos GA4 de e-commerce por um container do Google Tag Manager.
Martz Data Layer (API): instala direto na vitrine, sem container, e dá controle total sobre os dados enviados.
Depois de instalado, a linha da plataforma passa a mostrar Instalado pela Martz. Para remover, use o botão de desinstalar na mesma linha.
Nuvemshop: além de instalar o Tag Manager aqui, é preciso ter o script da Martz instalado na loja. Veja Nuvemshop: instalar o script da Martz na loja em um clique.
Atenção: se a sua loja já está enviando eventos sem nenhuma instalação registrada pela Martz (normalmente porque o código foi colado à mão no tema), a instalação automática fica bloqueada. Instalar de novo faria cada evento ser contado em dobro. Remova o código colado à mão ou mantenha só a instalação manual.
Opção 2 — Instalação manual (colando o código)
Use este caminho quando a sua plataforma não permite a instalação automática. É preciso ter acesso ao código HTML do site, geralmente com o time técnico ou o desenvolvedor da loja, e inserir os trechos antes do fechamento da tag head. Os trechos ficam prontos para copiar na própria tela, já com o código da sua loja.
Passo 01 — Escolha o modo de integração
A tela oferece duas abas:
Compatível com GA4/GTM: indicado para lojas que já usam o Google Tag Manager com eventos de e-commerce do GA4. A captura é automática, sem precisar codar evento por evento.
Martz Data Layer (API): dá controle total sobre os dados enviados, através do objeto window.mzDataLayer. Exige que um desenvolvedor chame funções específicas a cada ação do site, como visualizar produto, adicionar ao carrinho ou finalizar compra. Indicado quando a loja não usa Google Tag Manager ou quando é preciso enviar dados customizados.
Passo 02 — Modo GA4/GTM: insira os dois trechos
Se a loja ainda não tem o Google Tag Manager instalado, cole primeiro o trecho Passo 1: Google Tag Manager (se ainda não tiver), trocando GTM-XXXXXXX pelo ID do seu container.
Depois, cole o trecho Passo 2: Script do Martz DataLayer. Os dois devem ser inseridos antes do fechamento da tag head do site.
Atenção: a ordem importa, o trecho do Google Tag Manager precisa carregar antes do trecho do Martz DataLayer.
Passo 03 — Modo Martz Data Layer (API): insira os dois trechos e implemente os eventos
Neste modo também são dois trechos, ambos antes do fechamento da tag head: Passo 1: Script async e Passo 2: Stub (inline, antes de qualquer evento). O stub permite chamar os métodos antes de o script terminar de carregar: as chamadas ficam em fila e são executadas assim que ele inicializa.
Com os trechos instalados, os métodos ficam disponíveis em window.mzDataLayer:
Método | Quando chamar |
pageview | Capturado automaticamente no carregamento da página |
viewItem | Cliente visualiza um produto |
addToCart | Cliente adiciona um produto ao carrinho |
removeFromCart | Cliente remove um produto do carrinho |
beginCheckout | Cliente inicia o checkout |
purchase | Compra finalizada |
search | Cliente faz uma busca no site |
customEvent | Envia um evento personalizado da sua loja |
setUserId e setUserEmail | Identifica o usuário logado |
clearUser | Limpa a identificação do usuário (por exemplo, ao sair da conta) |
optOut e optIn | Respeita o consentimento do visitante, desligando ou religando a coleta |
Dica: a identidade do usuário também pode ser capturada automaticamente. Qualquer envio para o dataLayer que contenha os campos user_id e ou email já é reconhecido pelo Tag Manager, sem precisar chamar setUserId ou setUserEmail manualmente.
Passo 04 — Declare a instalação manual
Depois de colar o código, clique em Já instalei o Martz Tag Manager na seção Instalação (o mesmo botão aparece como já instalei no aviso da tela Analytics). Isso remove o aviso de instalação pendente do Analytics. Se precisar desfazer, clique em Ainda não instalei.
Verifique se funcionou
Depois de instalar, acesse a tela Analytics no painel e confira se o aviso de instalação pendente sumiu e se as métricas de sessões começam a aparecer. Pode levar alguns minutos para os primeiros dados chegarem.
Problemas comuns
Métricas continuam zeradas depois de instalar: na instalação manual, confira se o código foi colado antes do fechamento da tag head e, no modo GA4/GTM, se o trecho do Google Tag Manager está carregando antes do trecho do Martz DataLayer.
A instalação automática está bloqueada: a loja já envia eventos por um código colado à mão. Mantenha só um dos dois caminhos para não contar os eventos em dobro.
Loja não usa Google Tag Manager, a plataforma não tem instalação automática e não há desenvolvedor disponível: o time de suporte pode orientar a instalação, mas a implementação em si depende de alguém com acesso ao código do site.
Artigos relacionados
Como rastrear as vendas da Martz no seu analytics (UTMs). Como funcionam os indicadores da Martz CRM.