User-ID – SDK Android

Ce guide du développeur explique comment implémenter le User-ID à l'aide du SDK Google Analytics pour Android v3.x.

Présentation

La fonctionnalité User-ID permet de mesurer les activités des utilisateurs sur plusieurs appareils dans Google Analytics. Par exemple, elle permet d'attribuer une interaction avec une campagne marketing sur un appareil mobile à une conversion effectuée sur un autre appareil mobile ou dans le navigateur.

Lorsque des User-ID sont envoyés avec les appels Google Analytics utilisant le champ userId, vos rapports indiquent un nombre plus précis d'utilisateurs uniques et proposent de nouvelles options de création de rapports multi-appareils. En savoir plus sur les avantages de l'utilisation du User-ID

Ce guide explique comment envoyer des ID utilisateur à Google Analytics à l'aide du champ userId et du SDK Google Analytics pour Android.

Prérequis

Avant d'envoyer le User-ID à Google Analytics:

Implémentation

Lorsqu'un utilisateur est connu de votre application Android, vous devez envoyer un ID qui le représente à tous vos appels Google Analytics (tels que les pages vues, les événements, les transactions e-commerce, etc.) à l'aide du champ userId.

Pour envoyer l'ID utilisateur, définissez le champ userId à l'aide de la syntaxe de l'esperluette du protocole de mesure et du nom du paramètre Fields.USER_ID, comme dans cet exemple:

/**
 * An example method called when a user signs in to an authentication system.
 *
 * @param User user represents a generic User object returned by an authentication system on sign in.
 */
public void onUserSignIn(User user) {

  Tracker t = GoogleAnalytics.getInstance(context).getTracker("UA-XXXX-Y");

  // You only need to set User ID on a tracker once. By setting it on the tracker, the ID will be
  // sent with all subsequent hits.
  t.set(Fields.USER_ID, user.getId());

  // This hit will be sent with the User ID value and be visible in User-ID-enabled views (profiles).
  t.send(MapBuilder
      .createEvent("UX",       // Event category (required)
                   "Sign In",  // Event action (required)
                   null,       // Event label
                   null)       // Event value
      .build()
  );
}