Flussi di onboarding degli utenti finali

Questa guida fornisce indicazioni sull'esperienza utente per progettare le autorizzazioni e la condivisione dei dispositivi delle API Google Home 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 sull'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 compatibili con l'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	API Home per le autorizzazioni	Chiede agli utenti di concedere autorizzazioni alla tua app. Prima di utilizzare qualsiasi API Home, la tua app deve disporre dell'autorizzazione per accedere ai dispositivi di casa dell'utente (indicata nell'API come 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	Cloud-to-cloud per il collegamento dell'account	Ti consente di avviare la procedura di collegamento dell'account per condividere i dispositivi collegati al cloud con Google Home dalla tua app. Per ridurre le difficoltà degli utenti, consigliamo di utilizzare la funzionalità di link diretti (disponibile sia su Android che su iOS) che indirizza gli utenti direttamente alla pagina di collegamento dell'account specifica in GHA.
API di messa in servizio	Commissioning 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 che sono già stati messi in servizio in un altro fabric. Pertanto, si tratta di uno strumento utile per la procedura 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.

1. Chiama l'API Permissions.

2. Chiama l'API Google Commissioning su ogni dispositivo Matter precedentemente commissionato a un altro fabric.

   1. Poiché la condivisione di Matter deve essere eseguita singolarmente per ogni dispositivo e ci sono 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 del dispositivo (utilizzando l'API Commissioning) facendo clic sui dispositivi nell'elenco.
      • Ritorno all'elenco dei dispositivi Matter, che mostra all'utente lo stato di avanzamento dell'attività e della condivisione.

Produci solo dispositivi condivisi con Google utilizzando API cloud-to-cloud

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

   1. Ti consigliamo di eseguire prima il Cloud-to-cloudcollegamento per evitare situazioni potenzialmente confuse, ad esempio la presentazione all'utente di un elenco contenente i dispositivi condivisi con Google e quelli non condivisi con Google.

2. Chiama l'API Permissions.

Produci dispositivi sia cloud-to-cloud che Matter

1. Esegui Cloud-to-cloud link diretti.

   1. Ti consigliamo di eseguire prima il Cloud-to-cloudcollegamento per evitare situazioni potenzialmente confuse, ad esempio la presentazione all'utente di un elenco contenente i dispositivi condivisi con Google e quelli non condivisi con Google.

2. Chiama l'API Permissions.

3. Chiama l'API Google Commissioning su ogni dispositivo Matter precedentemente commissionato a un altro fabric.

   1. Poiché la condivisione di Matter deve essere eseguita singolarmente per ogni dispositivo e ci sono 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 del dispositivo (utilizzando l'API Commissioning) facendo clic sui dispositivi nell'elenco.
      • Ritorno all'elenco dei dispositivi Matter, che mostra all'utente lo stato di avanzamento dell'attività e della condivisione.

Non hai dispositivi da condividere con Google

Chiama l'API Permissions.

Best practice per l'esperienza utente

Questa sezione contiene alcuni percorsi degli utenti fondamentali da considerare durante lo sviluppo di un'app che sfrutta le API Home.

Dove introdurre la condivisione del dispositivo nell'app

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

Inoltre, non sono mutuamente esclusivi e sono disponibili più punti di contatto:

Da un menu Impostazioni

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

Ti consigliamo di separare la condivisione dei dispositivi (collegamento Cloud-to-cloud e API Matter Commissioning) dall'assegnazione delle autorizzazioni app (API Permissions). In questo modo, gli utenti possono controllare i passaggi da completare e tu hai la possibilità di mostrare loro lo stato della connessione.

Quando utilizzi i dispositivi nelle automazioni eseguite da Google

Dalla scheda Automazioni, gli utenti possono toccare un punto di contatto per il flusso di condivisione, leggere una schermata della proposta di valore che spiega chiaramente i vantaggi della procedura e poi procedere rapidamente nel flusso delle autorizzazioni.

Solo dalla messa in servizio

Questo scenario è principalmente rivolto 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 dispositivi Matter (tramite l'API Commissioning) e l'autorizzazione delle app (tramite l'API Permissions) fanno parte dello stesso flusso dell'esperienza utente.

Logica di condivisione

Ecco alcuni suggerimenti per i prompt per gli utenti:

• In genere, dovresti chiedere agli utenti di completare solo i passaggi mancanti necessari per eseguire l'onboarding sulla 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 per le API Home per consentire all'app di accedere al proprio Google Home.

• Più amministratori di Google Home potrebbero condividere una casa Google, 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 deve essere un prerequisito per richiedere le autorizzazioni delle API Home.

Suggerimenti per la progettazione visiva

• Un chiaro vantaggio dell'onboarding in 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 succederà man mano che l'utente avanza tra le schermate.

• In particolare, per Matter, se l'utente ti ha già concesso l'accesso alla sua casa tramite le API Home, puoi consentirgli di condividere i dispositivi di casa sua con Google Home quando ne commissiona di nuovi. Ad esempio, puoi aggiungere un Matter dispositivo al tuo fabric e poi chiedere all'utente di aggiungerlo al fabric di Google.

Suggerimenti sui contenuti

È più facile per gli utenti fidarsi di qualcosa che comprendono e che aggiunge valore. Consenti agli utenti di prendere decisioni consapevoli fornendo informazioni, inclusi i compromessi.

La distanza tra i tasti critica

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

• Presta particolare attenzione al modo in cui posizioni l'offerta.
• Rendilo accattivante, ma non fare promesse eccessive.
• Se l'utente ha bisogno di un dispositivo menzionato nel tuo pitch, assicurati che sia stato indicato chiaramente in modo che non si imbatta in 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, ovvero con l'approccio "cosa ci guadagno?".
2. Non scrivere più di quattro righe di contenuti in un blocco della sezione. Più parole potrebbero far perdere l'attenzione dell'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 di voce allegro, se è in linea con la tua strategia generale.
5. Utilizza frasi che invitano all'azione, come "Inizia".