Portfolio : réalisation d’analyses inter-projets dans Amplitude

  • Mise à jour

Cet article vous aidera à :

  • visualiser et comprendre le comportement de vos utilisateurs au sein de plusieurs produits ;
  • rapprocher les utilisateurs ayant plusieurs identifiants d’utilisateur au sein de vos produits.

Grâce au module complémentaire Portfolio d’Amplitude, vous pouvez facilement générer une vision globale des interactions de vos utilisateurs avec l’ensemble de votre portefeuille de produits. Si vous avez instrumenté plusieurs plateformes ou gammes de produits, Portfolio peut vous offrir une vue sans pareille du parcours complet de vos utilisateurs.

REMARQUE : cette fonctionnalité est disponible pour les clients disposant des plans Growth et Entreprise qui ont fait l’acquisition du module complémentaire Portfolio. Par ailleurs, vous devez être sûr(e) de comprendre le fonctionnement des paramètres de projet dans Amplitude avant de commencer.

Fonctionnement

La capacité de Portfolio à créer des analyses inter-produits repose sur les vues. Les vues sont des recueils de projets ou de sources de données Amplitude qui regroupent les événements de chaque projet au sein du même affichage. Une vue peut être un recueil d’une ou plusieurs sources de données, chacune vous permettant d’analyser les utilisateurs associés à plusieurs projets à la fois. 

REMARQUE :les vues ne peuvent pas ingérer de données elles-mêmes, mais vous pouvez les modifier et les mettre à jour à tout moment. 

Portfolio examine vos utilisateurs sur l’ensemble de votre organisation, au lieu de les cloisonner en fonction de projets individuels. Amplitude part du principe que s’il détecte les mêmes ID d’utilisateur (ou ID d’appareil) dans différents projets, ces ID sont rattachés au même utilisateur.

Cependant, les propriétés d’utilisateur sont cloisonnées par projet : les propriétés d’utilisateur sur les événements déclenchés dans un projet donné seront les valeurs de propriété d’utilisateur pour ce projet, et uniquement ce projet. Par exemple, imaginons que vous ayez deux projets : un pour iOS, et un pour Android. L’utilisateur example@amplitude.com a une propriété utilisateur appelée Version , avec une valeur de 1.0 dans le projet iOS et une valeur de 2.0 dans le projet Android. Dans ce cas, les événements déclenchés par cet utilisateur dans le projet iOS auront une valeur de Version définie sur 1.0, tandis que les événements déclenchés dans le projet Android auront une valeur de Version définie sur 2.0.

REMARQUE : si un type d’événement porte le même nom sur plusieurs projets, il sera considéré comme le même événement dans la liste déroulante.

Création d’une vue Portfolio

Les administrateurs et les responsables d’une organisation peuvent accéder à une vue Portfolio et en créer une en accédant à Settings —> Projects  —> Create Portfolio View. Une boîte de dialogue apparaît alors ; dans celle-ci, vous pouvez nommer la vue Portfolio et définir les autorisations des utilisateurs.

À ce stade, vous pouvez connecter plusieurs projets à cette vue inter-projets. Cliquez sur Update Source Projects pour sélectionner les projets qui doivent être rassemblés au sein d’une seule et même vue.

Mappage d’utilisateurs (création d’alias)

Il n’est pas rare que les ID d’utilisateur d’un même utilisateur diffèrent d’un projet à l’autre au sein d’une même organisation. Le point de terminaison d’API User Mapping vous permet de fusionner deux utilisateurs qui seraient autrement suivis par des ID d’utilisateur différents dans Amplitude. Notez que cette tâche ne peut pas être accomplie via l’interface utilisateur : il n’est possible de la réaliser que sous forme d’un appel d’API.

Dans l’exemple ci-dessous, trois enregistrements d’utilisateur, chacun avec un ID d’utilisateur différent, sont tous fusionnés au sein de l’ID d’utilisateur mike@hooli.com . Ce nouvel ID d’utilisateur sera l’ID d’utilisateur « global » de cet utilisateur dans la vue inter-projets. De cette façon, vous pouvez obtenir un décompte précis du nombre d’utilisateurs uniques dans l’ensemble de votre portefeuille de produits.

 

 

Lorsque les utilisateurs sont mappés, les propriétés d’utilisateur ne sont pas fusionnées. Cela signifie que les propriétés d’utilisateur rattachées à chaque événement seront celles de l’utilisateur d’origine qui a déclenché l’événement en premier lieu.

Vous pouvez accéder au point de terminaison d’API actuel en envoyant une requête POST ou GET à https://api.amplitude.com/usermap, avec ces deux paramètres de requête :

  • api_key : une clé d’API relative à n’importe quel projet (source de données) de votre organisation.
  • mapping : soit un objet de mappage JSON individuel, soit un tableau d’objets JSON représentant chacun un mappage individuel.

Un alias de mappage doit disposer d’une clé user_id. Si unmap est défini sur True , alors il ne peut pas y avoir de global_user_id . Sinon, un global_user_id doit être présent :

  • user_id (chaîne) : obligatoire. C’est un UUID (ID d’utilisateur unique) que vous spécifiez. Il s’agit de l’utilisateur qui sera mappé. Notez qu’un seul user_id peut être mappé à la fois.
  • global_user_id (chaîne) : obligatoire sauf si unmap a pour valeur true. C’est un UUID (ID d’utilisateur unique) que vous spécifiez. Il devrait s’agir de l’ID unifié auquel l’autre user_id est mappé.
  • unmap (booléen) : si sa valeur est true, le mappage actuel pour user_id sera supprimé.

Exemple de mappage d’utilisateur

curl --data 'api_key=VOTRE_CLÉ_API' --data mapping='[{"user_id":"63629@hmail.com", "global_user_id": "mike@hooli.com"}]' https://api.amplitude.com/usermap

Ici, l’utilisateur 63629@hmail.com sera fusionné au sein de mike@hooli.com .

Exemple de démappage d’utilisateur

curl --data 'api_key=VOTRE_CLÉ_API' --data mapping='[{"user_id":"63629@hmail.com", "unmap": true}]' https://api.amplitude.com/usermap

Ici l’utilisateur 63629@hmail.com sera dissocié de l’utilisateur canonique (précédemment défini comme mike@hooli.com ).