Descoberta de apps e links diretos

O Google Home app (GHA) é a principal maneira de os usuários conectarem dispositivos inteligentes ao Google Assistant e os atribuir a estruturas e ambientes no Google Home Graph. Para realizar a configuração, os usuários normalmente clicam em várias telas para encontrar a Ação smart home em uma lista de opções disponíveis. Ao facilitar o início do processo de configuração para os usuários, você pode ajudar a fazer a integração mais rápida e reduzir a frustração do usuário durante a configuração.

Para simplificar a integração de usuários em dispositivos smart home, a plataforma Google smart home oferece vários recursos de conveniência que facilitam a entrada rápida no fluxo de configuração e o início do uso do dispositivo smart home. Esses recursos podem ser facilmente integrados às suas ações smart home com pouco ou nenhum esforço de programação.

A lista a seguir resume os recursos da plataforma que você pode implementar para reduzir o atrito do usuário ao configurar seus dispositivos inteligentes para Assistant:

  • App Discovery: esse recurso permite que os usuários vejam ícones de sugestão para vincular sua ação no GHA. Ao clicar no ícone, eles podem conectar os dispositivos smart home ao Assistant usando as contas de provedor de terceiros.
  • Links diretos: esse recurso permite incorporar um link direto ao site do app ou produto para os usuários conectarem facilmente o dispositivo smart home ao Assistant. Ao clicar no link, os usuários fazem o download do GHA (se ainda não estiver instalado) e inicia a vinculação da conta e o fluxo de configuração da atribuição de sala.

Implementar a descoberta de apps

É possível ativar o recurso App Discovery em Actions on Google Console após concluir o processo de verificação de marca. Nenhuma mudança de código é necessária, mas a ação smart home já precisa ter sido analisada e estar em produção.

Faça login no Actions Console:

Acessar o console do Actions on Google

  1. Abra seu projeto de ação smart home.
  2. Clique em Implantar > Verificação de marca.
  3. Siga estas etapas para conectar o site da sua empresa ao projeto do Actions.
    1. No painel Sites, clique em Conectar site.
    2. Insira o URL do site que você quer conectar e clique em Conectar. O Google envia um e-mail ao proprietário do site para confirmar a associação do site.
  4. No painel Apps Android, clique no botão Conectar app e siga as instruções mostradas.

  5. No mesmo painel, ative a opção Ativar descoberta de apps no app conectado. Essa opção vai ficar esmaecida até que a ação seja analisada e aprovada.

Link direto para o Google Home

Os links diretos permitem levar os usuários diretamente a um destino específico no GHA do seu app Android ou iOS, simplificando o processo de configuração do dispositivo com Assistant.

A sintaxe dos links diretos GHA é a seguinte:

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

Atualmente, seu app Android ou iOS pode se vincular aos seguintes destinos no GHA:

Destino Descrição
setup/ha_linking?agent_id=agent-id Inicie o fluxo de vinculação de conta do OAuth para o agent-id da smart home ação especificada.

O caminho de destino precisa ser codificado em URL corretamente antes de aplicá-lo ao link direto. Exemplo:

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

Para mais detalhes sobre como acionar links diretos no seu app, consulte as documentações relevantes do Android e do iOS.