App Discovery とディープリンク

ユーザーがスマート デバイスを Google Assistant に接続し、Google Home Graph のストラクチャや部屋に割り当てる際に、主に使用するのが Google Home app (GHA) です。通常、セットアップを実行するには、複数の画面を順番に移動し、利用可能なオプションの中から Cloud-to-cloud 統合を選択します。しかし、ユーザーがもっと簡単にセットアップできるようにすれば、オンボーディングがより迅速になり、セットアップに関するユーザーの不満も軽減できます。

Google smart home プラットフォームには、smart home デバイスのユーザー オンボーディングを合理化するための便利な機能が用意されています。これらの機能を使用してセットアップ フローを簡単にすることで、ユーザーがよりスムーズに smart home デバイスを使い始められるようになります。これらの機能は、コードをほとんど(あるいはまったく)記述しなくても、Cloud-to-cloud 統合に簡単に統合できます。

ユーザーは、Assistant 用にスマート デバイスをセットアップする際に、以下のプラットフォーム機能を実装できます。

  • App Discovery: この機能を使用すると、Cloud-to-cloud 統合にリンクした候補ワードを GHA に表示できます。ユーザーが候補ワードをクリックすると、サードパーティのプロバイダ アカウントを使用して、smart home デバイスを Assistant に接続できます。
  • ディープリンク: この機能を使用してアプリや製品サイトにディープリンクを埋め込むと、ユーザーが smart home デバイスを Assistant に簡単に接続できるようになります。ユーザーがディープリンクをクリックすると、GHA のダウンロード(まだインストールされていない場合)を求めるメッセージが表示され、アカウントのリンクと部屋の割り当てを設定するためのフローが始まります。

App Discovery を実装する

ブランド確認プロセスが完了していれば、Google Home Developer Console から App Discovery 機能を有効にできます。コード変更は必要ありませんが、Cloud-to-cloud 統合がすでに審査済みで、本番環境で稼働している必要があります。

Developer Console にログインします。

Developer Console に移動する

  1. Cloud-to-cloud 統合プロジェクトを開きます。

  2. [会社プロフィール] をクリックします。

  3. 会社プロフィールを作成するの手順に沿って、会社のウェブサイトを統合プロジェクトに接続します。

Google Home へのディープリンクを設定する

ディープリンクを使用すると、Android アプリまたは iOS アプリから、GHA 内の特定のリンク先に直接移動できます。これにより、Assistant を使用してデバイスを簡単にセットアップできるようになります。

GHA ディープリンクの構文は次のとおりです。

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

現在のところ、Android アプリまたは iOS アプリから直接移動できる GHA 内のリンク先は次のとおりです。

目的地 説明
setup/ha_linking?agent_id=agent-id 指定した Cloud-to-cloud 統合の agent-id OAuth アカウントのリンクフローを開始します。

リンク先パスは、ディープリンクに適用する前に URL エンコードする必要があります。次に例を示します。

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

アプリ内からディープリンクをトリガーする方法について詳しくは、関連する Android のドキュメントまたは iOS のドキュメントをご覧ください。