SDK Google Analytics per Android v3 (legacy) - Guida introduttiva

Questo documento descrive come iniziare a utilizzare l'SDK 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 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:

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 le risorse definite in XML. Crea un file denominato analytics.xml nella directory res/values del tuo progetto e aggiungi le seguenti risorse:

<?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 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, potresti modificare il periodo di invio per verificare che gli hit vengano inviati correttamente. Ad esempio, se vuoi visualizzare i dati in tempo reale, ti consigliamo di impostarlo su un valore basso, come 5 s.

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 ulteriori dettagli sull'implementazione delle 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 i pagamenti e le transazioni in-app.
  • Misurazione delle campagne: scopri come implementare la misurazione delle campagne per capire quali canali e campagne generano installazioni di 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.
  • Configurazione avanzata: scopri di più sulle opzioni di configurazione avanzate, incluso l'uso di più tracker.
  • Parametri Analytics.xml: consulta l'elenco completo dei parametri di configurazione analytics.xml.