Diese Seite wurde von der Cloud Translation API übersetzt.

Onboarding-Abläufe für Endnutzer unter Android

Dieser Leitfaden bietet UX-Hinweise für die Gestaltung nahtloser Geräteberechtigungen und Freigabefunktionen der Google Home APIs für das Onboarding-Erlebnis in Ihrer Anwendung.

Die hier beschriebenen Hauptthemen sind:

Warum sollte man Geräte mit Google Home teilen?

Um die Funktionen der Home-APIs nutzen zu können, müssen Benutzer ihre Geräte mit Google Home teilen, denn:

Das ist eine technische Voraussetzung dafür, dass Google diese Geräte in automatisierten Abläufen verwenden kann.
So wird eine einheitliche und flexible Google Home-Umgebung geschaffen.
- Es ist wichtig, dass Geräte in allen Apps, die die Home API unterstützen, einheitlich dargestellt werden. Andernfalls entsteht eine fragmentierte und verwirrende Nutzererfahrung, bei der Nutzer zwischen Apps wechseln müssen, um grundlegende Aufgaben zu erledigen.

Wichtige Komponenten des Freigabeworkflows

Komponente	Programm	Beschreibung
Permissions API unter Android	Home-APIs für Berechtigungen unter Android	Fordert Nutzer auf, Ihrer App Berechtigungen zu erteilen. Bevor Sie eine der Home-APIs verwenden, muss Ihre App die Berechtigung haben, auf Geräte im Zuhause des Nutzers zuzugreifen (in der API als structure bezeichnet). Die Reihenfolge, in der dieser Schritt ausgeführt wird, hängt jedoch vom Entwicklerszenario ab und ist in der technischen Implementierung enthalten.
Cloud-zu-Cloud-Verknüpfung	Cloud-zu-Cloud für die Kontoverknüpfung	Damit können Sie die Kontoverknüpfung starten, um cloudverbundene Geräte direkt aus Ihrer App mit Google Home zu teilen. Um die Benutzerfreundlichkeit zu verbessern, empfehlen wir die Verwendung der Deep-Link-Funktion (verfügbar für Android und iOS), die Nutzer direkt zu Ihrer spezifischen Kontoverknüpfungsseite in Google Home Assistant führt.
Inbetriebnahme-API unter Android	Matter-Inbetriebnahme	Obwohl diese API im Allgemeinen als eine Möglichkeit zur Inbetriebnahme neuer Matter-Geräte gedacht ist, kann sie auch verwendet werden, um die Google-Fabric zu Matter-Geräten hinzuzufügen, die bereits für eine andere Fabric in Betrieb genommen wurden. Daher ist es ein nützliches Tool für den Onboarding-Prozess.

Technische Implementierung

Wie Sie die Freigabeprozesse gestalten, hängt davon ab, mit welchen Geräten Sie Inhalte mit Google teilen möchten.

In den folgenden Fällen empfehlen wir, die Schritte in der angegebenen Reihenfolge auszuführen. So können wir Nutzern eine bessere Gesamterfahrung bieten.

Sie stellen nur Matter-Geräte her.

Sie stellen Matter-kompatible Geräte her, die Sie in Google Home in Betrieb nehmen möchten.

Rufen Sie die Permissions API unter Android auf.
Rufen Sie die Commissioning API on Android auf jedem Matter-Gerät auf, das zuvor in einer anderen Struktur in Betrieb genommen wurde.
1. Da die Freigabe von Matter für jedes Gerät einzeln erfolgen muss und viele Bildschirme Nutzereingaben erfordern, empfehlen wir, den Nutzer durch diesen Prozess zu führen, indem Sie:
  - Nutzern eine Liste der Matter-Geräte zur Verfügung stellen, die nicht für Google freigegeben werden.
  - Nutzer können den Vorgang zur Gerätefreigabe (über die Commissioning API) starten, indem sie in dieser Liste auf Geräte klicken.
  - Zurück zur Liste der Matter-Geräte, in der dem Nutzer der Aufgabenfortschritt und der Freigabestatus angezeigt werden.

Sie stellen nur Geräte her, die über Cloud-to-Cloud-APIs mit Google geteilt werden.

Cloud-to-cloudDeeplinks einrichten Dadurch werden die Geräte dem Google Home Graph hinzugefügt.
1. Wir empfehlen, zuerst die Cloud-to-cloud-Verknüpfung durchzuführen, um potenziell verwirrende Situationen zu vermeiden, z. B. wenn dem Nutzer eine Liste mit Geräten angezeigt wird, die mit Google geteilt werden, und Geräten, die nicht mit Google geteilt werden.
Rufen Sie die Permissions API unter Android auf.

Sie stellen sowohl Cloud-to-Cloud- als auch Matter-Geräte her.

Cloud-to-cloudDeeplinks einrichten
1. Wir empfehlen, zuerst die Cloud-to-cloud-Verknüpfung durchzuführen, um potenziell verwirrende Situationen zu vermeiden, z. B. wenn dem Nutzer eine Liste mit Geräten angezeigt wird, die mit Google geteilt werden, und Geräten, die nicht mit Google geteilt werden.
Rufen Sie die Permissions API unter Android auf.
Rufen Sie die Commissioning API for Android auf jedem Matter-Gerät auf, das zuvor für einen anderen Fabric in Betrieb genommen wurde.
1. Da die Freigabe von Matter für jedes Gerät einzeln erfolgen muss und viele Bildschirme Nutzereingaben erfordern, empfehlen wir, den Nutzer durch diesen Prozess zu führen, indem Sie:
  - Nutzern eine Liste der Matter-Geräte zur Verfügung stellen, die nicht für Google freigegeben werden.
  - Nutzer können den Vorgang zur Gerätefreigabe (über die Commissioning API) starten, indem sie in dieser Liste auf Geräte klicken.
  - Zurück zur Liste der Matter-Geräte, in der dem Nutzer der Aufgabenfortschritt und der Freigabestatus angezeigt werden.

Sie haben keine Geräte, die Sie mit Google teilen können

Rufen Sie die Permissions API auf.

UX-Best Practices

Dieser Abschnitt enthält einige wichtige Nutzeraktionen, die bei der Entwicklung einer App mit den Home APIs berücksichtigt werden sollten.

Wo kann die Gerätefreigabe in der App eingeführt werden?

Diese Liste ist nicht vollständig. Möglicherweise gibt es weitere Möglichkeiten, deinen Nutzern rechtzeitig Informationen zu Google Home und zur Freigabe zu präsentieren.

Diese schließen sich auch nicht gegenseitig aus und es gibt mehrere Einstiegspunkte:

Über ein Menü „Einstellungen“

Menü „Einstellungen“ als Einstiegspunkt — Abbildung 1. Einstellungen als Einstiegspunkt

Nutzer sind es wahrscheinlich gewohnt, Verbindungen mit ihren Google Home-Ökosystemen über ein Einstellungsmenü einzurichten. Mit dieser Methode können sie dieses Paradigma beibehalten.

Möglicherweise möchten Sie die Gerätefreigabe (Cloud-to-cloud-Verknüpfung und Matter Commissioning API) von den App-Berechtigungen (Permissions API) trennen. So können Nutzer selbst entscheiden, welche Schritte sie ausführen, und Sie haben die Möglichkeit, ihnen den Verbindungsstatus anzuzeigen.

Geräte in von Google ausgeführten Automatisierungen verwenden

Auf dem Tab „Automatisierungen“ konnten Nutzer auf einen Einstiegspunkt für den Freigabefluss tippen, einen Bildschirm mit einem Wertversprechen aufrufen, auf dem die Vorteile des weiteren Vorgehens klar erläutert wurden, und dann schnell den Berechtigungsfluss durchlaufen.

Einstiegspunkt über eine Google-basierte Automatisierung — Abbildung 2. Einstiegspunkt über eine von Google gesteuerte Automatisierung

Nur bei der Inbetriebnahme

Dieses Szenario ist hauptsächlich für Partner gedacht, die nur Matter-Geräte (keine Cloud-to-cloud-Geräte) herstellen und keine eigene Matter-Plattform haben. Der Einstiegspunkt für den Nutzer kann direkt nach einem Bildschirm vom Typ „Out-of-Box“ erfolgen, auf dem die Freigabe von Matter-Geräten (über die Commissioning API) und die App-Berechtigungen (über die Permissions API) Teil desselben Nutzererfahrungsablaufs sind.

Abbildung 3. Einstiegspunkt nur über die Inbetriebnahme

Freigabelogik

Hier einige Vorschläge für Nutzer-Prompts:

Sie sollten Nutzer in der Regel nur auffordern, die fehlenden Schritte auszuführen, die für die Registrierung auf der Plattform erforderlich sind. Langjährige Kunden teilen beispielsweise möglicherweise bereits Geräte eines OEM mit Google. In diesem Fall müssen sie nur den Prozess zum Erteilen von Berechtigungen für die Home APIs durchlaufen, um der App Zugriff auf ihr Google-Zuhause zu gewähren.
Mehrere Google Home-Administratoren können sich einen Google Home-Haushalt teilen. In einigen Fällen wird nur ein Konto verwendet, um Geräte für Google freizugeben. Daher sollte die Verknüpfung von Cloud-to-cloud keine Voraussetzung für die Aufforderung zur Erteilung von Berechtigungen für Home-APIs sein.

Vorschläge für das visuelle Design

Ein klarer Vorteil der Einrichtung für Google Home (z. B. „Erstelle erweiterte Automatisierungen mit Google Home“ oder „Geräte mit Apps deiner Wahl steuern“).
Ein Call-to-Action (z. B. „Jetzt loslegen“) und eine Möglichkeit zum Abbrechen, wenn der Nutzer nicht fortfahren möchte.
Wenn genügend Platz vorhanden ist, sollte erklärt werden, was passiert, wenn der Nutzer die einzelnen Bildschirme durchläuft.
Bei Matter kannst du, wenn der Nutzer dir zuvor über die Home APIs Zugriff auf sein Zuhause gewährt hat, die Geräte in seinem Zuhause bei der Inbetriebnahme neuer Geräte mit Google Home teilen. Sie können beispielsweise ein Matter-Gerät zu Ihrem Fabric hinzufügen und den Nutzer dann auffordern, dieses Gerät dem Google-Fabric hinzuzufügen.

Inhaltsvorschläge

Nutzer vertrauen eher Inhalten, die sie verstehen und die einen Mehrwert bieten. Nutzer durch Bereitstellung von Informationen in die Lage versetzen, fundierte Entscheidungen zu treffen, einschließlich Kompromissen.

Die kritische Tonhöhe

Nutzer werden Geräte nicht weiter freigeben, wenn es keinen überzeugenden Grund dafür gibt.

Achten Sie besonders darauf, wie Sie das Angebot positionieren.
Machen Sie es verlockend, aber versprechen Sie nicht zu viel.
Wenn der Nutzer ein Gerät benötigt, das in deinem Vorschlag erwähnt wird, muss das klar angegeben werden, damit er nicht auf ein unerwartetes Hindernis stößt.
Sie haben möglicherweise nur eine Chance, diese Nutzer zu erreichen.

Best Practices

Beginnen Sie mit der Perspektive des Nutzers – dem „Was habe ich davon?“-Ansatz.
Ein Abschnittsblock sollte nicht mehr als vier Zeilen umfassen. Bei zu vielen Wörtern kann die Aufmerksamkeit des Nutzers nachlassen. Klarheit und Verständlichkeit können jedoch wichtiger sein als Kürze.
Automatisierungen machen Spaß! Wählen Sie ein interessantes, aber hilfreiches Beispiel aus, wenn der Platz es zulässt.
Versuchen Sie, einen spielerischen Tonfall anzuschlagen, sofern dies zu Ihrer Gesamtstrategie passt.
Verwenden Sie handlungsorientierte Formulierungen wie „Legen Sie los!“.

Onboarding-Abläufe für Endnutzer unter Android Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.