SDK do Google Analytics para Android v3 (legado) – primeiros passos

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:

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:

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.