Temps utilisateur – SDK Android

Ce guide du développeur explique comment mesurer les temps utilisateur avec le SDK Google Analytics pour Android v3.

Présentation

Mesurer le temps utilisateur est un moyen natif de mesurer une période dans Google Analytics. Cela peut être utile pour mesurer les temps de chargement des ressources, par exemple.

Les temps utilisateur comportent les champs suivants:

Nom du champ	Champ de suivi	Type	Obligatoire	Description
Catégorie	`Fields.TIMING_CATEGORY`	`String`	Oui	Catégorie de l'événement programmé
Valeur	`Fields.TIMING_VALUE`	`long`	Oui	Mesure de la durée en millisecondes
Nom	`Fields.TIMING_VAR`	`String`	Oui	Nom de l'événement programmé
Étiquette	`Fields.TIMING_LABEL`	`String`	Non	Libellé de l'événement programmé

Ces données se trouvent principalement dans le rapport "Vitesse de l'application" sur le temps utilisateur.

Implémentation

Pour envoyer un temps utilisateur à Google Analytics, créez un appel de durée à l'aide de MapBuilder.createTiming(), puis envoyez-le à l'aide de send():.

/*
 * Called after a list of high scores finishes loading.
 *
 * @param loadTime The time it takes, in milliseconds, to load a resource.
 */
public void onLoad(long loadTime) {

  // May return null if EasyTracker has not been initialized with a property
  // ID.
  Tracker easyTracker = EasyTracker.getInstance(this);

  easyTracker.send(MapBuilder
      .createTiming("resources",    // Timing category (required)
                    loadTime,       // Timing interval in milliseconds (required)
                    "high scores",  // Timing name
                    null)           // Timing label
      .build()
  );
}