Suivi des événements

Ce guide du développeur explique comment utiliser le SDK Google Analytics v4 pour Android afin de mesurer les événements dans votre application.

Présentation

Les événements sont un moyen utile de collecter des données sur les interactions d'un utilisateur avec les composants interactifs de votre application, tels que les pressions sur les boutons ou l'utilisation d'un élément particulier dans un jeu.

Un événement comprend quatre champs qui vous permettent de décrire l'interaction d'un utilisateur avec le contenu de votre application:

Nom du champ Type Obligatoire Description
Catégorie String Oui Catégorie de l'événement
Action String Oui Action de l'événement
Libellé String Non Libellé de l'événement
Value Long Non Valeur de l'événement

Implémentation

Pour envoyer un événement à Google Analytics, utilisez HitBuilders.EventBuilder et envoyez l'appel, comme indiqué dans cet exemple:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
// Build and send an Event.
t.send(new HitBuilders.EventBuilder()
    .setCategory(getString(categoryId))
    .setAction(getString(actionId))
    .setLabel(getString(labelId))
    .build());

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

Événements indépendants de toute interaction

Dans certains cas, vous pouvez envoyer un événement en tant qu'événement de non-interaction. Pour ce faire, transmettez true à setNonInteraction :

t.send(new HitBuilders.EventBuilder()
    .setCategory(getString(categoryId))
    .setAction(getString(actionId))
    .setNonInteraction(true)
    .build());

Pour en savoir plus sur les appels hors interaction et à quel moment les utiliser, consultez la page Événements liés aux non-interactions dans le centre d'aide Analytics.