Eventos rastreados permitem que você meça ações específicas que os visitantes realizam em seu site, como clicar em um botão, enviar um formulário ou qualquer outra interação que você ache importante.

O que é rastreado automaticamente

Ahrefs Web Analytics rastreia automaticamente os seguintes eventos:

Cliques em links externos – Disparados quando um usuário clica em um link com um href válido que leva para fora do escopo do projeto, a menos que event.preventDefault() seja chamado.
Envios de formulários – Disparados quando um formulário com uma action válida é enviado, a menos que event.preventDefault() seja chamado.

Esses eventos não exigem nenhuma configuração e aparecerão em seu relatório por padrão. Você também pode adicionar seus próprios eventos rastreados para medir outras ações específicas que são importantes para o seu site.

Tipos de eventos rastreados

Você pode rastrear dois tipos de eventos:

Eventos de visualização de página – Acionados quando alguém visita uma página específica, como uma página de agradecimento ou finalização de compra.
Eventos personalizados – Acionados quando alguém interage com um elemento em seu site, como clicar em um botão, enviar um formulário ou abrir um modal.

Eventos de visualização de página

Os eventos de visualização de página são úteis para acompanhar visitas a páginas importantes, como páginas de confirmação ou de sucesso. Se o seu site tiver URLs específicas para ações concluídas, como /thank-you ou /checkout/success, você pode configurá-las como eventos rastreados.

Para configurar um evento de visualização de página:

Abra o relatório de Ahrefs Web Analytics para o seu projeto.
Role até a seção de Eventos rastreados e clique em Novo evento.
Escolha Visualização de página como o tipo e insira o caminho exato da página que deseja rastrear.
Nomeie o evento para torná-lo mais fácil de reconhecer e clique em Criar.

Eventos personalizados

Os eventos personalizados são úteis para acompanhar interações como cliques em botões, envios de formulários ou outras ações que não carregam uma nova página. Você pode configurá-los adicionando nomes especiais de classes ao seu HTML.

A forma mais simples de configurá-los é adicionar uma classe no formato AhrefsAnalytics-event-EventName ao seu HTML.

Exemplo:

<a class="AhrefsAnalytics-event-signup" href="#">Sign up</a>

Isso vai rastrear um evento chamado signup quando o link for clicado.

O mesmo vale para formulários:

<form class="AhrefsAnalytics-event-signup" action="/submit">
 ...
</form>

Isso vai disparar um evento personalizado chamado signup quando o formulário for enviado.

Para começar a ver o evento personalizado, você também precisa adicioná-lo ao seu relatório:

Abra o relatório de Ahrefs Web Analytics para o seu projeto.
Role até a seção de Eventos rastreados e clique em Novo evento.
Escolha Evento personalizado como o tipo e insira o nome exato do evento que você usou no seu HTML.
Nomeie o evento para torná-lo mais fácil de reconhecer e clique em Criar.

Como disparar eventos personalizados via JavaScript

Para um rastreamento mais preciso, você pode enviar eventos personalizados usando JavaScript. Isso dá mais controle sobre quando o evento é disparado

O trecho abaixo mostra como fazer isso:

if (window.AhrefsAnalytics != null) {
 window.AhrefsAnalytics.sendEvent('signup');
}

Propriedades de evento (opcional)

As propriedades de evento permitem associar detalhes extras a um evento rastreado.
Elas são úteis quando você quer detalhar o mesmo evento por variantes, planos ou outras dimensões.

Exemplos:

Um evento signup com propriedades como plan = standard, duration = monthly
Um evento cta_click com propriedades como button = header, variant = B
Um evento purchase com propriedades como category = shoes, size = 42

Você verá essas propriedades depois nos relatórios de propriedades de evento.

Observação: os nomes e valores das propriedades são tratados como strings. Ao usar os atributos ou nomes de classes abaixo, os nomes das propriedades não podem conter hífens (-), porque os hífens são usados como delimitadores.

Como associar propriedades de evento

Há três maneiras de associar propriedades aos seus eventos:

Adicionar propriedades a todos os eventos via script de rastreamento.
Adicionar propriedades a um único evento personalizado via classes CSS.
Adicionar propriedades via JavaScript (API de JS).

1. Associar propriedades a todos os eventos (script de rastreamento)

Você pode associar uma propriedade a todos os eventos adicionando atributos data-prop-NAME="VALUE" à tag <script> de rastreamento:

<script
  src="https://analytics.ahrefs.com/analytics.js"
  data-key="YOUR_DATA_KEY"
  data-prop-plan="standard"
  data-prop-duration="monthly">
</script>

Isso vai adicionar plan = "standard" e duration = "monthly" a todos os eventos enviados desta página.

Observação: NAME não pode conter hífens (-).

2. Associar propriedades a um único evento personalizado (classes CSS)

Você pode associar propriedades a um evento personalizado específico usando nomes especiais de classes CSS no elemento que o dispara.

Exemplo – um botão que dispara um evento signup com uma propriedade plan:

<div
  class="
    AhrefsAnalytics-event-signup
    AhrefsAnalytics-prop-plan-standard
  ">
  Sign up for Standard
</div>

Aqui:

AhrefsAnalytics-event-signup instrui o script do Ahrefs Web Analytics a enviar um evento signup quando este elemento for clicado.
AhrefsAnalytics-prop-plan-standard adiciona a propriedade plan = "standard" somente a esse evento.

Observação: os nomes das propriedades em AhrefsAnalytics-prop-… também não podem conter hífens (-).

3. Associar propriedades via JavaScript (API de JS)

Se você estiver disparando eventos via JavaScript, poderá associar propriedades passando um objeto como segundo argumento para sendEvent:

if (window.AhrefsAnalytics != null) {
  window.AhrefsAnalytics.sendEvent(
    'signup',
    {
      props: {
        plan: 'standard',
        duration: 'monthly'
      }
    }
  );
}

Essa é a opção mais flexível se você precisar definir propriedades com base no estado do seu app, como usuário logado, variante de teste A/B etc.

Como usar propriedades de evento em relatórios

As propriedades de evento não aparecem automaticamente. Depois que você começar a enviá-las, precisará adicioná-las aos seus relatórios.

Relatório de propriedades de evento

Use isso quando quiser um detalhamento por valores de propriedade.

Abra o relatório de Web Analytics do projeto.
Acesse o relatório Propriedades de evento.
Clique em Nova propriedade.
Escolha a propriedade de evento, dê um nome a ela e clique em Criar.

Isso permite ver visitantes e eventos divididos por valor de propriedade — por exemplo, inscrições por plano, variante do botão ou país.

Filtragem por propriedades de evento

Você também pode usar propriedades de evento para segmentar outros relatórios.

Clique em Adicionar filtro e selecione Propriedade de evento.
Escolha a propriedade e o valor ou os valores pelos quais você quer filtrar.

Isso permite restringir qualquer relatório a, por exemplo, plan is standard ou variant is B. Você pode adicionar vários filtros de propriedade para refinar ainda mais o segmento.

Eventos rastreados no Ahrefs Web Analytics