SDK Google Analytics per Android v2 (legacy) - Panoramica

L'SDK di Google Analytics per Android consente agli sviluppatori di raccogliere facilmente i dati sul coinvolgimento degli utenti dalle loro app. Questo documento fornisce una panoramica del valore dell'SDK, nonché una guida per iniziare a misurare la tua 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 usare i report di Google Analytics per misurare:

  • Il numero di utenti attivi che utilizzano le loro applicazioni.
  • Da quale parte del mondo viene utilizzata l'applicazione.
  • Adozione e utilizzo di funzionalità specifiche.
  • Transazioni e acquisti in-app.
  • Il numero e il tipo di arresti anomali dell'applicazione.
  • e molte altre metriche utili.

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

Prima di iniziare

Prima di iniziare a 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:

/**
 * 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 per poter chiamare i suoi metodi. Nell'esempio precedente, la seguente riga: 

EasyTracker.getInstance.activityStart(this);

si occupa di definire il contesto. Tuttavia, se devi effettuare chiamate EasyTracker in altre classi 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 Google Analytics per Android, le opzioni di configurazione sono gestite da un file di risorse XML, denominato analytics.xml in questa guida. Devi creare questo file nella directory res/values del progetto e aggiungere il tuo ID monitoraggio. Il seguente esempio mostra come aggiungere l'ID monitoraggio e attivare la misurazione di Activity e delle 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 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.

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. Consulta le seguenti guide per gli sviluppatori per scoprire come aggiungere queste funzionalità all'implementazione:

  • Configurazione avanzata: scopri di più sulle opzioni di configurazione avanzate, compreso 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.
  • Misurazione dei pagamenti in-app: scopri come misurare le transazioni e i pagamenti in-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.
  • Parametri Analytics.xml: consulta l'elenco completo dei parametri di configurazione analytics.xml.