Usando a API de rastreamento JavaScript do Piwik para obter informações sobre o visitante atual no navegador

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();`