Onboarding-Abläufe für Endnutzer unter Android

In diesem Leitfaden finden Sie UX-Hinweise zum Design nahtloser Google Home APIs-Geräteberechtigungen und -Freigaben für das Onboarding in Ihrer Anwendung.

Die Hauptthemen sind:

• Warum Geräte für Google Home freigeben?
• Wichtige Phasen des Freigabeprozesses
• Technische Implementierung
• UX-Best Practices

Warum Geräte für Google Home freigeben?

Um die Funktionen der Home APIs nutzen zu können, müssen Nutzer ihre Geräte für Google Home freigeben. Das hat folgende Gründe:

• Es ist eine technische Voraussetzung, damit Google diese Geräte in Automatisierungen verwenden kann.
• Es trägt zu einer konsistenten und flexiblen Google Home-Nutzererfahrung bei.
  • Es ist wichtig, dass Geräte in allen Apps, die Home APIs verwenden, einheitlich dargestellt werden. So wird vermieden, dass Nutzer zwischen Apps wechseln müssen, um grundlegende Aufgaben zu erledigen, was zu einer fragmentierten und verwirrenden Nutzererfahrung führen kann.

Wichtige Komponenten des Freigabeprozesses

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 können, muss Ihre App die Berechtigung haben, auf Geräte im Zuhause des Nutzers zuzugreifen (in der API als die Struktur 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	Ermöglicht es Ihnen, den Prozess der Kontoverknüpfung zu starten, um cloudbasierte Geräte aus Ihrer App heraus für Google Home freizugeben. Um die Nutzerfreundlichkeit zu verbessern, empfehlen wir die Verwendung der Deep-Link- Funktion (sowohl unter Android als auch unter iOS verfügbar), die Nutzer direkt zu Ihrer spezifischen Seite für die Kontoverknüpfung in GHA weiterleitet.
Commissioning API unter Android	Matter-Inbetriebnahme	Diese API wird im Allgemeinen als API zur Inbetriebnahme neuer Matter Geräte betrachtet. Sie können sie aber auch verwenden, um die Google-Fabric zu Matter Geräten hinzuzufügen, die bereits für eine andere Fabric in Betrieb genommen wurden. Daher ist sie ein nützliches Tool für das Onboarding.

Technische Implementierung

Wie Sie die Freigabeprozesse erstellen, hängt davon ab, welche Geräte Sie für Google freigeben möchten.

Für die folgenden Szenarien empfehlen wir, die Schritte in der angegebenen Reihenfolge auszuführen. So können Sie Nutzern eine bessere Gesamterfahrung bieten.

Sie stellen nur Matter-Geräte her

Sie stellen Matter-fähige Geräte her, die Sie für Google Home in Betrieb nehmen möchten.

1. Rufen Sie die Permissions API unter Android auf.

2. Rufen Sie die Commissioning API unter Android auf jedem Matter Gerät auf, das zuvor für eine andere Fabric in Betrieb genommen wurde.

   1. Da die Matter Freigabe für jedes Gerät einzeln erfolgen muss und viele Bildschirme eine Nutzereingabe erfordern, empfehlen wir, den Nutzer durch diesen Prozess zu führen:
      • Geben Sie Nutzern eine Liste der Matter-Geräte, die nicht für Google freigegeben werden.
      • Ermöglichen Sie Nutzern, den Gerätefreigabeprozess (mit der Commissioning API) zu starten, indem sie auf Geräte in dieser Liste klicken.
      • Kehren Sie zur Liste der Matter-Geräte zurück und zeigen Sie dem Nutzer den Aufgabenfortschritt und den Freigabestatus an.

Sie stellen nur Geräte her, die mit Cloud-zu-Cloud-APIs für Google freigegeben werden

1. Führen Sie Cloud-to-cloud Deep-Linking durch. 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 für Google freigegeben werden, und Geräten, die nicht für Google freigegeben werden.

2. Rufen Sie die Permissions API unter Android auf.

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

1. Führen Sie Cloud-to-cloud Deep-Linking durch.

   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 für Google freigegeben werden, und Geräten, die nicht für Google freigegeben werden.

2. Rufen Sie die Permissions API unter Android auf.

3. Rufen Sie die Commissioning API für Android auf jedem Matter Gerät auf, das zuvor für eine andere Fabric in Betrieb genommen wurde.

   1. Da die Matter Freigabe für jedes Gerät einzeln erfolgen muss und viele Bildschirme eine Nutzereingabe erfordern, empfehlen wir, den Nutzer durch diesen Prozess zu führen:
      • Geben Sie Nutzern eine Liste der Matter-Geräte, die nicht für Google freigegeben werden.
      • Ermöglichen Sie Nutzern, den Gerätefreigabeprozess (mit der Commissioning API) zu starten, indem sie auf Geräte in dieser Liste klicken.
      • Kehren Sie zur Liste der Matter-Geräte zurück und zeigen Sie dem Nutzer den Aufgabenfortschritt und den Freigabestatus an.

Sie haben keine Geräte, die Sie für Google freigeben können

Rufen Sie die Permissions API auf.

UX-Best Practices

In diesem Abschnitt werden einige wichtige Nutzerverhaltensweisen beschrieben, die Sie bei der Entwicklung einer App berücksichtigen sollten, die die Home APIs nutzt.

Wo Sie die Gerätefreigabe in der App einführen sollten

Diese Liste ist nicht vollständig. Möglicherweise finden Sie weitere Möglichkeiten, Ihren Nutzern rechtzeitig Google Home vorzustellen und ihnen die Freigabe zu ermöglichen.

Diese sind auch nicht gegenseitig ausschließend und es gibt mehrere Einstiegspunkte:

Über ein Menü „Einstellungen“

Da Nutzer es wahrscheinlich gewohnt sind, Verbindungen mit ihren Google Home-Ökosystemen über ein Menü „Einstellungen“ einzurichten, können sie mit dieser Methode dieses Paradigma fortsetzen.

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

Bei der Verwendung von Geräten in von Google ausgeführten Automatisierungen

Auf dem Tab „Automatisierungen“ können Nutzer auf einen Einstiegspunkt zum Freigabeprozess tippen, einen Bildschirm mit einem Wertversprechen lesen, in dem die Vorteile der Fortsetzung klar erläutert werden, und dann schnell den Berechtigungsprozess durchlaufen.

Nur über die Inbetriebnahme

Dieses Szenario ist hauptsächlich für Partner gedacht, die nur Matter-Geräte herstellen (keine Cloud-to-cloud Geräte) und keine eigene Matter Fabric haben. Der Einstieg punkt 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-Berechtigung (über die Permissions API) Teil desselben Nutzererfahrungsprozesses sind.

Freigabelogik

Hier einige Vorschläge für Nutzeraufforderungen:

• Sie sollten Nutzer im Allgemeinen nur auffordern, die fehlenden Schritte auszuführen, die für das Onboarding der Plattform erforderlich sind. Langjährige Kunden geben beispielsweise möglicherweise bereits Geräte eines OEM für Google frei. In diesem Fall müssen sie nur den Prozess zur Erteilung von Berechtigungen für die Home APIs durchlaufen, um der App Zugriff auf ihr Google Home zu gewähren.

• Mehrere Google Home-Administratoren geben möglicherweise eine Google Home-Struktur frei. In einigen Fällen wird möglicherweise nur ein Konto verwendet, um Geräte für Google freizugeben. Daher sollte die Cloud-to-cloud Verknüpfung keine Voraussetzung für die Aufforderung zur Erteilung von Berechtigungen für die Home APIs sein.

Vorschläge für das visuelle Design

• Ein klarer Vorteil des Onboardings bei Google Home (z. B. „Erstellen Sie erweiterte Automatisierungen mit Google Home“ oder „Geräte mit Apps Ihrer Wahl steuern“).

• Ein Call-to-Action (z. B. „Jetzt starten“) und eine Möglichkeit zum Abbrechen, wenn der Nutzer nicht fortfahren möchte.

• Wenn Platz vorhanden ist, eine Erklärung, was passiert, wenn der Nutzer die Bildschirme durchläuft.

• Wenn der Nutzer Ihnen bereits über die Home APIs Zugriff auf sein Zuhause gewährt hat, können Sie ihm ermöglichen, die Geräte in seinem Zuhause für Google Home freizugeben, wenn er neue Geräte in Betrieb nimmt.Matter Sie können beispielsweise ein Matter Gerät zu Ihrer Fabric hinzufügen und den Nutzer dann auffordern, dieses Gerät der Google-Fabric hinzuzufügen.

Inhaltsvorschläge

Nutzer vertrauen eher etwas, das sie verstehen und das einen Mehrwert bietet. Geben Sie Nutzern Informationen, damit sie fundierte Entscheidungen treffen können, einschließlich der Kompromisse.

Das entscheidende Verkaufsgespräch

Nutzer werden Geräte nicht 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 Ihrem Verkaufsgespräch erwähnt wird, muss dies klar angegeben werden, damit er nicht auf ein unerwartetes Hindernis stößt.
• Möglicherweise haben Sie nur eine Chance, diese Nutzer zu gewinnen. Nutzen Sie sie also.

Best Practices

1. Beginnen Sie aus der Sicht des Nutzers – mit dem Ansatz „Was habe ich davon?“.
2. Schreiben Sie nicht mehr als vier Zeilen Inhalt in einen Abschnittsblock. Mehr Wörter können die Aufmerksamkeit des Nutzers ablenken. Klarheit und Verständlichkeit können jedoch wichtiger sein als Kürze.
3. Automatisierungen machen Spaß! Wählen Sie ein spannendes, aber hilfreiches Beispiel, wenn Platz vorhanden ist.
4. Versuchen Sie, einen spielerischen Ton zu verwenden, wenn dies zu Ihrer Gesamtstrategie passt.
5. Verwenden Sie handlungsauffordernde Formulierungen wie „Jetzt starten“.