Este documento descreve como começar a usar o SDK do Google Analytics para Android v3.
Antes de começar
Antes de implementar o SDK, certifique-se de ter:
- SDK para desenvolvedores Android (disponível para Windows, Mac OS X e Linux)
- SDK do Google Analytics para Android v3 (com
libGoogleAnalyticsServices.jar
incluído no diretório/libs
e no caminho de criação do seu projeto) - Um app Android que você pode usar para implementar o Google Analytics
- Pelo menos uma propriedade e uma vista da propriedade (perfil) do aplicativo do Google Analytics para a qual enviar dados do seu aplicativo
Como começar
Há três etapas para começar a usar o SDK:
Depois de concluir essas etapas, você poderá avaliar os itens a seguir com o Google Analytics:
- Instalações de aplicativos
- Usuários ativos e informações demográficas
- Telas e engajamento dos usuários
- Falhas e exceções
1. Atualização do AndroidManifest.xml
Atualize o arquivo AndroidManifest.xml
adicionando as seguintes
permissões:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
2. Adicionar métodos do EasyTracker
Adicione os métodos de envio aos métodos onStart()
e
onStop()
de cada um dos Activities
, como no
exemplo a seguir:
package com.example.app; import android.app.Activity; import com.google.analytics.tracking.android.EasyTracker; /** * An example Activity using Google Analytics and EasyTracker. */ public class myTrackedActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); } @Override public void onStart() { super.onStart(); ... // The rest of your onStart() code. EasyTracker.getInstance(this).activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance(this).activityStop(this); // Add this method. } }
3. Como criar seu arquivo analytics.xml
Quando você usa o EasyTracker, as configurações globais são gerenciadas usando recursos definidos no XML. Crie um arquivo chamado analytics.xml
no
diretório res/values
do projeto e adicione os seguintes recursos:
<?xml version="1.0" encoding="utf-8" ?> <resources> <!--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>
Seu verificador de lint pode avisar você sobre o uso do traço ("-") no seu ID de acompanhamento. Você pode suprimir esse aviso adicionando outros atributos à sua tag <resources>
:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
Consulte a referência de parâmetros analytics.xml para ver a lista completa de parâmetros que você pode usar para configurar sua implementação. Dependendo dos requisitos do seu aplicativo, talvez seja necessário alterar o período de envio para verificar se você está enviando hits corretamente. Por exemplo, se você quiser ver dados em tempo real, defina um valor baixo, como 5s.
Parabéns! Agora seu aplicativo está configurado para enviar dados ao Google Analytics.
Próximas etapas
Você pode fazer muito mais com o Google Analytics, incluindo avaliar campanhas, pagamentos e transações no aplicativo e eventos de interação dos usuários.
Os seguintes guias do desenvolvedor fornecem detalhes adicionais sobre como implementar recursos do Google Analytics no seu aplicativo:
- Avaliação de eventos: saiba como avaliar o engajamento dos usuários com conteúdos interativos, como botões, vídeos e outras mídias que usam eventos.
- Avaliação de pagamentos no aplicativo: saiba como avaliar pagamentos e transações no aplicativo.
- Avaliação de campanhas: saiba como implementar a avaliação de campanhas para compreender quais canais e campanhas estão promovendo instalações de aplicativos.
- Velocidade do usuário: saiba como avaliar a velocidade do usuário no seu aplicativo para medir os tempos de carregamento, o engajamento com a mídia e muito mais.
- Configuração avançada: saiba mais sobre as opções de configuração avançada, incluindo como usar vários rastreadores.
-
Parâmetros Analytics.xml: veja a lista completa de parâmetros de configuração
analytics.xml
.