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
- Android developer SDK – Disponível para Mac OS X, Linux e Windows: http://developer.android.com/sdk/
- Google Analytics SDK 3.0.0 para Android: https://developers.google.com/analytics/devguides/collection/android/resources
- Ter um projeto Android criado utilizando sua IDE preferida: Eclipse IDE com o ADT (Android Developer Tools) ou Android Studio.
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?
- Escolha a aba “Aplicativo”;
- Preencha o “Nome do aplicativo” com o mesmo que aparece na loja de apps;
- Escolha a “Categoria do setor” que melhor se adeque ao seu app;
- Escolha o “Fuso horário dos relatórios” como Brasil e uma das capitais.
- Preencha o “Nome da conta” com o nome do desenvolvedor ou da organização/marca que represente aquele aplicativo.
- 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.
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" />
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 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:
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 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:
- Práticas recomendadas para a configuração do Mobile App Analytics;
- Blog Google Analytics;
- Livro de Lean Analytics de Alistair Croll e Ben Yoskovitz.
***
Artigo enviado pelo MobGeek e publicado primeiramente em seu blog.