Flux d'intégration des utilisateurs finaux sur Android

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

Les principaux sujets abordés sont les suivants :

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, 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). L'ordre dans lequel cette étape est effectuée dépend toutefois du scénario du développeur et est inclus dans la mise en œuvre technique.
Liaison cloud à cloud Cloud à cloud pour la liaison de comptes Vous permet de lancer le processus de liaison de comptes 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 de liaison de comptes spécifique dans GHA.
API Commissioning sur Android Commissioning Matter Bien qu'elle soit généralement considérée comme une API pour mettre en service de nouveaux Matter appareils, vous pouvez également l'utiliser pour ajouter le fabric Google aux Matter appareils qui ont déjà été mis en service sur un autre fabric. Il s'agit donc d'un outil utile pour le processus d'intégration.

Mise en œuvre technique

La façon 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 produisez des appareils compatibles avec Matter que vous souhaitez mettre en service sur Google Home.

  1. Appelez l'API Permissions sur Android.

  2. Appelez l' API Commissioning sur Android sur chaque appareil Matter précédemment mis en service sur un autre fabric.

    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 de l'utilisateur, nous vous recommandons de guider l'utilisateur tout au long de ce processus en :
      • fournissant aux utilisateurs une liste des appareils Matter qui ne sont pas partagés avec Google ;
      • permettant aux utilisateurs de lancer le processus de partage d'appareils (à l'aide de l'API Commissioning) en cliquant sur les appareils de cette liste ;
      • revenant à la liste des appareils Matter, en 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 des API cloud à cloud

  1. Effectuez Cloud-to-cloud une liaison profonde. Cela ajoute les appareils au graphique Google Home.

    1. Nous vous recommandons d'effectuer d'abord la liaison Cloud-to-cloud pour éviter des situations potentiellement déroutantes, comme l'affichage d'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 produisez des appareils cloud à cloud et Matter

  1. Effectuez Cloud-to-cloud une liaison profonde.

    1. Nous vous recommandons d'effectuer d'abord la liaison Cloud-to-cloud pour éviter des situations potentiellement déroutantes, comme l'affichage d'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 Commissioning pour Android sur chaque Matter appareil précédemment mis en service sur un autre fabric.

    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 de l'utilisateur, nous vous recommandons de guider l'utilisateur tout au long de ce processus en :
      • fournissant aux utilisateurs une liste des appareils Matter qui ne sont pas partagés avec Google ;
      • permettant aux utilisateurs de lancer le processus de partage d'appareils (à l'aide de l'API Commissioning) en cliquant sur les appareils de cette liste ;
      • revenant à la liste des appareils Matter, en 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 quelques parcours utilisateur essentiels à prendre en compte lors du développement d'une application utilisant les API Home.

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

Cette liste n'est pas exhaustive. Vous pouvez trouver d'autres occasions de proposer une présentation et une expérience de partage Google Home opportunes à vos utilisateurs.

Ces points d'entrée ne s'excluent pas mutuellement et sont multiples :

Depuis un menu "Paramètres"

Menu "Paramètres" comme point d'entrée
Figure 1. Menu "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 à l'aide d'un menu "Paramètres", cette méthode leur permet de continuer avec ce paradigme.

Vous pouvez séparer le partage d'appareils (Cloud-to-cloud liaison et l' Matter API Commissioning) de l'autorisation d'application (API Permissions). Cela permet aux utilisateurs de contrôler les étapes qu'ils effectuent et vous donne la possibilité d'afficher l'état de la connexion à l'utilisateur.

Lors de l'utilisation d'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 poursuite, puis passer rapidement par le flux d'autorisations.

Point d'entrée d'une automatisation gérée par Google
Figure 2. Point d'entrée à partir d'une automatisation gérée par Google

À 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 Matter fabric. Le point d'entrée pour 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 d'application (via l'API Permissions) font partie du même flux d'expérience utilisateur.

Point d'entrée depuis 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 inviter les utilisateurs à effectuer 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 le processus d'octroi d'autorisations des API Home pour donner à 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, la liaison Cloud-to-cloud ne doit pas être une condition préalable à l'invitation à demander des autorisations pour les API Home.

Suggestions de conception visuelle

Idées concernant la conception visuelle
Figure 4. Idées concernant la 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 les appareils à l'aide des applications de votre choix").

  • Un appel à 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 lorsque l'utilisateur passera d'un écran à l'autre.

  • 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 Matter appareil à votre fabric, puis inviter l'utilisateur à ajouter cet appareil au fabric Google.

Suggestions de contenus

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

La présentation essentielle

Les utilisateurs ne continueront pas à partager des appareils s'il n'existe pas de proposition de valeur forte.

  • Portez une attention particulière à la façon dont vous positionnez l'offre.
  • Rendez-la attrayante, mais ne promettez pas trop.
  • Si l'utilisateur a besoin d'un appareil mentionné dans votre présentation, 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 captiver ces utilisateurs. Alors, faites en sorte que cela compte.

Bonnes pratiques

  1. Commencez par le point de vue de l'utilisateur : l'approche "Qu'est-ce que j'y gagne ?".
  2. N'écrivez pas plus de quatre lignes de contenu dans un bloc de section. Plus de mots peuvent détourner l'attention de l'utilisateur. Toutefois, 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 enjoué si cela correspond à votre stratégie globale.
  5. Utilisez des expressions concrètes telles que "Commencer".