Tags personalizadas — Filtre mapas de calor pelas suas próprias variantes de teste A/B

HeatMapX Engineering Team4 min read
  • tags
  • heatmap
  • ab-testing
  • mcp

O HeatMapX agora oferece suporte a tags personalizadas. Adicione uma linha à sua página e cada clique, rolagem e movimento do mouse desse visitante carrega a tag, permitindo filtrar o mapa de calor no painel por tag.

Isso surgiu de um pedido de cliente: "Nosso teste A/B já roda no nosso próprio código. Só queremos ver o mapa de calor por variante." Não se limita a testes A/B. Logado ou não, em qual plano o usuário está, de qual campanha ele veio — qualquer coisa que o seu site já saiba sobre o visitante pode virar um segmento.

Como usar

Adicione o código abaixo a qualquer página que tenha a tag de rastreamento. Funciona antes ou depois da tag de rastreamento (chamadas feitas antes ficam em fila e são aplicadas assim que a tag carrega).

<script>
  window.hmx = window.hmx || function(){ (window.hmx.q = window.hmx.q || []).push(arguments) };
  hmx('set', 'ab_variant', 'B');
</script>

Se o seu servidor gera o HTML, você também pode passar as tags de uma vez só, antes da tag de rastreamento.

<script>window.heatmapxTags = { ab_variant: 'B', plan: 'pro' };</script>

As tags persistem entre navegações dentro da mesma aba do navegador, então basta defini-las uma vez no início da visita. hmx('unset', 'ab_variant') remove uma tag.

Filtragem no painel

Abra um site e depois o mapa de calor de uma página. Um menu suspenso "Tag" aparece na linha de filtros no canto superior direito, ao lado do filtro de dispositivo. Cada opção mostra a chave, o valor e o número de sessões, como ab_variant = B (128). Escolha uma e os mapas de calor de cliques, rolagem e movimento do mouse são redesenhados apenas para esse segmento.

O menu suspenso fica oculto em sites que ainda não têm dados com tags. Ele passa a ficar disponível assim que o primeiro evento com tag chega após a instalação.

Filtragem pelo servidor MCP

O servidor MCP, usado a partir do Claude e de outras ferramentas de IA, também oferece suporte a tags.

  • Passe tags: { "ab_variant": "B" } para get_heatmap_summary para obter o resumo desse segmento. Várias chaves são combinadas com E lógico.
  • Uma nova ferramenta, list_tags, retorna as chaves e valores observados em um site.

Regras

  • Chaves: letras minúsculas, dígitos, _ e -, de 1 a 32 caracteres (letras maiúsculas são convertidas para minúsculas). Valores: de 1 a 64 caracteres. Até 10 chaves por vez.
  • Não coloque dados pessoais nos valores, como endereços de e-mail, IDs de usuário ou números de pedido. Valores que contenham @ e . ao mesmo tempo não são armazenados.
  • Até 50 valores distintos por chave nos últimos 30 dias. Novos valores além desse limite são ignorados.
  • Se você não usar tags, nada muda no que é enviado.

Preços

Disponível em todos os planos, incluindo o gratuito.

Escopo do impacto

Usa sua tag de rastreamento existente como está. Sites que não definem tags não são afetados. O script de rastreamento (tracker.js) fica em cache nos navegadores por até 24 horas, então, logo após a instalação, alguns visitantes recorrentes podem só ver a mudança no dia seguinte.

Heatmaps no Claude Code — comece grátis.

Cole uma tag de tracking e receba análises e sugestões CRO via CLI.