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 também cliques em 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.
Análise do sítio Web
As medições só funcionam para as funcionalidades que ativares. Guardar definições desativadas interrompe a recolha futura.
As notas são privadas por predefinição. As notas públicas são visíveis para todas as pessoas que possam consultar as estatísticas.
Usa etiquetas de campanha curtas sem nomes, endereços de e-mail nem identificadores de clientes. Os valores de campanha são limitados; os valores não reconhecidos são ignorados.
Escolhe entre dois e oito passos. Usa page:/contact ou event:contact, um por linha. Os passos têm de ocorrer por ordem durante uma visita; podem ocorrer outras atividades entre eles. Uma visita termina após trinta minutos de inatividade ou na mudança de dia. Os relatórios contam visitas, não pessoas únicas.
Só são contadas as categorias e os nomes das ações. Não são enviados números de telefone, endereços de e-mail nem valores dos campos dos formulários. O envio de um formulário não comprova o seu sucesso. Confirma o sucesso com s4u.formSuccess('contact') ou uma integração de formulários WordPress suportada.
<form data-s4u-form="contact">…</form>
s4u.formSuccess('contact');Vendas
Liga a loja com o seu número de contador e o seu segredo. Comunica apenas pagamentos e reembolsos confirmados. As vendas líquidas correspondem aos montantes pagos menos os reembolsos; os reembolsos não alteram a contagem de encomendas pagas.
O meu painel
Escolha dos relatórios visíveis e da ordem. Os cartões ocultos não são carregados. A disposição é privada; os leitores usam a disposição predefinida.
Vistas guardadas
O período atual e os filtros suportados podem ser guardados para outra visita. Só o proprietário vê as vistas guardadas. Os períodos relativos acompanham a data; as datas personalizadas de início e fim mantêm-se fixas.
Grupos de páginas
Agrupamento de páginas relacionadas, por exemplo /blog/* para o blogue. O * final corresponde a caminhos que começam com esse prefixo. São suportados até dez grupos com oito regras cada. Podem sobrepor-se, pelo que os visitantes não devem ser somados.
As visualizações usam os totais de páginas guardados disponíveis e podem incluir robôs conforme a definição do contador. Visitantes de grupos e objetivos são registados desde a criação do grupo. Um visitante conta uma vez por grupo por dia, não uma vez em todo o período.
Propriedades dos eventos
Defina até dez nomes de propriedades e até vinte valores permitidos por propriedade antes de os enviar. Utilize categorias fixas como plan=basic, nunca nomes, endereços de correio eletrónico, números de encomenda ou dados introduzidos em formulários. Cada propriedade é contada separadamente; não são inferidas combinações.
São aceites, no máximo, cinco propriedades por evento e 500 combinações de evento/propriedade/valor por contador e dia.
Core Web Vitals
Mede o carregamento (LCP), a resposta às interações (INP) e as alterações de disposição (CLS) nos navegadores suportados. As medições em falta não são zero. Não é comunicado INP sem interação. As medições começam após a ativação.
O percentil 75 é estimado a partir de intervalos limitados do histograma. São conservadas até 100 combinações de página e dispositivo por contador e dia. Os valores no último intervalo significam pelo menos esse valor. As medições do navegador não incluem toda a atividade dos iframe de outras origens e não são idênticas aos dados CrUX da Google.
Ativar a medição opcional de Web Vitals
Relatório de estatísticas do sítio Web
Escolha um período e cartões e utilize depois a caixa de diálogo de impressão do navegador para imprimir ou guardar um PDF. As notas exclusivas do proprietário só são incluídas quando a página é aberta com a chave do proprietário.
Painel e ferramentas
Liga o teu próprio contador com a respetiva chave de proprietário. Também podes colar a ligação de gestão completa. Os contadores ligados ficam memorizados nesta sessão do navegador; alterar a chave de proprietário remove o acesso.
Relatórios agendados
Escolhe uma vista guardada e o envio semanal ou mensal para o teu endereço de email de proprietário confirmado. Os filtros e os relatórios selecionados são reutilizados; o relatório abrange a última semana ou o último mês completos no fuso horário do contador. As notas privadas são omitidas. Não é enviado qualquer email até ativares um agendamento.
Incorporar um cartão de estatísticas
Escolhe um relatório e os respetivos filtros. O iframe gerado usa uma chave separada só de leitura, expira na data selecionada e pode ser revogado aqui. As notas privadas e as ações do proprietário nunca são incluídas.
API de estatísticas
Cria uma chave API separada só de leitura para os relatórios selecionados. Envia-a num cabeçalho Authorization: Bearer; nunca uses a tua chave de proprietário em scripts. As chaves API podem ser revogadas e têm prazo de validade. JSON e CSV contêm apenas dados agregados.
As exportações abrangem, no máximo, 400 dias e 500 linhas por relatório. As contagens de visitantes e de visitantes que atingiram um objetivo são totais diários; os grupos sobrepostos não devem ser somados. Os percentis Web Vitals são estimados através de histogramas e exigem um número suficiente de amostras.