Analytics

1 out, 2013

Integrando o Google Analytics ao seu app Android

Publicidade

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 artigo, 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.

A 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 e criá-la. 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 é o libGoogleAnalyticsServices.jar. Copie-o para o diretório /libs do seu projeto.

Screen Shot 2013-08-31 at 12.14.48

Para utilizar o Google Analytics, é necessário que o seu aplicativo tenha dois 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 o 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" />

Screen Shot 2013-03-26 at 3.10.48 AM Screen Shot 2013-08-31 at 12.22.21 (1)

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>

Screen Shot 2013-08-31 at 12.30.58

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 duas 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 dois 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:

Screen Shot 2013-08-31 at 13.18.58 (1)

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());**               
    }
 });

Screen Shot 177

 

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.

events

É isso aí! Nesse artigo, 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, veja estes links:

***

Artigo enviado pelo MobGeek e publicado primeiramente em seu blog.