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, ticket médio, receita por sessão, funil de conversão e distribuição por dispositivo.
Enquanto o Tag Manager não está instalado no site, a tela Analytics mostra um aviso de instalação pendente e todas 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.
Pré requisitos
Acesso ao código HTML do site, geralmente com o time técnico ou desenvolvedor da loja, já que a instalação envolve inserir dois trechos de código antes do fechamento da tag head.
Onde acessar
No painel da Martz, vá em Configurações e depois Tag Manager, ou acesse direto pelo link:
Passo 1: Escolha o modo de integração
A tela oferece dois caminhos:
Compatível com GA4/GTM: indicado para lojas que já usam o Google Tag Manager com eventos de ecommerce 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 2: Insira os códigos no modo GA4/GTM
Se a loja ainda não tem o Google Tag Manager instalado, cole primeiro o trecho padrão do GTM, disponível na própria tela, com o ID do container no formato GTM-XXXXXXX.
Depois, cole o trecho do Martz DataLayer, variante GTM. O endereço usado nesse segundo trecho é do domínio mtm.martzapis.com.br, caminho datalayer/v1, seguido do ID da loja com o sufixo gtm.js. Ambos os trechos ficam disponíveis prontos para copiar direto na tela de configuração, e 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 3: Ou, se optar pela API, implemente os eventos manualmente
Após inserir o código do Martz DataLayer, os métodos ficam disponíveis em window.mzDataLayer. Segue a lista de métodos e quando cada um deve ser chamado:
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 |
setUserId e setUserEmail | Identifica o usuário logado |
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.
Verifique se funcionou
Depois de inserir o código, 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: 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.
Loja não usa Google Tag Manager e não tem desenvolvedor disponível: nesse caso, 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.