Procedure di onboarding degli utenti finali su Android

Questa guida fornisce indicazioni sulla UX 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 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 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

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, puoi offrire agli utenti un'esperienza complessiva migliore.

Produci solo dispositivi Matter

Produci dispositivi compatibili con Matter che vuoi commissionare a Google Home.

1. Chiama l'API Permissions su Android.

2. Chiama l'API di messa in servizio su Android su ogni dispositivo Matter precedentemente messo in servizio su 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 dei dispositivi (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 al grafo di Google Home.

   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 su Android.

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 su Android.

3. Chiama l'API di messa in servizio per Android su ogni dispositivo Matter precedentemente messo in servizio su 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 dei dispositivi (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'autorizzazione delle app (API Permissions). In questo modo gli utenti possono controllare i passaggi da completare e tu hai la possibilità di mostrare lo stato della connessione.

Quando utilizzi i dispositivi nelle automazioni eseguite da Google

Dalla scheda Automazioni, gli utenti potevano toccare un punto di contatto per il flusso di condivisione, leggere una schermata della proposta di valore che spiegava 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 dispongono di un 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 dell'utente:

• In genere, devi 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 a 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 per le 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. Dai potere agli utenti fornendo informazioni per prendere decisioni consapevoli, 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. Se lo spazio lo consente, scegli un esempio interessante, ma utile.
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".