Ce guide du développeur explique comment implémenter le User-ID à l'aide du SDK Google Analytics v4 pour Android.
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.
Ce guide explique comment utiliser le champ userId
et le SDK Google Analytics pour Android afin d'envoyer des ID utilisateur à Google Analytics.
Avant de commencer
Avant de commencer l'implémentation, les développeurs doivent procéder comme suit:
- Activer le User-ID pour l'une de vos vues (profils) (centre d'aide)
- Consultez les Règles relatives au User-ID.
- Découvrez comment fonctionne le User-ID en consultant la documentation de référence sur sa fonctionnalité.
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
sur l'outil de suivi à l'aide de la syntaxe esperluette du protocole de mesure et du nom du paramètre &uid
, comme dans cet exemple:
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); // 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("&uid", user.getId()); // This hit will be sent with the User ID value and be visible in // User-ID-enabled views (profiles). t.send(new HitBuilders.EventBuilder() .setCategory("UX") .setAction("User Sign In") .build());