SDK Google Analytics per Android v2 (legacy) - Panoramica

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

Introduzione

L'SDK di 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 stanno utilizzando le applicazioni.
  • In 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 fornendo visibilità end-to-end sul rendimento dei tuoi canali di marketing, dalle installazioni su Google Play agli acquisti in-app e alle transazioni.

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 necessari tre passaggi:

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

Una volta completati questi passaggi, sarai in grado di misurare i seguenti aspetti con Google Analytics:

  • Installazioni di app
  • Utenti e dati demografici attivi
  • 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 ciascuno 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 poter chiamare i suoi metodi. Nell'esempio precedente, questa riga:

EasyTracker.getInstance.activityStart(this);

si occupa di definire il contesto. Tuttavia, se devi effettuare chiamate EasyTracker in altri metodi o classi, 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 l'ID monitoraggio. L'esempio riportato di seguito mostra come aggiungere l'ID monitoraggio e attivare la misurazione di 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 controllo lint potrebbe avvisarti dell'utilizzo del trattino ("-") nell'ID di 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, incluso l'uso 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 i pagamenti e le transazioni in-app.
  • Tempi utenti: 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.