App-Discovery und Deeplinks

Google Home app (GHA) ist die primäre Methode, mit der Nutzer Smart-Home-Geräte mit Google Assistant verbinden und sie in Gebäuden und Räumen in Google Home Graph zuweisen. Zum Einrichten klicken Nutzer in der Regel auf mehrere Bildschirme, um die Aktion smart home aus einer Liste der verfügbaren Optionen zu finden. Wenn Sie den Nutzern die Einrichtung erleichtern, können Sie sie schneller einrichten und so die Frustration der Nutzer reduzieren.

Um das Onboarding von Nutzern auf smart home-Geräten zu optimieren, bietet die Google smart home-Plattform mehrere praktische Funktionen, die es Nutzern erleichtern, den Einrichtungsvorgang schnell aufzurufen und ihr smart home-Gerät zu verwenden. Diese Funktionen lassen sich mit wenigen oder ganz ohne Programmierkenntnisse ganz einfach in smart home-Aktionen einbinden.

In der folgenden Liste werden Plattformfunktionen zusammengefasst, die Sie implementieren können, um Nutzer beim Einrichten Ihrer Smart-Home-Geräte für Assistant zu reduzieren.

• App Discovery: Mit dieser Funktion sehen Nutzer Vorschlags-Chips zum Verknüpfen mit deiner Aktion in GHA. Wenn sie auf den Chip klicken, können sie ihre smart home-Geräte mit ihrem Drittanbieterkonto mit Assistant verbinden.
• Deeplink: Mit diesem Feature können Sie einen Deeplink in Ihre App oder auf Ihrer 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, das GHA herunterzuladen (falls es noch nicht installiert ist). Außerdem wird der Ablauf für die Kontoverknüpfung und die Raumzuweisung gestartet.

App Discovery implementieren

Sie können die App Discovery-Funktion über Actions on Google Console aktivieren, nachdem Sie die Markenüberprüfung abgeschlossen haben. Es sind keine Codeänderungen erforderlich. Die Aktion smart home muss jedoch bereits überprüft und in der Produktion verwendet werden.

Melden Sie sich im Actions Console an:

Zur Actions on Google-Konsole

1. Öffnen Sie Ihr smart home-Aktionsprojekt.
2. Klicken Sie auf Bereitstellen > Markenüberprüfung.
3. Führen Sie die folgenden Schritte aus, um die Website Ihres Unternehmens mit Ihrem Actions-Projekt zu verknüpfen.
   1. Klicken Sie im Bereich Websites auf Website verknüpfen.
   2. Geben Sie die URL der Website ein, die Sie verknüpfen möchten, und klicken Sie auf Verbinden. Google sendet eine E-Mail an den Websiteinhaber, um die Website-Verknüpfung zu bestätigen.

4. Klicken Sie im Bereich Android-Apps auf die Schaltfläche App verknüpfen und folgen Sie der Anleitung.

5. Aktivieren Sie im selben Bereich die Option App-Erkennung aktivieren für die verbundene App. Diese Option ist so lange ausgegraut, bis Ihre Aktion überprüft und genehmigt wurde.

Deeplink zu Google Home

Wenn Sie Deeplinks verwenden, können Sie Nutzer von Ihrer Android- oder iOS-App direkt zu einem bestimmten Ziel in der GHA weiterleiten. Dies vereinfacht die Geräteeinrichtung mit Assistant.

Die Syntax der GHA-Deeplinks sieht so aus:

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

Die App Android oder iOS kann derzeit mit den folgenden Zielen innerhalb von GHA verknüpft werden:

Ziel	Beschreibung
setup/ha_linking?agent_id=agent-id	Initiiere den Vorgang für die OAuth-Kontoverknüpfung für die agent-id der angegebenen smart home-Aktion.

Der Zielpfad muss ordnungsgemäß URL-codiert werden, bevor Sie ihn auf den Deeplink anwenden können. Beispiel:

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

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