Como instalar um mapa de calor com o Google Tag Manager (sem editar código, em 5 minutos)

Resumo rápido

Com o GTM, você instala um mapa de calor sem tocar no código do seu site

Cinco passos: criar uma tag HTML personalizada → anexar um gatilho All Pages → publicar

Sucesso significa que os números se movem no seu painel do HeatMapX — não apenas "sem erros"

Se o seu site já gerencia tags pelo Google Tag Manager (GTM), essa é a forma mais limpa de adicionar o rastreamento de mapa de calor: tudo acontece na interface do GTM, sem nenhuma alteração de código. Este guia mostra o passo a passo.

Antes de começar: pegue sua chave de site

Cadastre-se no HeatMapX (há um plano gratuito, sem necessidade de cartão de crédito), registre seu site e você receberá uma chave de site.

Depois de tê-la, você vai usar uma tag neste formato — substitua YOUR-SITE-KEY pela sua chave real:

<script src="https://heatmapx.com/tracker.js?key=YOUR-SITE-KEY" data-site-key="YOUR-SITE-KEY"></script>

Importante: cole a tag inteira, não apenas a URL. O atributo data-site-key="..." informa ao HeatMapX a qual site os dados pertencem — se você omiti-lo, ou colar apenas a URL do src, nada será rastreado.

A configuração no GTM (5 passos)

Abra o console do GTM (tagmanager.google.com) e selecione o contêiner (workspace) do seu site
No menu à esquerda, vá em "Tags" → "Nova" e escolha "HTML personalizado" como tipo de tag
Cole a tag inteira acima no campo de HTML
Em "Acionamento", escolha "All Pages (Visualização de página)", dê um nome reconhecível à tag (por exemplo, HeatMapX) e salve
Clique em "Enviar / Publicar" no canto superior direito para colocar a alteração no ar

Pronto — o rastreamento agora roda em todas as páginas do seu site.

Quer conferir antes de publicar? (Modo de visualização)

Clique em "Visualizar" no GTM para testar a tag no seu próprio navegador antes de publicar. Abra seu site pela tela de visualização (Tag Assistant) — se a sua tag do HeatMapX aparecer em "Fired", está funcionando.

Se a tag não disparar — checklist

Você clicou em Publicar? Apenas salvar não coloca as alterações no ar. Essa é a causa mais comum
O gatilho é All Pages? Um gatilho específico de página faz com que outras páginas não sejam rastreadas
Um banner de consentimento de cookies (modo de consentimento) está bloqueando? Com algumas ferramentas de gestão de consentimento, tags HTML personalizadas ficam retidas até o visitante consentir. Verifique as configurações de consentimento da tag e como sua CMP a categoriza
A data-site-key está correta? Colar a chave de outro site envia seus dados para o site errado

Deixe o Claude Code te guiar

Se preferir não vasculhar a interface do GTM, você pode pedir a um agente de IA como o Claude Code para te guiar. Copie o prompt abaixo, substitua pela sua própria chave de site e cole.

I want to deploy the HeatMapX heatmap tracking tag via Google Tag Manager.
Walk me through the GTM interface one step at a time, waiting for my reply at each step.

The tag to use (Custom HTML, All Pages trigger):
<script src="https://heatmapx.com/tracker.js?key=YOUR-SITE-KEY" data-site-key="YOUR-SITE-KEY"></script>

Se você não usa o GTM e quer colocar a tag diretamente no código do seu site, esta versão permite que o Claude Code faça as edições de arquivo para você:

Install the HeatMapX heatmap tracking tag in this project.
Make sure the following tag is included right before </head> on every page, and tell me which files you changed.

<script src="https://heatmapx.com/tracker.js?key=YOUR-SITE-KEY" data-site-key="YOUR-SITE-KEY"></script>

O HeatMapX foi construído para que buscar e analisar seus dados também funcione pelo Claude Code (integração via CLI) — veja a página "CLI & Skills" no seu painel assim que estiver configurado.

Verifique se está funcionando: os números devem se mover

Depois de instalar, navegue por algumas páginas do seu site e abra o painel do HeatMapX. Se "Sessions today" estiver subindo para o seu site, o rastreamento está ativo.

O sinal de sucesso não é "sem erros" — é os números se movendo no painel. Se nada se mover, siga a checklist acima em ordem.