Integrando o Google Analytics ao seu app Android

google-analytics-for-android
Share
banner

Você já desenvolveu seus primeiros aplicativos e até publicou alguns no Google Play. Agora é hora de acompanhar a evolução do seu aplicativo de perto e nada melhor que o Google Analytics para te ajudar.

Seguindo esse tutorial, você irá integrar o Google Analytics em seu projeto Android, desde como obter o SDK oficial do Google Analytics até a geração de relatórios com pageView e eventos capturados no aplicativo.

Requisitos

O que é o Google Analytics?

O Analytics é uma ferramenta para coletar dados de tráfego de visitantes a alguma propriedade e gerar relatórios a partir desses dados.

propriedade pode ser um aplicativo, um site, um blog ou qualquer outra página que possa ser acessada através da internet. E dentro de cada propriedade você pode definir visualizações de propriedade (views) que capturam apenas uma porção dos dados, filtrados por parâmetros como sistema operacional, modelo de aparelho, versão de aplicativos, etc.

Vamos começar pela sua conta no Google Analytics.

Conta de usuário

O Analytics é um produto Google, portanto você pode acessá-lo usando sua conta do Gmail ou do Google Apps para acessá-lo. Se não tiver uma basta acessar , criá-la e logo em seguida você será direcionado ao Analytics.

Cadastrar o aplicativo

Ao se cadastrar, logo você verá um formulário “O que você deseja acompanhar?”. É nele que vamos começar.

Caso você já tenha uma conta criada no Analytics, clique na aba“Administrador”. Escolha uma das suas contas na primeira coluna e em seguida, nas “Propriedades” escolha “Criar nova propriedade”, você verá o formulário “O que você deseja acompanhar?”. Vamos começar?

  1. Escolha a aba “Aplicativo”;
  2. Preencha o “Nome do aplicativo” com o mesmo que aparece na loja de apps;
  3. Escolha a “Categoria do setor” que melhor se adeque ao seu app;
  4. Escolha o “Fuso horário dos relatórios” como Brasil e uma das capitais.
  5. Preencha o “Nome da conta” com o nome do desenvolvedor ou da organização/marca que represente aquele aplicativo.
  6. Finalize clicando em “Obter ID de acompanhamento”.

Pronto, agora você tem o seu ID de acompanhamento para um aplicativo e podemos por a mão na massa.

Preparação do projeto para o Analytics

Dentro do Google Analytics SDK 3.0.0 para Android (GoogleAnalyticsAndroid.zip), você encontrará a seguinte estrutura de pastas e arquivos:

 ga
    Changelog.txt
    javadocs.zip
    Readme.txt
 gtm
    Changelog.txt
    examples
        cuteanimals
            ...
        helloworld
            ...
    Readme.txt
 libGoogleAnalyticsServices.jar
 Readme

Desse pacote, o único arquivo que você vai precisar para tutorial é olibGoogleAnalyticsServices.jar. Copie-o para o diretório /libs do seu projeto.

Para utilizar o Google Analytics, é necessário que o seu aplicativo tenha 2 tipos de permissões: INTERNET e ACCESS_NETWORK_STATE. A primeira é para acessar a Internet e a segunda para permitir que o seu aplicativo consiga acessar informações sobre o estado da sua conexão, se ela está disponível para envio de dados para os servidores do Google Analytics.

Para adicioná-las, abra o AndroidManifest.xml e adicione dentro da tag :

 <uses-permission android:name="android.permission.INTERNET" />
 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Crie o arquivo analytics.xml dentro do diretório res/values. Adicione oga_trackingId e também os outros parâmetros abaixo:

 <?xml version="1.0" encoding="utf-8" ?>
 <resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
    <!-- Replace placeholder ID with your tracking ID -->
    <string name="ga_trackingId">UA-XXXX-Y</string>
    <!-- Enable automatic activity tracking -->
    <bool name="ga_autoActivityTracking">true</bool>
    <!-- Enable automatic exception tracking -->
    <bool name="ga_reportUncaughtExceptions">true</bool>
 </resources>

Lista completa de parâmetros configuráveis:

https://developers.google.com/analytics/devguides/collection/android/parameters

Nesse momento, você já está com o ambiente configurado. O .jar está incluído em seu projeto (contendo todo o source do Google Analytics), as 2 permissões necessárias estão configuradas, o arquivo analytics.xml está criado e o ga_trackingId associado.

Agora vamos para a parte divertida: o código.

Captura de dados e relatório em tempo real

Para cada Activity do seu projeto, você irá sobrescrever 2 métodos, onStart e onStop, adicionando a seguintes linhas:

 — EasyTracker.getInstance(this).activityStart(this);
 — EasyTracker.getInstance(this).activityStop(this);

 @Override
    protected void onStart() {
       super.onStart();
       EasyTracker.getInstance(this).activityStart(this);
    }

 @Override
    protected void onStop() {
       super.onStop();
       EasyTracker.getInstance(this).activityStop(this);
    }

Agora vamos ao grande momento! Se você seguiu todos os passos acima, você já conseguirá visualizar em tempo real a localização e o número de usuários do seu aplicativo, conforme exemplo abaixo:

Capturar eventos

Para captura do click de um botão, adicione:

 findViewById(R.id.pressMeBT).setOnClickListener(new OnClickListener() {
    @Override
    public void onClick(View view) {
       EasyTracker tracker = EasyTracker.getInstance(MainActivity.this);**
       tracker.send(MapBuilder.createEvent("UX", "touch", "pressMeClicked", null).build());**               
    }
 });

Importante: para ter uma instância válida da classe EasyTracker é necessário passar como parâmetro um contexto válido. Caso seja null, você obteráIllegalStateException.

Pronto, agora você já conhece os dois métodos mais comuns de capturas de dados com o Google Analytics.

Um pouco sobre a arquitetura do Google Analytics

Caso o usuário não tenha conexão disponível, todos os eventos serão guardados em um storage local, e da próxima vez que o aplicativo for executado, estes dadosl serão enviados para o Google Analytics.

Vale lembrar que o Google Analytics pode demorar até 24 horas para exibir os dados capturados dos eventos.

É isso aí! Nesse tutorial, você aprendeu a:

  • Criar sua conta e obter a versão mais atual do Google Analytics
  • Adicionar a SDK do Google Analytics ao seu projeto Android
  • Configurar o Google Analytics em seu Projeto
  • Rastrear a visualização de uma Activity
  • Rastrear eventos customizados

Quer saber sobre métricas de aplicativos, se liga nestes links:

  • Práticas recomendadas para a configuração do Mobile App Analytics (link)
  • Blog Google Analytics (link)
  • Livro de Lean Analytics de Alistair Croll e Ben Yoskovitz(link)

Post enviado pelo MobGeek e publicado primeiramente em seu blog.

PUBLICIDADE


Quer continuar por dentro das novidades do Blog Seja Livre? Siga o nosso perfil no TWITTER, curta a nossa página no FACEBOOK ou adicione o Blog Seja Livre nos seus círculos do GOOGLE+. Se você usa ORKUT, nós também estamos lá, inclusive no IDENTI.CA e Linkedin.

Sobre o Autor

Blogueiro, fundador do Blog Seja Livre, Nerd inveterado, louco por Linux e músico nas horas vagas. Atualmente é o Editor Chefe, Consultor de SEO e Webdesign do Seja Livre, e possui algumas certificações em Linux e Administração de Redes. É usuário Ubuntu e membro do LoCo Team Ubuntu-BR-SP e da Comunidade Ubuntu-BR.