Sessions – SDK Android

Important: Ce document décrit une ancienne version du SDK. Les nouveaux utilisateurs doivent utiliser la dernière version du SDK.

Ce document offre une vue d'ensemble des sessions concernant le SDK Google Analytics pour Android v3.

Présentation

Une session représente une seule période d'interaction utilisateur avec votre application. Les sessions servent de conteneurs utiles pour mesurer l'activité, y compris les visionnages de l'écran, les événements et les transactions e-commerce.

Gérer les sessions

Par défaut, Google Analytics regroupe les appels reçus dans un délai de 30 minutes au cours d'une même session. Cette période peut être configurée au niveau de la propriété. Découvrez comment configurer le délai avant expiration de la session.

Gestion manuelle des sessions

Pour démarrer ou arrêter manuellement une session, définissez le paramètre de contrôle de session dans la carte que vous transmettez à la méthode d'envoi du traceur.

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

Gestion automatique des sessions (EasyTracker)

EasyTracker peut démarrer automatiquement de nouvelles sessions lorsque les utilisateurs ont placé votre application en arrière-plan pendant un certain temps. Ce délai avant expiration de la session est défini par le paramètre ga_sessionTimeout de votre fichier analytics.xml.

<!-- analytics.xml -->

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