Contar o que os visitantes fazem

Um contador diz quantas pessoas vieram. Os eventos dizem o que fizeram: carregaram no botão de contacto, transferiram o guia, enviaram o formulário. Conta-se apenas quantas vezes, nunca por quem.

1. Marcar um elemento

Adicione o atributo data-s4u-event a qualquer ligação ou botão. Cada clique nesse elemento é contado com esse nome.

<a href="/contact" data-s4u-event="contact">Contact</a>
<button data-s4u-event="guide-downloaded">Download</button>

2. Ou chamar a partir de um script

Onde não há nenhum clique para intercetar, como num formulário enviado ou num vídeo que chegou ao fim, chame a função diretamente:

<script>
  s4u.event('form-sent');
</script>

3. Ou contar todas as ligações automaticamente

Assinale “Contar automaticamente os cliques nas ligações” nas definições do seu contador (durante a configuração ou mais tarde, na caixa do proprietário da respetiva página de estatísticas). Cada clique numa ligação passa então a ser contado pelo seu destino, e não pelo texto da ligação: as páginas do seu próprio sítio pelo caminho, as ligações para outros sítios pelo respetivo anfitrião. Um elemento que já tenha data-s4u-event é contado uma só vez, com o nome que lhe atribuiu.

Regras para os nomes

Os nomes são escritos em minúsculas e usam apenas a–z, 0–9, hífen e sublinhado, com um máximo de 32 carateres; tudo o resto passa a hífen. Um contador pode ter no máximo 100 nomes diferentes. Os cliques automáticos em ligações podem ocupar até 70 desses nomes; os restantes ficam reservados para os nomes que definir. Quando o limite é atingido, os nomes existentes continuam a contar e não são acrescentados novos. Cada endereço pode enviar no máximo 300 eventos por hora.

O que não deve constar num nome

Um nome é mostrado na página de estatísticas pública. Não coloque lá nada que identifique uma pessoa: nem nome, nem endereço de e-mail, nem número de telefone, nem número de encomenda ou de cliente, nem token. Os nomes que contenham um @, uma sequência longa de algarismos ou um código longo e de aspeto aleatório são rejeitados automaticamente. Um nome simples como “jan-kowalski” não pode ser reconhecido e seria guardado, por isso nunca crie nomes a partir do que um visitante escreveu.

O que é guardado

Uma linha por contador, dia e nome, com um número associado. Nenhum visitante, nenhum endereço, nenhuma ordem de cliques. A partir de “contact: 14” é impossível saber quem clicou.

Onde o vê

Na página de estatísticas do seu contador, na secção Páginas: o cartão “O que os visitantes fizeram”, com a evolução ao longo do tempo e, quando houver dados suficientes, os eventos que subiram ou desceram em comparação com o período anterior.

Vários contadores numa página

Por predefinição, um evento pertence ao primeiro contador da página. Para escolher outro, indique o respetivo número: data-s4u-id="12345" no elemento ou s4u.event('name', '12345') num script.