Contactar o apoio

Respondemos por e-mail, normalmente em dois dias.

Para prevenir abusos, o Google reCAPTCHA verifica este envio; alguns dados são transmitidos ao Google. O script só é carregado na abertura deste formulário.

← Todos os artigos

Levar os dados em CSV ou JSON

Há uma ligação na página de estatísticas marcada CSV, e ao lado dela uma marcada JSON. Entregam os números num ficheiro. Sem conta, sem formulário de pedido, sem esperar por um e-mail com uma ligação de transferência lá dentro.

Este artigo é sobretudo sobre o motivo de essa ligação lá estar.

O que se recebe

CSV dá uma linha por dia com quatro colunas — data, acessos, visitantes únicos, e bots. Abre em qualquer folha de cálculo sem ser preciso configurar nada, que é todo o objetivo de escolher esse formato.

JSON dá os mesmos números diários, mais as repartições: países, cidades, navegadores, tamanhos de ecrã, e as páginas mais visitadas, junto com uma nota de quando o ficheiro foi gerado e que período abrange.

30 — por omissão400 — máximodiaso mesmo prazo por que a própria estatística é guardada

Ambos aceitam um período. Com &days=90 são três meses, ou qualquer valor até 400 — a mesma janela durante a qual as próprias estatísticas são guardadas. Sem isso, chegam os últimos 30 dias.

É um endereço simples

A exportação é um URL vulgar, o que significa que pode ser obtida por qualquer coisa capaz de obter um URL. Para puxar esses números para uma folha de cálculo uma vez por semana, ou para um pequeno script que mantenha o seu próprio arquivo a recuar mais de 400 dias, nada aqui se atravessa no caminho e não é preciso nenhuma chave.

Isso é deliberado. Um botão de transferência que só funciona quando um humano clica nele num navegador é um botão de transferência concebido para ser usado uma vez.

O que não contém

Vale a pena ser direto quanto a isto: são os mesmos dados que a página de estatísticas já mostra. Não há nenhuma camada oculta mais rica a ser desbloqueada. A exportação existe para que os dados sejam portáveis, não para que sejam mais completos.

Em particular, não há nada por visitante, porque não é guardado nada por visitante. O hash diário que distingue visitas repetidas é eliminado ao fim de 2 dias e não está no ficheiro. O que se pode exportar é o que existe: contagens, agrupadas.

Para quê incomodar-se

Porque sair tem de continuar possível.

Um serviço que mantém refém o histórico de quem o usa não o está a reter pela qualidade, está a retê-lo pelo custo de recomeçar. É uma má razão para alguém ficar, e uma coisa ainda pior de se construir deliberadamente.

O histórico dos visitantes pertence a quem gere o contador. Levá-lo e ir para outro lugar é perfeitamente razoável, e as ferramentas para o fazer não deviam ser a parte pior mantida do site.

Publicidade