SDK di Google Analytics per Android v3 (legacy) - Per iniziare

Questo documento descrive come iniziare a utilizzare l'SDK di Google Analytics per Android v3.

Prima di iniziare

Prima di implementare l'SDK, assicurati di disporre di quanto segue:

Per iniziare

Per iniziare a utilizzare l'SDK sono tre i passaggi:

  1. Aggiorna AndroidManifest.xml
  2. Aggiungere metodi di EasyTracker
  3. Crea il file analytics.xml

Dopo aver completato questi passaggi, sarai in grado di misurare quanto segue con Google Analytics:

  • Installazioni di app
  • Utenti attivi e dati demografici
  • Schermate e coinvolgimento degli utenti
  • Arresti anomali ed eccezioni

1. Aggiornamento di AndroidManifest.xml

Aggiorna il file AndroidManifest.xml aggiungendo le seguenti autorizzazioni:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

2. Aggiunta di metodi EasyTracker

Aggiungi i metodi di invio ai metodi onStart() e onStop() di ogni Activities come nell'esempio seguente:

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. Creazione del file analytics.xml

Quando utilizzi EasyTracker, le impostazioni di configurazione globali vengono gestite utilizzando risorse definite in XML. Crea un file denominato analytics.xml nella directory res/values del progetto e aggiungi le risorse seguenti:

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

Il controllo lint potrebbe avvisarti sull'utilizzo del trattino breve ("-") nell'ID monitoraggio. Puoi eliminare questo avviso aggiungendo altri attributi al tag <resources>:

<resources xmlns:tools="http://schemas.android.com/tools"
tools:ignore="TypographyDashes">

Consulta il riferimento sui parametri analytics.xml per l'elenco completo dei parametri che puoi utilizzare per configurare la tua implementazione. A seconda dei requisiti della tua applicazione, ti consigliamo di modificare il periodo di invio per verificare di inviare correttamente gli hit. Ad esempio, se vuoi visualizzare dati in tempo reale, è consigliabile impostarlo su un valore basso, come 5s.

Complimenti! L'app è ora configurata per inviare dati a Google Analytics.

Passaggi successivi

Con Google Analytics puoi fare molto di più, ad esempio misurare campagne, pagamenti e transazioni in-app ed eventi di interazione degli utenti.

Le seguenti guide per gli sviluppatori forniscono dettagli aggiuntivi su come implementare le funzionalità di Google Analytics nella tua app:

  • Misurazione degli eventi: scopri come misurare il coinvolgimento degli utenti con contenuti interattivi come pulsanti, video e altri contenuti multimediali utilizzando gli eventi.
  • Misurazione dei pagamenti in-app: scopri come misurare le transazioni e i pagamenti in-app.
  • Misurazione delle campagne: scopri come implementare la misurazione delle campagne per capire quali canali e campagne generano installazioni di app.
  • Tempi utente: scopri come misurare i tempi utente nella tua app per misurare i tempi di caricamento, il coinvolgimento con i contenuti multimediali e altro ancora.
  • Configurazione avanzata: scopri di più sulle opzioni di configurazione avanzate, compreso l'utilizzo di più tracker.
  • Parametri Analytics.xml: consulta l'elenco completo dei parametri di configurazione analytics.xml.