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);