アシスタントのリンク

アクションの特定のインテントに直接リンクする URL を生成できます。 ユーザーがウェブブラウザまたはモバイル ブラウザでアシスタントのリンク(以前のアクション リンク)をクリックすると、 ユーザーがデバイス上のアシスタントから、アクションと直接やり取りします。

アシスタントのリンクは、ユーザーにメッセージを送信するためのディレクトリ ウェブリンクとは異なります アシスタント ディレクトリのアクションのページに移動します。

アシスタントのリンクは次のような場合に便利です。

  • ハウツー ウェブサイトから音声ガイド付きの手順にユーザーをリンクする。
  • ヘルプページからカスタマー サポートにユーザーを誘導する。
  • 更新インテントにユーザーをリンクして、ユーザーがオプトインできるようにする おすすめします。

アシスタントのリンクは、Actions Console のプロジェクト内から生成できます。 アシスタントのリンクは、すべてのデプロイ チャネル(アルファ版、ベータ版、 本番環境)。たとえば、アルファ版でアシスタントのリンクが有効になっている場合、 リリースすると、アルファ版テスターはこのリンクを使用できます。

アクションの URL を生成する手順は次のとおりです。

  1. Actions Console で、[Deploy(デプロイ)] >アシスタントのリンクをご覧ください。
  2. [Intent] で、リンクを生成するインテントを選択します。
  3. [Would you like to enable linking for intent_name?] オプションを有効にします。
  4. (省略可)[キャンペーン パラメータ] に、必要な情報を入力します。 URL パラメータとしてリンク内にキャプチャできます。
  5. (省略可)[リンクのタイトル] を入力します。このタイトルを使用して、アクションの機能を説明します。対象 たとえば、アクションによってユーザーが購入のために取引フローを中断した場合。 チケットを購入する場合、リンクのタイトルは「コンサート チケットの購入」にします。

情報を入力した後、生成された URL を表示したりコピーしたりできます。また、 生成されたアシスタント リンクのコード スニペットです。どこにいてもアシスタントのリンクを使用できます 特定のアクションにユーザーを誘導したいと 考えています

あらゆるインテント(メインまたはカスタム、使用の有無は問わない)でアシスタントのリンクをテストできます パラメータ)は、シミュレータまたはデバイスで渡されます。

デバイスでアシスタントのリンクをテストする手順は次のとおりです。

  1. Actions Console でアシスタントのリンクを生成します。
  2. メールやチャット メッセージなどで、自分にアシスタントのリンクを URL として送信します。 使用できます。
  3. アシスタント搭載デバイスで、同じアカウントで Google アシスタントにログインする コードを使用してアクション プロジェクトを作成します。
  4. 同じデバイスで、自分に送信したアシスタント リンクをクリックします。

アシスタント リンクが想定どおりに機能することを確認したら、再デプロイする必要があります ユーザーがそのリンクを利用できるようにします。

アシスタント リンクには、必要に応じて URL にインテントとパラメータを含めることができます。こちらの [キャンペーン パラメータ] セクションでキャンペーン パラメータを追加します。

アシスタントのリンクに追加パラメータが含まれていない場合、Google アシスタントは次のリンクにリンクします: アクションの MAIN インテント(actions.intent.MAIN)を、以下に置き換えます。 動作:

  • アシスタントのリンクで MAIN インテントを明示的に有効にしていない場合は、 Google アシスタントがパラメータなしでメイン インテントをマッチングします。 「app_name と話したい」の動作が変わります。
  • MAIN インテントを明示的に有効にした場合、アシスタントはパラメータを渡す 追加できます

MAIN インテントを使用したアシスタントのリンク URL の例 追加パラメータ:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4

アシスタント リンクの URL の一般的な構文は次のとおりです。

https://assistant.google.com/services/invoke[/$action_id][?intent=$intent&param.$param=$value][&$utm_param=$utm_value]

設定可能な URL パラメータの説明を次の表に示します。

URL パラメータ 説明
$action_id アクションの数値 ID。
$intent 組み込みインテントまたはユーザー インテントのフルネーム。
$param アクション パッケージで指定されたインテント パラメータの完全な名前。
$value $param に対して宣言された型の URL エンコード値 アクション パッケージ。
$utm_param 1 つ以上の UTM パラメータ型を含むリスト。有効な値は次のとおりです。 utm_source さん、utm_medium さん、 utm_campaign さん、utm_term さん、 utm_content
$utm_value UTM パラメータの文字列値。

アシスタントのリンクに組み込みインテントactions.intent. など)、Google アシスタントは組み込みインテントを抽出して、 パラメータを追加してアクションに渡します。特定の値を持つ 組み込みインテントのパラメータが削除されたことをアシスタントが理解できない。

会話型アクションの場合、アシスタントは以下のパラメータをフルフィルメントに送信します。 AppRequest メッセージの一部として使用できます。

次の例は、表示されるアシスタント リンク URL を指定する方法を示しています。 単一のインテント パラメータを持つ組み込みインテントが含まれています。

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.PLAY_GAME&param.name=%22ExampleGame%22

ユーザーのインテントの場合、Google アシスタントは 他のパラメータは破棄されます。

次の例は、表示されるアシスタント リンク URL を指定する方法を示しています。 にユーザー インテントが含まれています。

https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK&param.topic=sports

上記の URL の例では、アシスタントは AppRequest に JSON オブジェクトを追加します。 次のようになります。

argument {
  name: 'topic',
  raw_text: 'sports',
  text_value: 'sports',
}

UTM パラメータは、Google アシスタントが ユーザーがアシスタントのリンクをクリックしたときのアクション。使用すると、 後で分析に使用することもできます。

アシスタントがアクションに送信する UTM パラメータは次のとおりです。

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

次の例は、表示されるアシスタント リンク URL を指定する方法を示しています。 UTM パラメータを含む:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale

上記の URL の例では、アシスタントは AppRequest 件のメッセージ:

argument {
  name: 'utm_source',
  raw_text: 'Google',
  text_value: 'Google',
}
argument {
  name: 'utm_medium',
  raw_text: 'email',
  text_value: 'email',
}
argument {
  name: 'utm_campaign',
  raw_text: 'holiday sale',
  text_value: 'holiday sale',
}

リッチ アシスタント リンクを使用すると、アクションの見つけやすさが向上します。 ウェブサイトを作成しますユーザーはアクションを試したり、 アカウントのリンクを使用して、Google アカウントとサービスの関連付け。

ユーザーがウェブサイトにアクセスすると、「Google アシスタントで試す」と表示されます。 ボタンを押すと、リッチ アシスタントのリンクフローがトリガーされます。

アクションでアカウントのリンクを有効にすると、ユーザーはすべてのアシスタント搭載デバイスでアクションにアクセスできるようになります。また、ユーザーは自分のアカウントをデベロッパーのサービスにリンクして、Google アカウントにリンクすることで、よりパーソナライズされたエクスペリエンスを提供できます。

アカウントのリンク設定で使用する場合、リッチ アシスタントのリンクでは、アクション コンソールでプロジェクトで設定した認証 URL が使用されます。詳しくは、アカウントのリンクに関するドキュメントをご覧ください。

前提条件

リッチ アシスタントのリンクを使用するには、次のものが必要です。

ローカルでの開発

ウェブサイトにリッチ アシスタントのリンクを追加する手順は次のとおりです。

  1. 次の JavaScript ライブラリをページに追加して、<PROJECT_ID> を Actions プロジェクト ID に置き換えます。

    <script async
    src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
    </script>
    
  2. 次の HTML タグをページの任意の場所に追加します。インラインの「Google アシスタントで試してみる」が読み込まれます。ボタン:

    <google-assistant-link-group>
      <!-- One or more <google-assistant-link> tags -->
      <google-assistant-link href="{ASSISTANT_LINK_1}">
      </google-assistant-link>
      <google-assistant-link href="{ASSISTANT_LINK_2}">
      </google-assistant-link>
    </google-assistant-link-group>
    

プロアクティブなトリガー

ユーザーがページに初めてアクセスしたときにリッチ アシスタント リンクのフローを自動的に開始するには、<google-assistant-proactive-link> タグを使用します。このタグを適用すると、初回訪問時にインライン ボタンを選択しなくてもリンクが有効になります。

  1. アシスタント リンクグループタグに id を追加します。

    <google-assistant-link-group id="my-group">
      <!-- One or more <google-assistant-link> tags -->
      <google-assistant-link href="{ASSISTANT_LINK_1}">
      </google-assistant-link>
      <google-assistant-link href="{ASSISTANT_LINK_2}">
      </google-assistant-link>
    </google-assistant-link-group>
    
  2. ウェブページに <google-assistant-proactive-action-link> タグを配置し、その groupId 属性を id に設定します。

    <google-assistant-link-group id="my-group">
      <!-- One or more <google-assistant-link> tags -->
      <google-assistant-link href="{ASSISTANT_LINK_1}">
      </google-assistant-link>
      <google-assistant-link href="{ASSISTANT_LINK_2}">
      </google-assistant-link>
    </google-assistant-link-group>
    
    <google-assistant-proactive-link
    groupId="my-group">
    </google-assistant-proactive-link>
    

デプロイ

リッチ アシスタントのリンクは、ご自身が所有する Google の所有権を証明済みのドメインでのみ利用できます。ローカルで開発する場合は、Actions プロジェクトにアクセスして Google アカウントにログインし、スクリプトタグで dev=true クエリ パラメータを設定することで、この要件を回避できます。

  <script async
    src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
  </script>

アシスタントのリッチリンクを使用してアクションをデプロイするには:

  1. Actions Console の [Deploy >ブランドの確認 >サイトを接続をご覧ください。
  2. スクリプトから dev=true クエリ パラメータを削除します。

    <script async
    src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}">
    </script>
    

制限事項とベスト プラクティス

以下の制限とおすすめの方法が適用されるため、アシスタントのリンク URL ディレクトリや Google Workspace の外部の サービス:

  • 引き続きすべてのアシスタントのリンクをサポートしてください。アプリケーションを配布する場合、 アシスタント リンクが後で解除されると、Actions プロジェクトが 削除されます
  • リンクを公開するということは、信頼できないソースからの呼び出しをサポートすることを意味します。任意の アクションを実行する前に明示的に確認する必要があります。 実践していきます。たとえば、スマートホームをオフにするアクションなどです。 アプライアンスから $applianceName をオフにしてもよろしいですか?」

    ここでいう「実際の操作」とは、ユーザーの操作に影響を及ぼす サービス、データ、デバイス、ネットワーク、コンピュータ、または API です。たとえば、 メール、取引の実行、スマートホームのステータスの変更 サブスクリプションの作成、コンテンツの更新などを行う必要はありません。