Questa guida fornisce indicazioni sulla UX per la progettazione di autorizzazioni e condivisione dei dispositivi delle API Google Home senza interruzioni per l'esperienza di onboarding nella tua applicazione.
Gli argomenti principali descritti qui sono:
- Perché condividere i dispositivi con Google Home?
- Fasi principali del flusso di condivisione
- Implementazione tecnica
- Best practice per la UX
Perché condividere i dispositivi con Google Home?
Per usufruire delle funzionalità offerte dalle API Home, gli utenti devono condividere i propri dispositivi con Google Home perché:
- Si tratta di un requisito tecnico per consentire a Google di utilizzare questi dispositivi nelle automazioni.
- Ciò contribuisce a mantenere un'esperienza Google Home coerente e flessibile.
- Garantire che i dispositivi vengano presentati in modo coerente nelle app abilitate per le API Home è fondamentale per evitare di creare un'esperienza utente frammentata e confusa in cui gli utenti devono passare da un'app all'altra per eseguire attività di base.
Componenti chiave del flusso di condivisione
| Componente | Programma | Descrizione |
|---|---|---|
| API Permissions su Android | API Home per le autorizzazioni su Android | Chiede agli utenti di concedere le autorizzazioni alla tua app. Prima di utilizzare una qualsiasi delle API Home, la tua app deve avere l'autorizzazione per accedere ai dispositivi nella casa dell'utente (indicata nell'API come struttura). Tuttavia, l'ordine in cui viene eseguito questo passaggio dipende dallo scenario dello sviluppatore ed è incluso nell'implementazione tecnica. |
| Collegamento da cloud a cloud | Cloud-to-cloud per il collegamento degli account | Ti consente di avviare la procedura di collegamento dell'account per condividere i dispositivi connessi al cloud con Google Home dall'interno della tua app. Per ridurre l'attrito per gli utenti, ti consigliamo di utilizzare la funzionalità di deep link (disponibile sia su Android che su iOS) che indirizza gli utenti direttamente alla tua pagina di collegamento dell'account specifica in GHA. |
| API Commissioning su Android | Provisioning di Matter | Sebbene sia generalmente considerata un'API per la messa in servizio di nuovi dispositivi Matter, puoi utilizzarla anche per aggiungere il fabric Google ai dispositivi Matter già messi in servizio in un altro fabric. Pertanto, questo è uno strumento utile per il processo di onboarding. |
Implementazione tecnica
La modalità di creazione dei flussi di condivisione dipende dai dispositivi che prevedi di condividere con Google.
Per i seguenti scenari, ti consigliamo di seguire i passaggi nell'ordine indicato. In questo modo, gli utenti possono usufruire di un'esperienza complessiva migliore.
Produci solo dispositivi Matter
Produci dispositivi compatibili con Matter che vuoi commissionare a Google Home.
Chiama l'API Permissions su Android.
Chiama l'API Commissioning su Android su ogni dispositivo Matter precedentemente commissionato a un altro fabric.
- Poiché la condivisione di Matter deve essere eseguita per ogni dispositivo singolarmente e sono presenti molte schermate che richiedono l'input dell'utente, ti consigliamo di guidare l'utente attraverso questa procedura:
- Fornire agli utenti un elenco di dispositivi Matter non condivisi con Google.
- Consentire agli utenti di avviare la procedura di condivisione dei dispositivi (utilizzando l'API Commissioning) facendo clic sui dispositivi nell'elenco.
- Ritorno all'elenco dei dispositivi Matter, con visualizzazione dello stato di avanzamento dell'attività e dello stato di condivisione per l'utente.
- Poiché la condivisione di Matter deve essere eseguita per ogni dispositivo singolarmente e sono presenti molte schermate che richiedono l'input dell'utente, ti consigliamo di guidare l'utente attraverso questa procedura:
Produci solo dispositivi condivisi con Google utilizzando le API Cloud-to-Cloud
Esegui il deep linking di Cloud-to-cloud. In questo modo i dispositivi vengono aggiunti a Google Home Graph.
- Ti consigliamo di eseguire prima il collegamento di Cloud-to-cloud per evitare situazioni potenzialmente confuse, ad esempio che all'utente venga presentato un elenco contenente dispositivi condivisi con Google e dispositivi non condivisi con Google.
Chiama l'API Permissions su Android.
Produci dispositivi cloud-to-cloud e Matter
Esegui il deep linking di Cloud-to-cloud.
- Ti consigliamo di eseguire prima il collegamento di Cloud-to-cloud per evitare situazioni potenzialmente confuse, ad esempio che all'utente venga presentato un elenco contenente dispositivi condivisi con Google e dispositivi non condivisi con Google.
Chiama l'API Permissions su Android.
Chiama l'API Commissioning per Android su ogni dispositivo Matter precedentemente commissionato a un altro fabric.
- Poiché la condivisione di Matter deve essere eseguita per ogni dispositivo singolarmente e sono presenti molte schermate che richiedono l'input dell'utente, ti consigliamo di guidare l'utente attraverso questa procedura:
- Fornire agli utenti un elenco di dispositivi Matter non condivisi con Google.
- Consentire agli utenti di avviare la procedura di condivisione dei dispositivi (utilizzando l'API Commissioning) facendo clic sui dispositivi nell'elenco.
- Ritorno all'elenco dei dispositivi Matter, con visualizzazione dello stato di avanzamento dell'attività e dello stato di condivisione per l'utente.
- Poiché la condivisione di Matter deve essere eseguita per ogni dispositivo singolarmente e sono presenti molte schermate che richiedono l'input dell'utente, ti consigliamo di guidare l'utente attraverso questa procedura:
Non hai dispositivi da condividere con Google
Chiama l'API Permissions.
Best practice per la UX
Questa sezione contiene alcuni Critical User Journey da considerare quando sviluppi un'app che utilizza le API Home.
Dove introdurre la condivisione dei dispositivi nell'app
Questo non è un elenco esaustivo e potresti trovare altre opportunità per fornire un'esperienza di condivisione e una presentazione di Google Home tempestive per i tuoi utenti.
Inoltre, non si escludono a vicenda e sono disponibili più punti di accesso:
Da un menu Impostazioni
Poiché gli utenti sono probabilmente abituati a configurare le connessioni con i loro ecosistemi Google Home tramite un menu delle impostazioni, questo metodo consente loro di continuare con questo paradigma.
Potresti voler separare la condivisione dei dispositivi (collegamento di Cloud-to-cloud e API Commissioning di Matter) dalle autorizzazioni app (API Permissions). In questo modo, gli utenti possono controllare i passaggi che completano e tu hai l'opportunità di mostrare loro lo stato della connessione.
Quando utilizzi i dispositivi nelle automazioni eseguite da Google
Dalla scheda Automazioni, gli utenti potevano toccare un punto di accesso al flusso di condivisione, leggere una schermata della proposta di valore che spiega chiaramente i vantaggi di procedere e poi spostarsi rapidamente nel flusso delle autorizzazioni.
Solo dalla messa in servizio
Questo scenario è rivolto principalmente ai partner che producono solo dispositivi Matter (nessun dispositivo Cloud-to-cloud) e non hanno un proprio fabric Matter. Il punto di accesso per l'utente può essere visualizzato subito dopo una schermata di tipo out-of-box in cui la condivisione dei dispositivi Matter (tramite l'API Commissioning) e l'autorizzazione dell'app (tramite l'API Permissions) fanno parte dello stesso flusso dell'esperienza utente.
Logica di condivisione
Ecco alcuni suggerimenti sui prompt degli utenti:
In genere, devi chiedere agli utenti di completare solo i passaggi mancanti necessari per l'onboarding sulla piattaforma. Ad esempio, i clienti di lunga data potrebbero già condividere i dispositivi di un OEM con Google. In questo caso, devono solo seguire la procedura di concessione delle autorizzazioni delle API Home per consentire all'app di accedere a Google Home.
Più amministratori di Google Home potrebbero condividere una struttura Google Home e, in alcuni casi, potrebbe essere utilizzato un solo account per condividere i dispositivi con Google. Di conseguenza, il completamento del collegamento di Cloud-to-cloud non dovrebbe essere un prerequisito per richiedere le autorizzazioni per le API Home.
Suggerimenti per la progettazione visiva
Un chiaro vantaggio dell'onboarding su Google Home (ad esempio, "Crea automazioni avanzate basate su Google Home" o "Controlla i dispositivi utilizzando le app che preferisci").
Un invito all'azione (ad esempio "Inizia") e un modo per annullare l'operazione se l'utente non vuole continuare.
Se lo spazio lo consente, una spiegazione di ciò che accadrà man mano che l'utente avanza nelle schermate.
In particolare, per Matter, se l'utente ti ha concesso l'accesso alla sua casa tramite le API Home, puoi consentire la condivisione dei dispositivi della sua casa con Google Home durante la messa in servizio di nuovi dispositivi. Ad esempio, puoi aggiungere un dispositivo Matter al tuo fabric e poi chiedere all'utente di aggiungere questo dispositivo al fabric di Google.
Suggerimenti sui contenuti
È più facile per gli utenti fidarsi di qualcosa che comprendono e che aggiunge valore. Offri agli utenti le informazioni necessarie per prendere decisioni consapevoli, inclusi i compromessi.
Il pitch critico
Gli utenti non continueranno a condividere i dispositivi se non esiste una proposta di valore forte per farlo.
- Presta particolare attenzione a come posizioni l'offerta.
- Rendila accattivante, ma non fare troppe promesse.
- Se l'utente ha bisogno di un dispositivo menzionato nella tua presentazione, assicurati che sia indicato chiaramente, in modo che non incontri un ostacolo imprevisto.
- Potresti avere una sola opportunità per acquisire questi utenti, quindi sfruttala al meglio.
Best practice
- Inizia dal punto di vista dell'utente, ovvero l'approccio "Cosa ci guadagno?".
- Non scrivere più di quattro righe di contenuti in un blocco di sezione. Un numero maggiore di parole potrebbe far perdere l'attenzione dell'utente. Tuttavia, la chiarezza e la comprensione possono essere più importanti della concisione.
- Le automazioni sono divertenti. Se lo spazio lo consente, scegli un esempio interessante, ma utile.
- Prova a utilizzare un tono di voce giocoso, se è in linea con la tua strategia generale.
- Utilizza frasi d'azione come "Inizia".