Como Instalar um Heatmap no seu Site WordPress (Uma Linha de Código, 3 Minutos)

Resumo do artigo

Adicionar um heatmap ao WordPress exige apenas colar uma única linha de código

Existem três formas de fazer isso: (1) o campo de configurações do cabeçalho do seu tema, (2) um plugin de inserção de código, ou (3) editar o header.php diretamente

Sucesso significa que a contagem realmente aumenta para o seu site no painel do HeatMapX — não apenas "sem erros"

Está preocupado que adicionar um heatmap signifique lidar com código complicado? No WordPress, é realmente apenas uma linha de código de tag. Este guia mostra três formas de adicioná-la, da opção mais fácil para principiantes até uma abordagem mais avançada.

Passo 1: Obtenha sua Site Key

Primeiro, cadastre-se no HeatMapX (há um plano gratuito disponível), registre seu site e obtenha sua site key. Não é necessário cartão de crédito.

Depois de ter sua site key, use a tag abaixo, substituindo YOUR_SITE_KEY pela chave real que você recebeu.

<script src="https://heatmapx.com/tracker.js" data-site-key="YOUR_SITE_KEY"></script>

Cole essa tag no <head> do seu site usando um dos três métodos abaixo.

Método 1 (Recomendado para Principiantes): Configurações de Cabeçalho do seu Tema

Muitos temas populares, como Astra ou GeneratePress, incluem um campo de configuração — geralmente em "Avançado" ou "Scripts Personalizados" — onde você pode inserir código diretamente na seção <head>.

No painel do WordPress, abra o customizador ou o painel de configurações do seu tema ativo
Procure um campo chamado algo como "Scripts do Cabeçalho," "Código Personalizado," ou "Avançado"
Cole a tag acima nesse campo e salve

Como você não precisa tocar em nenhum arquivo do tema, essa é a opção mais segura se você está fazendo isso pela primeira vez.

Método 2: Um Plugin de Inserção de Código

Se o seu tema não tiver um campo de cabeçalho, você pode usar um plugin como o WPCode (antigo Insert Headers and Footers).

Na tela de Plugins, procure e instale um plugin de inserção de código como o WPCode, depois ative-o
Abra as configurações do plugin e localize o campo "Header" (Cabeçalho)
Cole a tag acima e salve

A vantagem dessa abordagem é que a tag permanece mesmo após uma mudança de tema. Isso é uma boa opção se você planeja redesenhar seu site no futuro.

Método 3 (Avançado): Editar o header.php em um Tema Filho

Se você se sente confortável editando código diretamente, pode adicionar a tag direto nos arquivos do tema.

Configure primeiro um tema filho (child theme) para o seu tema ativo (editar o tema pai diretamente significa que sua alteração será apagada na próxima atualização do tema — um tema filho é necessário)
Abra o header.php no tema filho e cole a tag logo antes de wp_head(), ou logo antes da tag de fechamento </head>
Salve o arquivo

Se você editar o tema pai diretamente, a próxima atualização do tema vai sobrescrever sua alteração e a tag vai desaparecer. Se escolher esse método, sempre faça a edição através de um tema filho.

Como Confirmar que Está Realmente Funcionando

Depois de adicionar a tag, navegue por algumas páginas do seu próprio site. Mas aqui está a parte importante.

Uma página carregar sem erros não é a mesma coisa que o rastreamento estar realmente funcionando. Mesmo que o console do seu navegador não mostre nada de errado, uma site key digitada incorretamente pode significar que nenhum dado está chegando ao HeatMapX.

A única verificação confiável é abrir o painel do HeatMapX, encontrar seu site na lista de sites e confirmar que a contagem dele realmente aumentou. Depois de visitar algumas páginas, se a contagem aumentar, sua instalação está funcionando.

Perguntas Frequentes

P. Isso vai deixar meu site mais lento? R. A tag carrega de forma assíncrona e é leve, então o impacto na velocidade de carregamento da página é mínimo.

P. Estou usando um plugin de cache — há algo com que devo me preocupar? R. Se você usa um plugin de cache como WP Super Cache ou W3 Total Cache, certifique-se de limpar (purgar) o cache depois de adicionar a tag. Se uma versão antiga em cache continuar sendo servida, a tag recém-adicionada não vai entrar em vigor.

P. Adicionei a tag, mas a contagem no painel não está aumentando R. A causa mais comum é uma site key incompatível — colar a chave de um site diferente, ou um caractere ter sido perdido ao copiar. Verifique novamente a chave em comparação com a que aparece no seu painel do HeatMapX.

Encerrando

Adicionar um heatmap ao WordPress se resume a colar uma linha de código. O HeatMapX é gratuito para começar, então experimente e veja como os visitantes realmente estão vivenciando o seu site.