Descubrimiento de apps y vínculos directos

Google Home app (GHA) es la forma principal en que los usuarios conectan dispositivos inteligentes a Google Assistant y los asignan a estructuras y habitaciones en Google Home Graph. Por lo general, a fin de realizar la configuración, los usuarios hacen clic en varias pantallas para encontrar la acción smart home en una lista de opciones disponibles. Si facilitas el inicio del proceso de configuración a los usuarios, puedes ayudarlos a incorporarlos más rápido y disminuir su frustración.

Para optimizar la integración de usuarios en dispositivos smart home, la plataforma de smart home de Google ofrece varias funciones convenientes que facilitan a los usuarios ingresar rápidamente al flujo de configuración y comenzar a usar su dispositivo smart home. Estas funciones se pueden integrar fácilmente en tus acciones smart home con poco o ningún esfuerzo de programación.

En la siguiente lista, se resumen las funciones de la plataforma que puedes implementar a fin de reducir la fricción de los usuarios cuando configuran tus dispositivos inteligentes para Assistant:

  • App Discovery: Esta función permite que los usuarios vean chips de sugerencias para vincular tu acción en GHA. Si hacen clic en el chip, pueden conectar sus dispositivos smart home a Assistant mediante sus cuentas de proveedores de terceros.
  • Vínculos directos: Esta función te permite incorporar un vínculo directo en el sitio web de tu app o producto para que los usuarios conecten con facilidad su dispositivo smart home a Assistant. Cuando hagan clic en el vínculo, se les solicitará a los usuarios que descarguen GHA (si aún no lo instalaste) y se iniciará el flujo de vinculación de cuentas y configuración de asignación de salas.

Implementa el descubrimiento de apps

Puedes habilitar la función App Discovery desde Actions on Google Console después de completar el proceso de verificación de marca. No se necesitan cambios de código, pero tu acción smart home ya debe estar revisada y en producción.

Accede a Actions Console:

Ir a la consola de Actions on Google

  1. Abre tu proyecto de acción de smart home.
  2. Haz clic en Implementar > Verificación de la marca.
  3. Sigue estos pasos para conectar el sitio web de tu empresa con tu proyecto de Acciones.
    1. En el panel Sitios web, haga clic en Conectar sitio.
    2. Ingresa la URL del sitio web que quieras conectar y haz clic en Conectar. Google envía un correo electrónico al propietario del sitio web para confirmar la asociación del sitio web.
  4. En el panel Apps para Android, haz clic en el botón Conectar app y sigue las instrucciones.

  5. En el mismo panel, activa la opción Enable app discovery para tu app conectada. Esta opción permanecerá inhabilitada hasta que se revise y apruebe tu acción.

Vínculo directo a Google Home

Los vínculos directos te permiten llevar a los usuarios directamente a un destino específico dentro de GHA desde tu Android o app para iOS, lo que simplifica el proceso de configuración del dispositivo con Assistant.

La sintaxis de los vínculos directos GHA es la siguiente:

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

Actualmente, tu app de Android o iOS puede vincularse a los siguientes destinos dentro de GHA:

Destino Descripción
setup/ha_linking?agent_id=agent-id Inicia el flujo de vinculación de cuentas de OAuth para el agent-id de la acción de smart home especificado.

La ruta de destino debe estar codificada en la URL correctamente antes de aplicarla al vínculo directo. Por ejemplo:

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

Para obtener más detalles sobre cómo activar vínculos directos desde tu app, consulta la documentación de Android y la documentación de iOS relevantes.