Flux d'intégration des utilisateurs finaux sur Android

Ce guide fournit des conseils d'UX pour concevoir des autorisations et un partage d'appareils fluides avec les API Google Home pour l'expérience d'intégration dans votre application.

Les principaux sujets abordés ici sont les suivants:

Pourquoi partager des appareils avec Google Home ?

Pour profiter des fonctionnalités des API Home, les utilisateurs doivent partager leurs appareils avec Google Home, car:

  • Il s'agit d'une exigence technique pour que Google puisse utiliser ces appareils dans les automatisations.
  • Cela permet de maintenir une expérience Google Home cohérente et flexible.
    • Il est essentiel de s'assurer que les appareils sont présentés de manière cohérente dans les applications compatibles avec l'API Home pour éviter de créer une expérience utilisateur fragmentée et déroutante, dans laquelle les utilisateurs doivent passer d'une application à l'autre pour effectuer des tâches de base.

Composants clés du flux de partage

Composant Programme Description
API Permissions sur Android API Home pour les autorisations sur Android Invite les utilisateurs à accorder des autorisations à votre application. Avant d'utiliser l'une des API Home, votre application doit être autorisée à accéder aux appareils de la maison de l'utilisateur (appelée "structure" dans l'API). Toutefois, l'ordre dans lequel cette étape est effectuée dépend du scénario du développeur et est inclus dans la section Implémentation technique.
Association cloud à cloud Cloud à cloud pour l'association de comptes Permet de lancer le processus d'association de compte pour partager des appareils connectés au cloud avec Google Home depuis votre application. Pour réduire les frictions pour les utilisateurs, nous vous recommandons d'utiliser la fonctionnalité de lien profond (disponible sur Android et iOS) qui redirige les utilisateurs directement vers votre page d'association de compte spécifique dans GHA.
API Commissioning sur Android Mise en service de Matter Bien qu'elle soit généralement considérée comme une API permettant de mettre en service de nouveaux appareils Matter, vous pouvez également l'utiliser pour ajouter le fabric Google aux appareils Matter qui ont déjà été mis en service avec un autre fabric. Il s'agit donc d'un outil utile pour le processus d'intégration.

Implémentation technique

La manière dont vous créez les flux de partage dépend des appareils que vous prévoyez de partager avec Google.

Pour les scénarios suivants, nous vous recommandons de suivre les étapes dans l'ordre indiqué. Cela permet d'améliorer l'expérience utilisateur globale.

Vous ne fabriquez que des appareils Matter

Vous fabriquez des appareils compatibles avec Matter que vous souhaitez mettre en service avec Google Home.

  1. Appelez l'API Permissions sur Android.

  2. Appelez l'API de configuration sur Android sur chaque appareil Matter précédemment configuré sur un autre tissu.

    1. Étant donné que le partage Matter doit être effectué individuellement pour chaque appareil et qu'il existe de nombreux écrans nécessitant une saisie utilisateur, nous vous recommandons de guider l'utilisateur tout au long de ce processus :
      • Fournir aux utilisateurs une liste des appareils Matter qui ne sont pas partagés avec Google
      • Permettre aux utilisateurs de lancer le processus de partage d'appareils (à l'aide de l'API de mise en service) en cliquant sur les appareils de cette liste.
      • Retour à la liste des appareils Matter, affichant la progression de la tâche et l'état de partage à l'utilisateur.

Vous ne produisez que des appareils partagés avec Google à l'aide d'API cloud à cloud.

  1. Utilisez des liens profonds Cloud-to-cloud. Les appareils sont alors ajoutés au graphique Google Home.

    1. Nous vous recommandons d'effectuer d'abord l'association Cloud-to-cloud pour éviter les situations potentiellement confuses, par exemple lorsque l'utilisateur voit une liste contenant des appareils partagés avec Google et des appareils non partagés avec Google.
  2. Appelez l'API Permissions sur Android.

Vous fabriquez des appareils cloud à cloud et Matter.

  1. Utilisez des liens profonds Cloud-to-cloud.

    1. Nous vous recommandons d'effectuer d'abord l'association Cloud-to-cloud pour éviter les situations potentiellement confuses, par exemple lorsque l'utilisateur voit une liste contenant des appareils partagés avec Google et des appareils non partagés avec Google.
  2. Appelez l'API Permissions sur Android.

  3. Appelez l'API de configuration pour Android sur chaque appareil Matter précédemment configuré pour un autre tissu.

    1. Étant donné que le partage Matter doit être effectué individuellement pour chaque appareil et qu'il existe de nombreux écrans nécessitant une saisie utilisateur, nous vous recommandons de guider l'utilisateur tout au long de ce processus :
      • Fournir aux utilisateurs une liste des appareils Matter qui ne sont pas partagés avec Google
      • Permettre aux utilisateurs de lancer le processus de partage d'appareils (à l'aide de l'API de mise en service) en cliquant sur les appareils de cette liste.
      • Retour à la liste des appareils Matter, affichant la progression de la tâche et l'état de partage à l'utilisateur.

Vous n'avez aucun appareil à partager avec Google

Appelez l'API Permissions.

Bonnes pratiques en matière d'expérience utilisateur

Cette section contient certains critical user journeys (CUJ) à prendre en compte lors du développement d'une application utilisant les API Home.

Où introduire le partage d'appareil dans l'application

Cette liste n'est pas exhaustive. Vous trouverez peut-être d'autres occasions de présenter Google Home et de partager une expérience avec vos utilisateurs.

Ces éléments ne sont pas non plus mutuellement exclusifs, et il existe plusieurs points d'entrée:

Dans un menu "Paramètres"

Menu "Paramètres" comme point d'entrée
Figure 1. Menu des paramètres comme point d'entrée

Étant donné que les utilisateurs sont probablement habitués à configurer des connexions avec leurs écosystèmes Google Home via un menu de paramètres, cette méthode leur permet de continuer à suivre ce paradigme.

Vous pouvez séparer le partage d'appareils (association Cloud-to-cloud et API de mise en service Matter) de l'autorisation des applications (API Permissions). Cela permet aux utilisateurs de contrôler les étapes qu'ils effectuent et vous permet d'afficher l'état de la connexion à l'utilisateur.

Lorsque vous utilisez des appareils dans des automatisations exécutées par Google

Dans l'onglet "Automatisations", les utilisateurs pouvaient appuyer sur un point d'entrée du flux de partage, lire un écran de proposition de valeur qui explique clairement les avantages de la suite, puis passer rapidement par le flux d'autorisations.

Point d'entrée d'une automatisation Google
Figure 2. Point d'entrée d'une automatisation Google

À partir de la mise en service uniquement

Ce scénario s'applique principalement aux partenaires qui ne produisent que des appareils Matter (pas d'appareils Cloud-to-cloud) et qui ne disposent pas de leur propre fabric Matter. Le point d'entrée de l'utilisateur peut se trouver juste après un écran prêt à l'emploi, où le partage d'appareils Matter (via l'API de configuration) et l'autorisation des applications (via l'API Permissions) font partie du même flux d'expérience utilisateur.

Point d'entrée à partir de la mise en service uniquement
Figure 3. Point d'entrée à partir de la mise en service uniquement

Logique de partage

Voici quelques suggestions concernant les invites utilisateur:

  • En règle générale, vous ne devez demander aux utilisateurs de suivre que les étapes manquantes nécessaires à l'intégration à la plate-forme. Par exemple, les clients de longue date peuvent déjà partager les appareils d'un OEM avec Google. Dans ce cas, ils n'ont qu'à suivre la procédure d'octroi d'autorisations des API Home pour donner à l'application accès à leur Google Home.

  • Plusieurs administrateurs Google Home peuvent partager une structure Google Home. Dans certains cas, un seul compte peut être utilisé pour partager des appareils avec Google. Par conséquent, l'association Cloud-to-cloud ne doit pas être une condition préalable à l'invite d'autorisation des API Home.

Suggestions de conception visuelle

Idées sur la conception visuelle
Figure 4. Idées sur la conception visuelle
  • Un avantage clair de l'intégration à Google Home (par exemple, "Créer des automatisations avancées optimisées par Google Home" ou "Contrôler les appareils à l'aide des applications de votre choix").

  • Un incitation à l'action (par exemple, "Commencer") et un moyen d'annuler si l'utilisateur ne souhaite pas continuer.

  • Si l'espace le permet, une explication de ce qui se passera à mesure que l'utilisateur progressera dans les écrans.

  • Pour Matter spécifiquement, lorsque l'utilisateur vous a déjà accordé l'accès à sa maison via les API Home, vous pouvez lui permettre de partager les appareils de sa maison avec Google Home lors de la mise en service de nouveaux appareils. Par exemple, vous pouvez ajouter un appareil Matter à votre fabric, puis inviter l'utilisateur à l'ajouter au fabric Google.

Suggestions de contenus

Les utilisateurs font plus facilement confiance à quelque chose qu'ils comprennent et qui ajoute de la valeur. Donnez aux utilisateurs les moyens de prendre des décisions éclairées, y compris des compromis, en leur fournissant des informations.

Pente critique

Les utilisateurs ne poursuivront pas le processus de partage d'appareils s'ils n'ont pas de proposition de valeur forte pour le faire.

  • Portez une attention particulière à la façon dont vous positionnez l'offre.
  • Soyez attrayant, mais ne promettez pas trop.
  • Si l'utilisateur a besoin d'un appareil mentionné dans votre argumentaire, assurez-vous qu'il est clairement indiqué pour qu'il ne rencontre pas d'obstacle inattendu.
  • Vous n'aurez peut-être qu'une seule occasion de les attirer, alors faites-en bon usage.

Bonnes pratiques

  1. Commencez par le point de vue de l'utilisateur, en vous posant la question "Qu'est-ce que j'y gagne ?".
  2. N'écrivez pas plus de quatre lignes de contenu dans un bloc de section. Un nombre plus élevé de mots peut faire perdre l'attention de l'utilisateur. Cependant, la clarté et la compréhension peuvent être plus importantes que la concision.
  3. Les automatisations sont amusantes ! Choisissez un exemple intéressant, mais utile, si l'espace le permet.
  4. Essayez d'adopter un ton ludique si cela correspond à votre stratégie globale.
  5. Utilisez des phrases incitatives telles que "Commencer".