Facilitate smart home device setup

The Google Home app is the primary way users connect smart devices to Google Assistant and assign them to structures and rooms in Home Graph. To perform setup, users typically click through multiple screens to find your smart home Action from a list of available options. By making it easier for users to begin the setup process, you can help onboard them more quickly and reduce user setup frustration.

To streamline user onboarding on smart home devices, the Google Smart Home platform offers several convenience features that make it easier for users to quickly enter the setup flow and start using their smart home device. These features can be easily integrated into your smart home Actions with little or no coding effort.

The following list summarizes platform features that you can implement to reduce user friction when they set up your smart devices for Google Assistant:

  • App Discovery: This feature enables users to see suggestion chips for linking to your Action in the Google Home app; by clicking on the chip, they can connect their smart home devices to Google Assistant using their third party provider accounts.
  • Deep Linking: This feature allows you to embed a deep link in your app or product website for users to easily connect their smart home device to Google Assistant. Clicking on the link prompts users to download the Home app (if not already installed), and launches the account linking and room assignment setup flow.

Implement App Discovery

You can enable the App Discovery feature from the Actions console after completing the Brand Verification process. No code changes are needed, however your smart home Action must already be reviewed and in production.

  1. Login to your Actions console.
  2. Open your smart home Action project.
  3. Click Deploy > Brand Verification.
  4. Follow these steps to connect your company website to your Actions project.
    1. In the Websites panel, click Connect site.
    2. Enter the URL for the website you want to connect and click Connect. Google sends an email to the website owner to confirm the website association.
  5. In the Android apps panel, click the Connect app button and follow the instructions shown. Once you have completed the instructions over in the Play console, it may take up to 24 hours before the connected Android app is reflected in the Actions console.
  6. In the same panel, toggle the Enable app discovery option on for your connected app. This option is grayed out until your Action has been reviewed and approved.

Deep link to Google Home

Deep links enable you to take users directly to a specific destination within the Google Home app from your Android or iOS app, simplifying the device setup process with Google Assistant.

The syntax for the Home app deep links is as follows:

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

Your Android or iOS app can currently link to the following destinations within the Google Home app:

Destination Description
setup/ha_linking?agent_id=agent-id Initiate the OAuth account linking flow for the given smart home Action’s agent-id.

The destination path must be properly URL-encoded before you insert apply it to the deep link. For example:

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

For more details on triggering deep links from within your app, see the relevant Android documentation and iOS documentation.