Sessioni

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

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

Puoi avviare manualmente una nuova sessione quando invii un hit a Google Analytics utilizzando il metodo setNewSession. L'esempio seguente mostra come avviare una nuova sessione quando si invia una visualizzazione di schermata:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);

// Set screen name.
t.setScreenName(screenName);

// Start a new session with the hit.
t.send(new HitBuilders.ScreenViewBuilder()
    .setNewSession()
    .build());

Per maggiori dettagli sul metodo getTracker, consulta Configurazione avanzata.

Gestione automatica delle sessioni

Puoi configurare Google Analytics in modo che avvii automaticamente nuove sessioni quando gli utenti hanno posizionato la tua app in background per un determinato periodo di tempo. Questo periodo di timeout della sessione è definito in secondi dal parametro ga_sessionTimeout nel file xml del tracker.

<resources>
  <integer name="ga_sessionTimeout">300</integer>
</resources>

Per impostare in modo programmatico il timeout di sessione:

t.setSessionTimeout(300L);