Sessioni - SDK Android

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

Questo documento fornisce una panoramica generale delle sessioni in relazione all'SDK Google Analytics per Android v3.

Panoramica

Una sessione rappresenta un singolo periodo di interazione dell'utente con l'app. Le sessioni fungono da utili contenitori di attività misurate, tra cui visualizzazioni di schermata, eventi e transazioni e-commerce.

Gestione delle sessioni

Per impostazione predefinita, Google Analytics raggruppa nella stessa sessione gli hit ricevuti entro 30 minuti l'uno dall'altro. Questo periodo è configurabile a livello di proprietà. Scopri come configurare questo periodo di timeout della sessione.

Gestione manuale delle sessioni

Per avviare o terminare manualmente una sessione, imposta il parametro di controllo della sessione nella mappa che passi nel metodo di invio del tracker.

// May return null if a tracker has not yet been initialized.
Tracker tracker = GoogleAnalytics.getInstance(this).getDefaultTracker();

// Start a new session with an AppView hit.
MapBuilder builder = MapBuilder.createAppView();
builder.set(Fields.SESSION_CONTROL, "start");
tracker.set(Fields.SCREEN_NAME, "My Screen");
tracker.send(builder.build());

// There should be no need to end a session explicitly.  However, if you do
// need to indicate end of session with a hit, simply add the following line
// of code to add the parameter to the builder:
builder.set(Fields.SESSION_CONTROL, "end");

Gestione automatica delle sessioni (EasyTracker)

EasyTracker può avviare automaticamente nuove sessioni per te quando gli utenti hanno posizionato la tua app in background per un determinato periodo di tempo. Questo periodo di timeout della sessione è definito dal parametro ga_sessionTimeout nel file analytics.xml.

<!-- analytics.xml -->

<!-- Set a session timeout period of 30 seconds -->
<integer name="ga_sessionTimeout">30</integer>