Tempi utente - SDK per Android

Importante: questo documento descrive una versione precedente dell'SDK. I nuovi utenti devono utilizzare l'SDK più recente.

Questa guida per gli sviluppatori descrive come misurare i tempi utente con l'SDK Google Analytics per Android v3.

Panoramica

La misurazione dei tempi utente fornisce un modo nativo per misurare un periodo di tempo in Google Analytics. Questo può essere utile, ad esempio, per misurare i tempi di caricamento delle risorse.

I Tempi utente hanno i seguenti campi:

Nome campo	Campo tracker	Tipo	Obbligatorio	Descrizione
Categoria	Fields.TIMING_CATEGORY	String	Sì	La categoria dell'evento a tempo
Valore	Fields.TIMING_VALUE	long	Sì	La misurazione dei tempi in millisecondi
Nome	Fields.TIMING_VAR	String	Sì	Il nome dell'evento a tempo
Etichetta	Fields.TIMING_LABEL	String	No	L'etichetta dell'evento a tempo

I dati relativi al tempo utente sono disponibili principalmente nel report Tempi utenti velocità applicazione.

Implementazione

Per inviare un timestamp utente a Google Analytics, crea un hit di tempo utilizzando MapBuilder.createTiming(), poi invialo utilizzando send():

/*
 * Called after a list of high scores finishes loading.
 *
 * @param loadTime The time it takes, in milliseconds, to load a resource.
 */
public void onLoad(long loadTime) {

  // May return null if EasyTracker has not been initialized with a property
  // ID.
  Tracker easyTracker = EasyTracker.getInstance(this);

  easyTracker.send(MapBuilder
      .createTiming("resources",    // Timing category (required)
                    loadTime,       // Timing interval in milliseconds (required)
                    "high scores",  // Timing name
                    null)           // Timing label
      .build()
  );
}