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.
Voici les principaux sujets abordés:
- Pourquoi partager des appareils avec Google Home ?
- Phases clés du flux de partage
- Implémentation technique
- Bonnes pratiques en matière d'expérience utilisateur
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 | API Home pour les autorisations | 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 de mise en service | 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.
Appelez l'API Permissions.
Appelez l'API de mise en service Google sur chaque appareil Matter précédemment mis en service sur un autre fabric.
- Étant donné que le partage Matter doit être effectué individuellement pour chaque appareil et que de nombreux écrans nécessitent 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.
- Étant donné que le partage Matter doit être effectué individuellement pour chaque appareil et que de nombreux écrans nécessitent une saisie 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 à cloud.
Utilisez des liens profonds Cloud-to-cloud. Les appareils sont alors ajoutés au Graphe Google Home.
- 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.
Appelez l'API Permissions.
Vous fabriquez des appareils cloud à cloud et Matter.
Utilisez des liens profonds Cloud-to-cloud.
- 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.
Appelez l'API Permissions.
Appelez l'API de mise en service Google sur chaque appareil Matter précédemment mis en service sur un autre fabric.
- Étant donné que le partage Matter doit être effectué individuellement pour chaque appareil et que de nombreux écrans nécessitent 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.
- Étant donné que le partage Matter doit être effectué individuellement pour chaque appareil et que de nombreux écrans nécessitent une saisie 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 en matière d'expérience utilisateur
Cette section contient des parcours utilisateur critiques à 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 à vos utilisateurs et de leur faire découvrir son expérience de partage.
Ces éléments ne sont pas non plus mutuellement exclusifs, et il existe plusieurs points d'entrée:
Dans un menu "Paramètres"
É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 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 la suite, puis passer rapidement par 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 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 de l'application (via l'API Permissions) font partie du même parcours d'expérience utilisateur.
Logique de partage
Voici quelques suggestions concernant les requêtes des utilisateurs:
En règle générale, vous ne devez demander aux utilisateurs de suivre que les étapes manquantes requises pour intégrer 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 accorder à l'application l'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
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 à 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.
L'inclinaison 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 faites pas de promesses exagérées.
- 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 toucher. Ne la gâchez pas.
Bonnes pratiques
- Commencez par le point de vue de l'utilisateur, en vous posant la question "Qu'est-ce que j'y gagne ?".
- 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. Toutefois, 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 si cela correspond à votre stratégie globale.
- Utilisez des phrases incitatives telles que "Commencer".