Rilevamento di app e link diretti

Il Google Home app (GHA) è il modo principale in cui gli utenti connettono gli smart device a Google Assistant e li assegnano 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 in un elenco di opzioni disponibili. Se rendi più semplice per gli utenti l'avvio della procedura di configurazione, puoi aiutare gli utenti a effettuare l'onboarding più rapidamente e ridurre la frustrazione durante la configurazione.

Per semplificare l'onboarding degli utenti sui dispositivi smart home, la piattaforma Google smart home offre diverse funzionalità utili che consentono agli utenti di accedere rapidamente al flusso di configurazione e iniziare a utilizzare il proprio dispositivo smart home. Queste funzionalità possono essere facilmente integrate nelle tue Azioni smart home con un impegno minimo o nullo di programmazione.

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

  • App Discovery: questa funzionalità consente agli utenti di visualizzare chip di suggerimenti per il collegamento all'Azione nell'GHA; facendo clic sul chip, possono collegare i propri dispositivi smart home a Assistant utilizzando gli account del fornitore di terze parti.
  • Link diretti: questa funzionalità ti consente di incorporare un link diretto nel sito web della tua app o del tuo prodotto per consentire agli utenti di collegare facilmente il proprio dispositivo smart home a Assistant. Facendo clic sul link, gli utenti devono scaricare l'GHA (se non è già installato) e avviare il flusso di configurazione del collegamento dell'account e dell'assegnazione delle stanze.

Implementa la funzionalità di rilevamento delle app

Puoi attivare la funzionalità App Discovery dal Actions on Google Console dopo aver completato la procedura di verifica del brand. Non sono necessarie modifiche al codice, ma 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 dell'azione smart home.
  2. Fai clic su Esegui il deployment > Verifica del brand.
  3. Segui questi passaggi per collegare il sito web della tua azienda al 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 con il sito web.
  4. Nel riquadro App Android, fai clic sul pulsante Collega app e segui le istruzioni mostrate.

  5. Nello stesso riquadro, attiva l'opzione Abilita il rilevamento di app per l'app collegata. Questa opzione non è selezionabile finché l'Azione non viene 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 per iOS, semplificando la procedura di configurazione dei dispositivi 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 per 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'agent-id dell'azione smart home specificata.

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

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

Per ulteriori informazioni sull'attivazione dei link diretti dall'interno dell'app, consulta la documentazione su Android e la documentazione per iOS pertinenti.