Rilevamento delle app e link diretti

Google Home app (GHA) è il metodo principale utilizzato dagli utenti per connettere gli smart device a Google Assistant e assegnarli a strutture e stanze in Google Home Graph. Per eseguire la configurazione, in genere gli utenti fanno clic su più schermate per trovare l'azione smart home da un elenco di opzioni disponibili. Semplificando l'avvio del processo di configurazione per gli utenti, puoi facilitare l'onboarding più rapidamente e ridurre la frustrazione degli utenti.

Per semplificare l'onboarding degli utenti sui dispositivi smart home, la piattaforma Google smart home offre diverse funzionalità che rendono più semplice per gli utenti accedere rapidamente al flusso di configurazione e iniziare a utilizzare il loro dispositivo smart home. Queste funzionalità possono essere facilmente integrate nelle smart home azioni con poco o nessun lavoro di programmazione.

Il seguente elenco riepiloga le funzionalità della piattaforma che puoi implementare per ridurre le difficoltà degli utenti quando configurano i tuoi smart device per Assistant:

  • App Discovery: questa funzionalità consente agli utenti di visualizzare chip di suggerimenti per il collegamento alla tua azione nella GHA. Facendo clic sul chip, possono connettere i loro dispositivi smart home a Assistant utilizzando i loro account fornitore di terze parti.
  • Link diretti. Questa funzionalità ti consente di incorporare un link diretto nella tua app o nel sito web del prodotto in modo che gli utenti possano collegare facilmente il proprio dispositivo smart home a Assistant. Facendo clic sul link, gli utenti vengono invitati a scaricare GHA (se non è già installato) e ad avviare il flusso di collegamento degli account e di configurazione delle assegnazioni delle stanze.

Implementa l'individuazione delle app

Puoi attivare la funzionalità App Discovery da Actions on Google Console dopo aver completato la verifica del brand. Non sono necessarie modifiche al codice, tuttavia l'azione smart home deve essere già stata esaminata e in produzione.

Accedi a Actions Console:

Vai alla console Actions on Google

  1. Apri il progetto per l'azione smart home.
  2. Fai clic su Esegui il deployment > Verifica del brand.
  3. Segui questi passaggi per collegare il tuo sito web aziendale al tuo progetto Actions.
    1. Nel riquadro Siti web, fai clic su Collega sito.
    2. Inserisci l'URL del sito web che vuoi collegare e fai clic su Connetti. Google invia un'email al proprietario del sito web per confermare l'associazione del sito web.
  4. Nel riquadro App Android, fai clic sul pulsante Connetti app e segui le istruzioni mostrate.

  5. Nello stesso riquadro, attiva l'opzione Attiva il rilevamento app per l'app collegata. Questa opzione non è selezionabile finché la tua azione non è stata esaminata e approvata.

Link diretto a Google Home

I link diretti ti consentono di indirizzare gli utenti direttamente a una destinazione specifica all'interno di GHA dall'app Android o iOS, semplificando la procedura di configurazione del dispositivo con Assistant.

La sintassi dei link diretti GHA è la seguente:

https://madeby.google.com/home-app/?deeplink=destination

Al momento la tua app Android o iOS può collegarsi alle seguenti destinazioni all'interno di GHA:

Destinazione Descrizione
setup/ha_linking?agent_id=agent-id Avvia il flusso di collegamento dell'account OAuth per l'smart home azione agent-id specificata.

Il percorso di destinazione deve essere codificato in URL correttamente prima di applicarlo al link diretto. Ad esempio:

https://madeby.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id

Per ulteriori dettagli sull'attivazione di link diretti dalla tua app, consulta la relativa documentazione Android e la documentazione per iOS.