Questo documento descrive una versione precedente dell'SDK Android. Se non hai mai utilizzato Analyitcs, utilizza l'SDK più recente. Scopri di più

Google Analytics SDK for Android v2 (legacy) - Panoramica

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

L'SDK di Google Analytics per Android consente agli sviluppatori di raccogliere facilmente i dati sul coinvolgimento degli utenti dalle loro app. Questo documento fornirà una panoramica del valore dell'SDK e una guida per iniziare a misurare l'app utilizzando un singolo ID proprietà e EasyTracker.

Introduzione

L'SDK Google Analytics per Android consente agli sviluppatori di raccogliere facilmente i dati sul coinvolgimento degli utenti dalle loro app. Gli sviluppatori possono quindi utilizzare i report di Google Analytics per misurare:

  • Il numero di utenti attivi che utilizzano le loro applicazioni.
  • Da dove provengono le applicazioni.
  • Adozione e utilizzo di funzionalità specifiche.
  • Transazioni e acquisti in-app.
  • Il numero e il tipo di applicazione si arresta in modo anomalo.
  • E molte altre metriche utili.

Inoltre, l'SDK Google Analytics per Android ti offre gli strumenti per monitorare il successo delle campagne di marketing per dispositivi mobili offrendo visibilità end-to-end sul rendimento dei tuoi canali di marketing, dalle installazioni di Google Play agli acquisti in-app e alle transazioni.

Prima di iniziare

Prima di iniziare a implementare l'SDK, verifica quanto segue:

Per iniziare

Per iniziare a utilizzare l'SDK esistono tre passaggi:

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

Dopo aver completato questi passaggi, potrai 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 ognuno dei tuoi Activities come nell'esempio seguente:

/**
 * 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.
  }
}

Tieni presente che EasyTracker richiede Context prima di poterne chiamare i metodi. Nell'esempio precedente, questa riga:

EasyTracker.getInstance.activityStart(this);

si occupa di impostare il contesto. Tuttavia, se devi effettuare chiamate EasyTracker in altri corsi o metodi, devi prima chiamare il metodo setContext(Context ctx) di 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. Creazione del file analytics.xml

Nella versione 2 dell'SDK di Google Analytics per Android, le opzioni di configurazione vengono gestite da un file di risorse XML, denominato analytics.xml in questa guida. Dovrai creare questo file nella directory res/values del tuo progetto e aggiungere il tuo ID monitoraggio. L'esempio seguente mostra come aggiungere l'ID monitoraggio e attivare la misurazione tramite Activity ed eccezioni:

<?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 tuo strumento di controllo delle pelucchi potrebbe avvisarti dell'utilizzo del trattino ('-') nel tuo ID monitoraggio. Puoi evitare questo avviso aggiungendo ulteriori attributi al tuo 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 l'implementazione.

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

Passaggi successivi

Puoi fare molto di più con Google Analytics, ad esempio misurare campagne, pagamenti in-app e transazioni ed eventi di interazione degli utenti. Consulta le seguenti guide per sviluppatori per scoprire come aggiungere queste funzionalità alla tua implementazione:

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