Suivi des événements : SDK Android

Ce guide du développeur explique comment mesurer les événements dans votre application à l'aide du SDK Google Analytics pour Android v3.

Présentation

Les événements constituent un moyen utile de collecter des données sur l'interaction d'un utilisateur avec les composants interactifs de votre application, comme les appuis sur les boutons ou l'utilisation d'un élément particulier dans un jeu.

Un événement se compose de quatre champs que vous pouvez utiliser pour décrire l'interaction d'un utilisateur avec le contenu de votre application:

Nom du champ Champ de suivi Type Obligatoire Description
Catégorie Fields.EVENT_CATEGORY String Oui Catégorie de l'événement
Action Fields.EVENT_ACTION String Oui Action de l'événement
Étiquette Fields.EVENT_LABEL String Non Libellé de l'événement
Valeur Fields.EVENT_VALUE Long Non Valeur de l'événement

Implémentation

Pour envoyer un événement à Google Analytics, utilisez MapBuilder.createEvent() et envoyez l'appel, comme dans cet exemple:

@Override
public void onClick(View v) {
  // May return null if a EasyTracker has not yet been initialized with a
  // property ID.
  EasyTracker easyTracker = EasyTracker.getInstance(this);

  // MapBuilder.createEvent().build() returns a Map of event fields and values
  // that are set and sent with the hit.
  easyTracker.send(MapBuilder
      .createEvent("ui_action",     // Event category (required)
                   "button_press",  // Event action (required)
                   "play_button",   // Event label
                   null)            // Event value
      .build()
  );
}