Testar grátis

Eventos personalizados com track()

Atualizado em 28 de outubro de 2026

Registrar cliques, cadastros e outras ações com window.utmetrica.track, e os limites aceitos.

Além das visualizações, você pode registrar ações do visitante: clicar em um botão, preencher um formulário, abrir o WhatsApp.

window.utmetrica?.track("clicou_whatsapp");

window.utmetrica?.track("cadastro_newsletter", {
  origem: "rodape",
  plano: "gratis",
});

Regras

  • O nome tem no máximo 64 caracteres.
  • As propriedades aceitam texto, número ou verdadeiro/falso, até 16 por evento. Nomes de propriedade começam com letra e usam letras, números e _, até 40 caracteres. Textos são cortados em 200 caracteres.
  • Propriedades com nomes que costumam carregar dados pessoais (e-mail, telefone, CPF, nome, endereço, cartão, senha, token) são descartadas, assim como valores de texto que parecem e-mail ou CPF.
  • Os nomes purchase, payment_confirmed, order_paid, refund e subscription_renewed são recusados: venda só entra por webhook de checkout ou gateway, nunca pelo navegador.
  • Se o consentimento é exigido e ainda não foi dado, track() não faz nada.

Um evento personalizado pode ser uma etapa de um funil (em Funis, uma linha que não começa com / é tratada como nome de evento) e aparece na linha do tempo do visitante. Ele não substitui a receita, que vem das integrações.

Veja também