Ce guide fournit des conseils d'expérience utilisateur pour concevoir des autorisations d'appareil et un partage 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 ?
- Principales phases du flux de partage
- Implémentation technique
- Bonnes pratiques d'UX
Pourquoi partager des appareils avec Google Home ?
Pour profiter des fonctionnalités offertes par les API Home, les utilisateurs doivent partager leurs appareils avec Google Home pour les raisons suivantes :
- 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 afin d'éviter de créer une expérience utilisateur fragmentée et déroutante, où 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-to-cloud pour l'association de comptes | Vous 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, nous vous recommandons d'utiliser la fonctionnalité de lien profond (disponible sur Android et iOS) qui redirige directement les utilisateurs vers votre page d'association de compte spécifique dans l'application Google Home. |
| API Commissioning sur Android | Mise en service 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 la structure Google aux appareils Matter qui ont déjà été mis en service sur une autre structure. 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'offrir une meilleure expérience globale aux utilisateurs.
Vous ne produisez que des appareils Matter
Vous fabriquez des appareils compatibles avec Matter que vous souhaitez mettre en service dans Google Home.
Appelez l'API Permissions sur Android.
Appelez l'API Commissioning sur Android sur chaque appareil Matter précédemment mis en service sur un autre fabric.
- Étant donné que le partage Matter doit être effectué pour chaque appareil individuellement et que de nombreux écrans nécessitent une saisie de l'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 Commissioning) en cliquant sur les appareils de cette liste.
- Retour à la liste des appareils Matter, affichage de la progression de la tâche et de l'état du partage pour l'utilisateur.
- Étant donné que le partage Matter doit être effectué pour chaque appareil individuellement et que de nombreux écrans nécessitent une saisie de l'utilisateur, nous vous recommandons de guider l'utilisateur tout au long de ce processus :
Vous ne produisez que des appareils partagés avec Google à l'aide d'API cloud-to-cloud
Effectuez une association de liens profondsCloud-to-cloud. Les appareils sont alors ajoutés au Google Home Graph.
- Nous vous recommandons d'effectuer d'abord l'association Cloud-to-cloud pour éviter les situations potentiellement déroutantes, par exemple lorsque l'utilisateur voit une liste contenant des appareils partagés avec Google et des appareils non partagés avec Google.
Appelez l'API Permissions sur Android.
Vous produisez des appareils cloud-to-cloud et Matter
Effectuez une association de liens profonds Cloud-to-cloud.
- Nous vous recommandons d'effectuer d'abord l'association Cloud-to-cloud pour éviter les situations potentiellement déroutantes, par exemple lorsque l'utilisateur voit une liste contenant des appareils partagés avec Google et des appareils non partagés avec Google.
Appelez l'API Permissions sur Android.
Appelez l'API Commissioning pour Android sur chaque appareil Matter précédemment mis en service sur un autre fabric.
- Étant donné que le partage Matter doit être effectué pour chaque appareil individuellement et que de nombreux écrans nécessitent une saisie de l'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 Commissioning) en cliquant sur les appareils de cette liste.
- Retour à la liste des appareils Matter, affichage de la progression de la tâche et de l'état du partage pour l'utilisateur.
- Étant donné que le partage Matter doit être effectué pour chaque appareil individuellement et que de nombreux écrans nécessitent une saisie de l'utilisateur, nous vous recommandons de guider l'utilisateur tout au long de ce processus :
Vous n'avez aucun appareil à partager avec Google
Appelez l'API Permissions.
Bonnes pratiques concernant l'expérience utilisateur
Cette section contient des parcours utilisateur critiques à prendre en compte lors du développement d'une application exploitant les API Home.
Où présenter 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 proposer une expérience de partage à vos utilisateurs au bon moment.
Ces options ne s'excluent pas mutuellement, et il existe plusieurs points d'entrée :
Depuis un menu "Paramètres"
Les utilisateurs étant 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 à utiliser ce paradigme.
Vous pouvez séparer le partage d'appareils (association Cloud-to-cloud et API de mise en service Matter) des autorisations de l'application (API Permissions). Les utilisateurs peuvent ainsi contrôler les étapes qu'ils effectuent, et vous pouvez leur afficher l'état de la connexion.
Lorsque vous utilisez des appareils dans des automatisations exécutées par Google
Dans l'onglet "Automatisations", les utilisateurs peuvent appuyer sur un point d'entrée du flux de partage, lire un écran de proposition de valeur qui explique clairement les avantages de continuer, puis parcourir rapidement le flux d'autorisations.
À partir de la mise en service uniquement
Ce scénario s'adresse principalement aux partenaires qui ne produisent que des appareils Matter (pas d'appareils Cloud-to-cloud) et qui ne disposent pas de leur propre structure Matter. Le point d'entrée de l'utilisateur peut se trouver juste après un écran de type prêt à l'emploi, où le partage d'appareils Matter (via l'API Commissioning) et l'autorisation de l'application (via l'API Permissions) font partie du même flux d'expérience utilisateur.
Logique de partage
Voici quelques suggestions de prompts utilisateur :
En règle générale, vous ne devez inviter les utilisateurs à n'effectuer que les étapes manquantes requises pour l'intégration à la plate-forme. Par exemple, les clients de longue date partagent peut-être déjà les appareils d'un OEM avec Google. Dans ce cas, ils n'ont qu'à suivre le processus d'octroi d'autorisations des API Home pour autoriser l'application à accéder à leur Google Home.
Plusieurs administrateurs Google Home peuvent partager une structure de maison Google Home, et dans certains cas, un seul compte peut être utilisé pour partager des appareils avec Google. Par conséquent, l'association de Cloud-to-cloud ne doit pas être une condition préalable pour demander les autorisations des API Home.
Suggestions de conception visuelle
Un avantage clair de l'intégration à Google Home (par exemple, "Créez des automatisations avancées optimisées par Google Home" ou "Contrôlez vos 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 progresse dans les écrans.
Pour Matter en particulier, 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 structure, puis inviter l'utilisateur à l'ajouter à la structure Google.
Suggestions de contenus
Les utilisateurs font plus facilement confiance à ce qu'ils comprennent et qui leur apporte de la valeur. Donnez aux utilisateurs les moyens de prendre des décisions éclairées, y compris des compromis, en leur fournissant des informations.
Le pitch critique
Les utilisateurs ne continueront pas à partager leurs appareils s'ils n'y voient pas un intérêt évident.
- Portez une attention particulière à la façon dont vous positionnez l'offre.
- Rendez-le attrayant, mais ne promettez pas trop.
- Si l'utilisateur a besoin d'un appareil mentionné dans votre argumentaire, assurez-vous que cela est clairement indiqué afin qu'il ne rencontre pas d'obstacle inattendu.
- Vous n'aurez peut-être qu'une seule occasion de capter l'attention de ces utilisateurs, alors ne la gâchez pas.
Bonnes pratiques
- Commencez par adopter le point de vue de l'utilisateur : "Qu'est-ce que j'y gagne ?".
- N'écrivez pas plus de quatre lignes de contenu dans un bloc de section. Un texte plus long pourrait faire perdre l'attention de l'utilisateur. Cependant, la clarté et la compréhension peuvent être plus importantes que la concision.
- Les automatisations sont amusantes ! Choisissez un exemple intéressant, mais utile, si l'espace le permet.
- Essayez d'adopter un ton ludique s'il correspond à votre stratégie globale.
- Utilisez des expressions incitant à l'action, telles que "Commencer".