SDK do Google Analytics para Android v2 (legado) – Visão geral

Com o SDK do Google Analytics para Android, os desenvolvedores podem coletar dados de engajamento dos usuários facilmente pelos apps. Este documento oferece uma visão geral do valor do SDK, bem como um guia para começar a medir seu app usando um único ID de propriedade e o EasyTracker.

Introdução

O SDK do Google Analytics para Android facilita a coleta de dados de engajamento dos usuários pelos apps dos desenvolvedores. Os desenvolvedores podem usar os relatórios do Google Analytics para medir:

  • O número de usuários ativos que estão usando os aplicativos.
  • A origem geográfica em que o aplicativo está sendo usado.
  • A adoção e o uso de recursos específicos.
  • Compras e transações no aplicativo.
  • O número e o tipo de falhas do aplicativo.
  • E muitas outras métricas úteis.

Além disso, o SDK do Google Analytics para Android oferece as ferramentas para monitorar o sucesso de uma campanha de marketing para dispositivos móveis, fornecendo visibilidade total do desempenho dos seus canais de marketing, desde instalações do Google Play até compras e transações no aplicativo.

Antes de começar

Antes de começar a implementar o SDK, verifique se você tem o seguinte:

Como começar

Há três etapas para começar a usar o SDK:

  1. Atualizar o AndroidManifest.xml
  2. Adicionar métodos do EasyTracker
  3. Criar seu arquivo analytics.xml

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 seu 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. Como adicionar métodos do EasyTracker

Adicione os métodos de envio aos métodos onStart() e onStop() de cada Activities, como no exemplo a seguir:

/**
 * An example Activity in your app with Analytics
 * implemented.
 */
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().activityStart(this); // Add this method.
  }

  @Override
  public void onStop() {
    super.onStop();
    ... // The rest of your onStop() code.
    EasyTracker.getInstance().activityStop(this); // Add this method.
  }
}

O EasyTracker exige Context antes que você possa chamar os métodos dele. No exemplo acima, esta linha: 

EasyTracker.getInstance.activityStart(this);

cuida da definição do contexto. No entanto, se precisar fazer chamadas do EasyTracker em outras classes ou métodos, primeiro será necessário chamar o método setContext(Context ctx) do EasyTracker #39;

// Set Context before using EasyTracker. Note that the SDK will
// use the application context.
EasyTracker.getInstance().setContext(this);

// EasyTracker is now ready for use.

3. Como criar o arquivo analytics.xml

Na versão 2 do SDK do Google Analytics para Android, as opções de configuração são gerenciadas em um arquivo de recurso XML, chamado analytics.xml neste guia. Você precisará criar esse arquivo no diretório res/values do projeto e adicionar seu ID de acompanhamento. O exemplo a seguir mostra como adicionar o ID de acompanhamento e ativar a medição de Activity e exceções:

<?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. É possível 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 podem ser usados para configurar a implementação.

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. Consulte os seguintes guias do desenvolvedor para saber como adicionar esses recursos à implementação:

  • Configuração avançada: saiba mais sobre as opções de configuração avançada, incluindo como usar vários rastreadores.
  • 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.
  • 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.
  • 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.
  • Parâmetros do Analytics.xml: veja a lista completa de parâmetros de configuração analytics.xml.