App-Sichtbarkeit und Deeplinks

Über die Google Home app (GHA) können Nutzer Smart-Home-Geräte mit Google Assistant verbinden und Gebäuden und Räumen in Google Home Graph zuweisen. Bei der Einrichtung klicken Nutzer in der Regel durch mehrere Bildschirme, um Ihre Cloud-to-cloud-Integration in einer Liste der verfügbaren Optionen zu finden. Wenn Sie Nutzern den Einstieg in die Einrichtung erleichtern, können Sie sie schneller einrichten und Frustrationen bei der Einrichtung vermeiden.

Um die Einrichtung von smart home-Geräten zu vereinfachen, bietet die Google smart home-Plattform mehrere praktische Funktionen, mit denen Nutzer schnell zur Einrichtung gelangen und ihr smart home-Gerät verwenden können. Diese Funktionen lassen sich mit wenig oder gar keinem Programmiercode ganz einfach in Ihre Cloud-to-cloud-Integration einbinden.

In der folgenden Liste sind Plattformfunktionen zusammengefasst, die Sie implementieren können, um die Einrichtung Ihrer Smart-Home-Geräte für Assistant zu vereinfachen:

  • App Discovery: Mit dieser Funktion können Nutzer im GHA Vorschläge für Verknüpfungen mit deiner Cloud-to-cloud-Integration sehen. Wenn sie auf den Chip klicken, können sie ihre smart home-Geräte über die Konten ihrer Drittanbieter mit Assistant verbinden.
  • Deeplinks: Mit dieser Funktion können Sie einen Deeplink in Ihre App oder Produktwebsite einbetten, damit Nutzer ihr smart home-Gerät ganz einfach mit Assistant verbinden können. Wenn Nutzer auf den Link klicken, werden sie aufgefordert, die GHA herunterzuladen (falls noch nicht installiert) und die Einrichtung der Kontoverknüpfung und Raumzuweisung zu starten.

App-Sichtbarkeit implementieren

Sie können die App Discovery-Funktion über das Google Home Developer Console aktivieren, nachdem Sie die Markenbestätigung abgeschlossen haben. Es sind keine Codeänderungen erforderlich. Ihre Cloud-to-cloud-Integration muss jedoch bereits geprüft und in Produktion sein.

Melden Sie sich in der Developer Console an:

Developer Console aufrufen

  1. Öffnen Sie Ihr Cloud-to-cloud-Integrationsprojekt.

  2. Klicken Sie auf Unternehmensprofil.

  3. Folgen Sie der Anleitung unter Unternehmensprofil erstellen, um Ihre Unternehmenswebsite mit Ihrem Integrationsprojekt zu verknüpfen.

Deeplink zu Google Home

Mit Deeplinks können Sie Nutzer direkt von Ihrer Android- oder iOS-App zu einem bestimmten Ziel innerhalb der GHA weiterleiten. So wird die Geräteeinrichtung mit Assistant vereinfacht.

Die Syntax für GHA-Deeplinks lautet:

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

Ihre Android- oder iOS-App kann derzeit auf die folgenden Ziele innerhalb der GHA verlinken:

Ziel Beschreibung
setup/ha_linking?agent_id=agent-id Starte den OAuth-Kontoverknüpfungsvorgang für die agent-id der Cloud-to-cloud-Integration.

Der Zielpfad muss richtig URL-codiert sein, bevor Sie ihn auf den Deeplink anwenden. Beispiel:

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

Weitere Informationen zum Auslösen von Deeplinks in Ihrer App finden Sie in der Android-Dokumentation und in der iOS-Dokumentation.