Sessions

Ce document fournit une vue d'ensemble des sessions en lien avec le SDK Google Analytics v4 pour Android.

Présentation

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

Gestion des sessions

Par défaut, Google Analytics regroupe dans la même session les appels reçus à moins de 30 minutes les uns des autres. Cette période peut être configurée au niveau de la propriété. Découvrez comment configurer ce délai d'expiration.

Gestion manuelle des sessions

Vous pouvez démarrer manuellement une nouvelle session lorsque vous envoyez un appel à Google Analytics à l'aide de la méthode setNewSession. L'exemple suivant montre comment démarrer une nouvelle session lorsque vous envoyez un visionnage de l'écran:

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

Pour en savoir plus sur la méthode getTracker, consultez la section Configuration avancée.

Gestion automatique des sessions

Vous pouvez configurer Google Analytics de sorte que les nouvelles sessions démarrent automatiquement 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 en secondes par le paramètre ga_sessionTimeout dans le fichier xml du coach électronique.

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

Pour définir automatiquement le délai avant expiration de la session:

t.setSessionTimeout(300L);