Ce guide du développeur explique comment implémenter le User-ID à l'aide du SDK Google Analytics pour iOS 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 iOS.
Prérequis
Avant d'envoyer le User-ID à Google Analytics:
- Configurez la fonctionnalité User-ID.
- Consultez les Règles relatives à la fonctionnalité User-ID.
- Découvrez le fonctionnement de la fonctionnalité User-ID en consultant la documentation de référence sur sa fonctionnalité.
Implémentation
Lorsqu'un utilisateur est connu dans votre application iOS, 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 kGAIUserId
, comme dans cet exemple:
/** * An example method called when a user signs in to an authentication system. * * @param user represents a generic User object returned by an authentication system on sign in. */ - void signInWithUser:(User *)user { id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker]; // 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. [tracker set:kGAIUserId value:user.id]; // This hit will be sent with the User ID value and be visible in User-ID-enabled views (profiles). [tracker send:[[GAIDictionaryBuilder createEventWithCategory:@"UX" // Event category (required) action:@"User Sign In" // Event action (required) label:nil // Event label value:nil] build]]; // Event value }
Cet exemple montre comment obtenir l'ID utilisateur:
NSString *userId = [tracker get:kGAIUserId];