Você publicou um projeto no Github ou enviou um email em massa e agora não tem a menor ideia se outras pessoas estão acessando ou não? Se você usa Google Analytics seus problemas acabaram, com projeto ga-beacon você poderá ter uma visão (limitada) de quem está acessando seus projetos e emails de forma muito simples!

Sobre o projeto

O Google Analytics Beacon (ga-beacon) é um projeto criado Ilya Grigorik, funcionário da Google, tem como foco permitir que o Google Analytics possa funcionar em locais onde você não tem como colocar um Javascript no código fonte.

Claro que o uso desta ferramenta limita o rastreamento de acesso, porém é muito interessante para tirar você do escuro total e ver se seus projetos no github ou emails estão sendo visitados.

O projeto ga-beacon tem seu código fonte aberto, então se você quiser montar seu próprio servidor e não utilizar o oficial hospedado no Google App Engine.

Esta matéria vai limitar-se a lhe ajudar a usar o servidor já disponível.

Você vai precisar de

… uma conta no Google Analytics, se você não fez ainda, este é um bom momento.

Então você precisa criar uma “Propriedade“, Pra isso use a Administrador, crie sua Conta e uma Propriedade.

Criando nova proripedade no GA

Criando nova proripedade no GA

Se você está confuso, basta clicar na lista abaixo do nome e em “Criar nova (conta ou propriedade)“.

Repare que suas propriedades tem um ID, por exemplo: UA-12345678-9.

E só isso já te permite utilizar o ga-beacon.

Uma dica, na hora de criar a Propriedade, crie por exemplo como “Github Projects” ou “Projetos do Github”, caso seja pra monitorar emails, você pode criar uma propriedade “Mass mails” ou “Emails em massa”, o nome serve para organizar as suas estatísticas. Mas durante as configurações você poderá identificar a página de origem do acesso, caso tenha vários projetos, pra não precisar criar uma propriedade por projeto.

Instruções de uso

Como já foi dito, o ga-beacon vai adicionar a possibilidade de adicionar uma imagem com uma URL qual vai fazer a tarefa de registrar o acesso na sua conta do Google Analytics. E para isso a imagem vai ter um endereço personalizado.

  • https://ga-beacon.appspot.com/UA-XXXXX-X/seu-repositorio/pagina
  • UA-XXXXX-X deverá ser seu ID de rastreamento do Google Analytics
  • seu-repositorio/pagina é uma identificação que vai aparecer nos seus relatórios como página visitada, se está colocando no github, vai ficar normalmente como seu-repositorio/readme ou seu-repositorio/pagina-da-wiki

Exemplo pra usar o rastreador em um arquivo de Markdown:

[![Analytics](https://ga-beacon.appspot.com/UA-XXXXX-X/seu-repositorio/pagina)](https://github.com/igrigorik/ga-beacon)

Ou pra RDoc:

{<img src="https://ga-beacon.appspot.com/UA-XXXXX-X/seu-repositorio/pagina" />}[https://github.com/igrigorik/ga-beacon]

Você ainda pode não adicionar a imagem do badge incluindo no fim da URL o parametro ?pixel

Exemplo:

<img src="https://ga-beacon.appspot.com/UA-XXXXX-X/seu-repositorio/pagina?pixel" />

Conclusão

É muito simples e útil esta ferramenta pra monitorar os acessos dos seus projetos, em questão de minutos você poderá configurar e começar a monitorar.

Eu acho muito legal manter o link no badge para o projeto original, de forma incentivar e informar as pessoas que acessam seus projetos, para que eles também possam um dia passar a usar a ferramenta, boas ideias devem ser reconhecidas e compartilhadas.

E usando isso me lembrei de que a alguns anos atras eu utilizei um recurso parecido para descobrir dados de quem acessava meu falecido Orkut, colocando uma imagem em um servidor remoto e que no caso do Orkut você podia adicionar a referencia remota da imagem e quem acessava baixava a imagem do seu servidor, por fim acabava fornecendo o IP e mais alguns dados vindos pela requisição do browser. Muito parecido com o que esta ferramenta faz para informar seu Google Analytics de quem e quando alguém está acessando sua página. Nostalgias a parte, espero que gostem da ferramenta.