Registar eventos personalizados

O que são eventos personalizados?

As visualizações de página são registadas automaticamente, mas muitas ações importantes não implicam carregar uma nova página: clicar num botão, submeter um formulário, reproduzir um vídeo, transferir um ficheiro. Os eventos personalizados permitem-lhe acompanhar estas interações.

Registar eventos com JavaScript

Utilize a função umami.track() em qualquer ponto do JavaScript do seu site:

// Basic event — just a name
umami.track('signup-click');

// Event with custom data
umami.track('download', {
  fileName: 'whitepaper-2026.pdf',
  category: 'resources'
});

// Event with multiple properties
umami.track('video-play', {
  title: 'Product Demo',
  duration: 120,
  autoplay: false
});

Registar eventos com atributos HTML

Para registar cliques simples, não precisa de escrever JavaScript. Basta adicionar o atributo data-umami-event a qualquer elemento HTML:

<!-- Basic click event -->
<button data-umami-event="signup-click">Sign Up</button>

<!-- Event with extra data -->
<a href="/pricing"
   data-umami-event="cta-click"
   data-umami-event-location="header">
  View Pricing
</a>

<!-- Download tracking -->
<a href="/files/report.pdf"
   data-umami-event="download"
   data-umami-event-file="report.pdf">
  Download Report
</a>

Todos os atributos data-umami-event-* passam a ser propriedades personalizadas do evento.

Consultar os dados dos eventos

Abra Eventos na barra lateral, em Tráfego.

Vai encontrar:

• Cronologia de eventos: um gráfico com as ocorrências de eventos ao longo do tempo
• Lista de eventos: todos os eventos registados e respetivas contagens
• Propriedades do evento: clique num evento para ver a distribuição dos seus dados personalizados

Identificação de utilizadores

Também pode identificar visitantes com propriedades personalizadas através de umami.identify():

umami.identify({
  userId: 'user-123',
  plan: 'pro',
  company: 'Acme Corp'
});

Isto associa dados personalizados à sessão do visitante, que depois pode usar para filtrar e segmentar.

Padrões comuns de registo de eventos

Boas práticas

• Use nomes descritivos e consistentes. add-to-cart é melhor do que click1.
• Mantenha os valores das propriedades limpos. Evite valores dinâmicos que criem demasiadas entradas únicas (por exemplo, carimbos de data/hora).
• Registe o resultado, não o clique. Registe form-submit, não submit-button-click.
• Não registe em excesso. Concentre-se nos eventos que dão informação útil para agir.

E agora?

• → Acompanhar objetivos de conversão: use eventos como objetivos de conversão
• → Configurar funis de conversão: crie funis a partir de eventos
• → Registo de receitas: adicione dados de receita aos eventos

Precisa de ajuda? Contacte-nos através de support@eurometrics.eu.