App Discovery とディープリンク

Google Home app (GHA) は、ユーザーがスマート デバイスを Google Assistant に接続し、Google Home Graph のストラクチャと部屋に割り当てる主要な方法です。通常、ユーザーは複数の画面をクリックして、使用可能なオプションのリストから smart home アクションを探します。ユーザーが設定プロセスを簡単に開始できるようにすることで、オンボーディングの時間を短縮し、ユーザーによる設定への不満を軽減できます。

smart home デバイスでのユーザー オンボーディングを合理化するために、Google smart home プラットフォームには、ユーザーがセットアップ フローにすばやく入って smart home デバイスの使用を開始することができる便利な機能がいくつか用意されています。これらの機能は、コーディング作業をほとんどまたはまったく行わずに、smart home アクションに簡単に統合できます。

次のリストは、ユーザーが Assistant 用にスマート デバイスをセットアップする際に実装できるプラットフォーム機能をまとめたものです。

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

App Discovery を実装する

App Discovery 機能は、ブランド確認プロセスの完了後に Actions on Google Console から有効にできます。コードの変更は必要ありませんが、smart home アクションはすでにレビューされ、本番環境で動作している必要があります。

Actions Console にログインします。

Actions on Google コンソールに移動

  1. smart home アクション プロジェクトを開きます。
  2. [Deploy](デプロイ)> [Brand Verification](ブランドの確認)をクリックします。
  3. 会社のウェブサイトを Actions プロジェクトに接続するには、次の手順を行います。
    1. [Websites](ウェブサイト)パネルで、[Connect site](サイトを接続)をクリックします。
    2. 接続したいウェブサイトの URL を入力して、[Connect](接続)をクリックします。 Google からウェブサイトの所有者に、ウェブサイトの関連付けを確認するメールが送信されます。
  4. [Android apps](Android アプリ)パネルで [Connect app](アプリを接続)ボタンをクリックし、表示される手順に従います。

  5. 同じパネルで、接続されたアプリの [Enable app discovery](App Discovery を有効にする)をオンにします。このオプションは、アクションが審査されて承認されるまではグレー表示になっています。

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

ディープリンクを使用すると、Android アプリや iOS アプリから、GHA 内の特定のデスティネーションにユーザーを直接誘導できます。これにより、Assistant により、デバイスのセットアップ プロセスが簡単になります。

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

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

Android アプリまたは iOS アプリは現在、GHA 内の次のデスティネーションにリンクできます。

宛先 説明
setup/ha_linking?agent_id=agent-id 指定された smart home アクションの agent-id に関する OAuth アカウントのリンクフロー

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

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

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