Sessions

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

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.

Gestion des 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

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 lors de l'envoi d'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 pour qu'il démarre 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 en secondes par le paramètre ga_sessionTimeout dans le fichier xml de l'outil de suivi.

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

Pour programmer le délai avant expiration de la session, procédez comme suit:

t.setSessionTimeout(300L);