Piwik é uma ótima solução analítica de OSS que é muito mais poderosa do que, presumo que a maioria dos usuários conheça. Achei sua documentação bastante prolixa (nunca é um bom sinal), a ponto de alguém se perder nela. Um exemplo específico é a API de rastreamento JavaScript.
Então, eu tive o seguinte problema: Eu queria uma maneira muito simples de obter algumas informações básicas sobre o visitante atual no navegador – é a primeira visita, o número total de visitas, a hora da última visita, etc. Isso faz muito de sentido para exibir mensagens específicas para novos usuários, frequentes, aqueles que não usam o sistema há um bom tempo, etc. Eu não queria fazer o rastreamento no back-end e também não queria tentar hackear o Cookie Piwik para raspar os dados.
Acontece que a API JavaScript do Piwik também pode fazer o trabalho. Ainda assim, eu tive que descobrir isso da maneira mais difícil – com tentativa e erro.
Tudo o que você precisa fazer é executar as duas linhas a seguir de JavaScript antes de aplicar sua lógica relacionada ao visitante:
var visitorInfo;
_paq.push([ function() { visitor_id = this.getVisitorInfo(); }]);
visitorInfo é uma espécie de matriz de números de aparência enigmática, mas, felizmente, descobri o que cada um desses números significa:
visitorInfo [0] = é um novo visitante? (entre 0/1)
visitorInfo [1] = o ID Piwik exclusivo do visitante atual
visitorInfo [2] = data e hora de criação (uma data e hora UNIX em segundos)
visitorInfo [3] = número geral de visitas
visitorInfo [4] = data e hora da visita atual
visitorInfo [5] = carimbo de data e hora da última visita
visitanteInfo [6] = carimbo de data / hora do último pedido de comércio eletrônico.
Agora, isso não é muito, mas o suficiente para começar. Conhecendo-os, pode-se definir algumas regras heurísticas como as que tentei definir.
Ainda estou em busca de uma solução mais genérica.
ATUALIZAÇÃO: há uma maneira ainda mais simples de obter as informações do visitante:
javascript var visitorInfo = Piwik.getAsyncTracker();
`