Procedure di onboarding degli utenti finali su Android

Questa guida fornisce indicazioni sull'esperienza utente per la progettazione di autorizzazioni e condivisione dei dispositivi con le 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 chiave del flusso di condivisione
• Implementazione tecnica
• Best practice per l'esperienza utente

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é:

• È un requisito tecnico per Google utilizzare questi dispositivi nelle automazioni.
• 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 svolgere 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 delle API Home, la tua app deve avere l'autorizzazione per accedere ai dispositivi nella casa dell'utente (indicata nell'API come la struttura). L'ordine in cui viene eseguito questo passaggio, tuttavia, dipende dallo scenario dello sviluppatore ed è incluso nell' implementazione tecnica.
Collegamento da cloud a cloud	Da cloud a cloud per il collegamento dell'account	Consente di avviare il processo di collegamento dell'account per condividere i dispositivi connessi al cloud con Google Home dall'interno dell'app. Per ridurre le difficoltà 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 pagina di collegamento dell'account specifica in GHA.
API Commissioning su Android	Commissioning Matter	Sebbene in genere sia considerata un'API per il commissioning di nuovi Matter dispositivi, puoi utilizzare questa API anche per aggiungere il fabric Google ai Matter dispositivi che sono già stati sottoposti a commissioning a 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 avranno un'esperienza complessiva migliore.

Produci solo dispositivi Matter

Produci dispositivi compatibili con Matter che vuoi sottoporre a commissioning con Google Home.

1. Chiama l'API Permissions su Android.

2. Chiama l' API Commissioning su Android su ogni dispositivo Matter precedentemente sottoposto a commissioning a un altro fabric.

   1. Poiché la condivisione Matter deve essere eseguita singolarmente per ogni dispositivo e sono presenti molte schermate che richiedono l'input dell'utente, ti consigliamo di guidare l'utente in questo processo:
      • Fornendo agli utenti un elenco di dispositivi Matter non condivisi con Google.
      • Consentendo agli utenti di avviare il processo di condivisione dei dispositivi (utilizzando l'API Commissioning) facendo clic sui dispositivi nell'elenco.
      • Tornando all'elenco dei dispositivi Matter, mostrando all'utente lo stato di avanzamento dell'attività e lo stato di condivisione.

Produci solo dispositivi condivisi con Google utilizzando le API da cloud a cloud

1. Esegui Cloud-to-cloud deep linking. In questo modo, i dispositivi vengono aggiunti a Google Home Graph.

   1. Ti consigliamo di eseguire prima il collegamento Cloud-to-cloud per evitare situazioni potenzialmente confuse, ad esempio la visualizzazione di un elenco contenente dispositivi condivisi con Google e dispositivi non condivisi con Google.

2. Chiama l'API Permissions su Android.

Produci dispositivi da cloud a cloud e Matter

1. Esegui Cloud-to-cloud deep linking.

   1. Ti consigliamo di eseguire prima il collegamento Cloud-to-cloud per evitare situazioni potenzialmente confuse, ad esempio la visualizzazione di un elenco contenente dispositivi condivisi con Google e dispositivi non condivisi con Google.

2. Chiama l'API Permissions su Android.

3. Chiama l' API Commissioning per Android su ogni Matter dispositivo precedentemente sottoposto a commissioning a un altro fabric.

   1. Poiché la condivisione Matter deve essere eseguita singolarmente per ogni dispositivo e sono presenti molte schermate che richiedono l'input dell'utente, ti consigliamo di guidare l'utente in questo processo:
      • Fornendo agli utenti un elenco di dispositivi Matter non condivisi con Google.
      • Consentendo agli utenti di avviare il processo di condivisione dei dispositivi (utilizzando l'API Commissioning) facendo clic sui dispositivi nell'elenco.
      • Tornando all'elenco dei dispositivi Matter, mostrando all'utente lo stato di avanzamento dell'attività e lo stato di condivisione.

Non hai dispositivi da condividere con Google

Chiama l'API Permissions.

Best practice per l'esperienza utente

Questa sezione contiene alcuni percorsi utente fondamentali da considerare quando sviluppi un'app che utilizza le API Home.

Dove introdurre la condivisione dei dispositivi nell'app

Questo elenco non è esaustivo e potresti trovare altre opportunità per fornire agli utenti un'esperienza di condivisione e presentazione di Google Home tempestiva.

Inoltre, non si escludono a vicenda e sono presenti più punti di accesso:

Da un menu Impostazioni

Poiché gli utenti sono probabilmente abituati a configurare le connessioni con i propri ecosistemi Google Home tramite un menu Impostazioni, questo metodo consente loro di continuare con questo paradigma.

Potresti voler separare la condivisione dei dispositivi (Cloud-to-cloud linking e l'Matter Commissioning API) dall' autorizzazione dell'app (API Permissions). In questo modo, gli utenti possono controllare i passaggi che completano e tu hai l'opportunità di mostrare all'utente lo stato della connessione.

Quando si utilizzano i dispositivi nelle automazioni gestite da Google

Dalla scheda Automazioni, gli utenti possono toccare un punto di accesso al flusso di condivisione, leggere una schermata di proposta di valore che spiega chiaramente i vantaggi di procedere e poi passare rapidamente al flusso di autorizzazioni.

Solo dal commissioning

Questo scenario è destinato principalmente ai partner che producono solo dispositivi Matter (nessun dispositivo Cloud-to-cloud) e non hanno il proprio Matter fabric. Il punto di accesso per l'utente può essere visualizzato subito dopo una schermata di tipo out-of-box in cui la condivisione dei Matter dispositivi (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 utente:

• In genere, dovresti chiedere agli utenti di completare solo i passaggi mancanti necessari per l'onboarding della piattaforma. Ad esempio, i clienti di lunga data potrebbero già condividere i dispositivi di un OEM con Google, nel qual 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 di Google Home e, in alcuni casi, potrebbe essere utilizzato un solo account per condividere i dispositivi con Google. Di conseguenza, il completamento del collegamento Cloud-to-cloud non deve essere un prerequisito per richiedere le autorizzazioni delle API Home.

Suggerimenti per la progettazione visiva

• Un chiaro vantaggio dell'onboarding a 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 se l'utente non vuole continuare.

• Se lo spazio lo consente, una spiegazione di cosa accadrà man mano che l'utente avanza nelle schermate.

• Per Matter in particolare, se l'utente ti ha già concesso l'accesso alla sua casa tramite le API Home, puoi rendere possibile condividere i dispositivi nella sua casa con Google Home durante il commissioning di nuovi dispositivi. Ad esempio, puoi aggiungere un Matter dispositivo al tuo fabric e poi chiedere all'utente di aggiungere questo dispositivo al fabric Google.

Suggerimenti sui contenuti

È più facile per gli utenti fidarsi di qualcosa che comprendono e che aggiunge valore. Dai agli utenti la possibilità di prendere decisioni informate, fornendo informazioni, inclusi i compromessi.

La presentazione fondamentale

Gli utenti non continueranno a condividere i dispositivi se non esiste una proposta di valore forte.

• Presta particolare attenzione a come posizioni l'offerta.
• Rendila allettante, ma non fare promesse eccessive.
• Se l'utente ha bisogno di un dispositivo menzionato nella 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

1. Inizia dal punto di vista dell'utente: l'approccio "Qual è il vantaggio per me?".
2. Non scrivere più di quattro righe di contenuti in un blocco di sezione. Più parole potrebbero distrarre l'utente. Tuttavia, la chiarezza e la comprensione possono essere più importanti della concisione.
3. Le automazioni sono divertenti! Scegli un esempio interessante ma utile, se lo spazio lo consente.
4. Prova a utilizzare un tono giocoso se è in linea con la tua strategia generale.
5. Utilizza frasi che invitano all'azione, ad esempio "Inizia".