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

Com o SDK do Google Analytics para Android, fica mais fácil para os desenvolvedores coletar dados de engajamento do usuário nos apps. Este documento fornece 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

Com o SDK do Google Analytics para Android, é fácil para os desenvolvedores coletar dados de engajamento dos usuários nos apps. Os desenvolvedores podem usar os relatórios do Google Analytics para avaliar:

  • 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 ferramentas para monitorar o sucesso da campanha de marketing para dispositivos móveis, oferecendo visibilidade completa do desempenho dos seus canais de marketing, desde as 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:

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

/**
 * 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 de chamar os métodos dele. No exemplo acima, esta linha: 

EasyTracker.getInstance.activityStart(this);

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

// 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 seu 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. É necessário criar esse arquivo no diretório res/values do projeto e adicionar seu ID de acompanhamento. O exemplo a seguir mostra como adicionar seu ID de acompanhamento e ativar o Activity e a avaliação de 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 ID de acompanhamento. É possível suprimir esse aviso adicionando outros atributos à 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.

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 guias do desenvolvedor a seguir para saber como adicionar esses recursos à sua 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 Analytics.xml: veja a lista completa de parâmetros de configuração analytics.xml.