Google 助理連結

您可以產生網址,讓網址直接連結至特定動作的意圖。使用者在網路瀏覽器或行動瀏覽器中點選 Google 助理連結 (舊稱「動作連結」) 後,系統就會將他們導向裝置上的 Google 助理,讓使用者直接與動作互動。

Google 助理連結與目錄網頁連結不同,後者會將使用者帶往 Google 助理目錄中的「動作」頁面。

以下列舉一些 Google 助理連結相當實用:

  • 從操作說明網站將使用者導向語音導引指示。
  • 從說明網頁引導使用者取得客戶服務。
  • 將使用者連結至更新意圖,以便選擇加入日後的更新。

您可以透過 Actions 主控台從專案產生 Google 助理連結。您可以透過所有部署管道 (Alpha 版、Beta 版和正式版) 取得 Google 助理連結。舉例來說,如果您的動作 Alpha 版已啟用 Google 助理連結,則 Alpha 版測試人員可使用該連結。

如要產生動作的網址,請按照下列步驟操作:

  1. 動作主控台中,依序前往「部署」>「Google 助理連結」
  2. 針對「Intent」(意圖),選取要產生連結的意圖。
  3. 啟用「要啟用在 Intent_name 的連結嗎?」選項。
  4. (選用) 在「Campaign parameters」(廣告活動參數) 部分中,輸入您想在連結中擷取的網址參數,並納入網址參數。
  5. (選用) 輸入「連結標題」。請使用此標題來說明動作的用途。舉例來說,如果您的動作會將使用者帶往交易流程,以便購買演唱會門票,則連結標題可以是「購買演唱會門票」。

輸入資訊後,你可以查看及複製 Google 助理連結產生的網址或產生的程式碼片段。每當你想引導使用者進行這項特定動作時,請使用 Google 助理連結。

您可以透過模擬器或裝置,針對任何意圖 (主要或自訂,無論是否有參數) 測試 Google 助理連結。

如要在裝置上測試 Google 助理連結,請按照下列步驟操作:

  1. 在 Actions 主控台產生 Google 助理連結
  2. 以網址形式傳送 Google 助理連結,透過電子郵件、即時通訊訊息或其他格式傳送給自己。
  3. 在支援 Google 助理的裝置上,使用當初建立動作專案的帳戶登入 Google 助理。
  4. 在同一裝置上,點選你寄給自己的 Google 助理連結。

確認 Google 助理連結運作正常後,您必須重新部署動作,才能提供該連結給使用者。

您可以視需要在 Google 助理連結中加入意圖和參數。使用「廣告活動參數」部分,新增廣告活動參數。

當 Google 助理連結不含其他參數時,Google 助理會連結至動作的 MAIN 意圖 (actions.intent.MAIN),如下所示:

  • 如果您未在 Google 助理連結中明確啟用 MAIN 意圖,Google 助理會比對沒有任何意圖的主要意圖,做法與「對 app_name 交談」的行為類似。
  • 如果您明確啟用 MAIN 意圖,Google 助理會將參數傳遞給「動作」。

以下是使用 MAIN 意圖的 Google 助理連結網址,不包含額外參數:

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

Google 助理連結網址的語法如下:

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

可設定的網址參數如下表所示:

網址參數 說明
$action_id 動作的數字 ID。
$intent 內建或使用者意圖的全名。
$param 動作套件中指定的意圖參數全名。
$value 動作套件中宣告 $param 的類型網址編碼值。
$utm_param 一或多個 Urchin 流量監視器 (UTM) 參數類型清單。有效值包括:utm_sourceutm_mediumutm_campaignutm_termutm_content
$utm_value UTM 參數的字串值。

如果 Google 助理連結包含內建意圖 (意圖開頭為 actions.intent.),Google 助理會嘗試擷取網址中的任何內建意圖參數,並傳遞至動作中。系統會移除 Google 助理無法解讀內建意圖參數的參數。

針對對話動作,Google 助理會將這些參數傳送至執行要求,做為 AppRequest 訊息的一部分。

以下範例說明如何指定 Google 助理連結網址,其中含有單一意圖參數的內建意圖:

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

針對使用者意圖,Google 助理只會擷取動作定義的參數做為意圖的一部分,並捨棄其他參數。

以下範例說明如何指定包含使用者意圖的 Google 助理連結網址:

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

針對上述範例網址,Google 助理在 AppRequest 中新增 JSON 物件,如下所示:

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

Urchin 流量監視器 (UTM) 參數是指當使用者點擊 Google 助理連結時,Google 助理會傳送給動作的字串。您之後可以使用這些字串中包含的資訊進行分析。

Google 助理傳送給動作的 Urchin 流量監視器 (UTM) 參數包括:

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

以下範例說明如何指定包含 Urchin 流量監視器 (UTM) 參數的 Google 助理連結網址:

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

針對上述範例網址,Google 助理會在 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 助理連結,使用 help.js 增加動作的曝光度。使用者可以嘗試您的動作,並使用帳戶連結您的 Google 帳戶與服務。

使用者造訪網站時,會看到「試用 Google 助理」按鈕,用於觸發複合式 Google 助理連結流程。

啟用「動作」的帳戶連結功能後,就能透過任何支援 Google 助理的裝置存取你的動作。此外,使用者也可將自己的帳戶與您 Google 帳戶連結,藉此獲得更貼近個人需求的體驗。

搭配帳戶連結使用時,複合式 Google 助理連結會使用你的授權網址,也就是你在「動作」控制台的專案中設定的網址。詳情請參閱帳戶連結說明文件

必要條件

如要使用複合式搜尋結果連結,您需要:

本機開發

如要在網站中加入豐富的 Google 助理連結,請完成下列步驟:

  1. 在網頁上加入下列 JavaScript 程式庫,並將 <PROJECT_ID> 改成您的動作專案 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 助理連結流程,請使用 <google-assistant-proactive-link> 標記。套用這個代碼後,使用者第一次造訪網站時,連結就不會啟用,因此不會選取內嵌按鈕。

  1. id加入 Google 助理連結群組標記:

    <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>
    

Deployment

複合式 Google 連結僅適用於您擁有的網域,且已通過 Google 驗證。在本機開發時,您可以藉由存取「動作」專案、登入 Google 帳戶,並在指令碼標記中設定 dev=true 查詢參數,藉此略過這項規定。

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

透過複合式 Google 助理連結部署你的動作:

  1. 在 Actions 控制台中的「Deploy」>「Brand Verification」>「Connect Site」,註冊您的公開網域。
  2. 從指令碼中移除 dev=true 查詢參數:

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

限制和最佳做法

以下限制和最佳做法適用於 Google 助理連結網址,可在目錄中或其他 Google 服務外發布及參照:

  • 繼續支援所有 Google 助理連結。如果您發行的 Google 助理連結在之後中斷,您的動作專案可能會標示為健康狀態不良,並遭到下架。
  • 發布連結後,即支援從不信任的來源觸發。針對任何已連結的動作,請務必先與使用者確認,再進行實際操作。例如,關閉智慧型住宅設備的動作應提示使用者「您是否確定要關閉 $applianceName?」

    在此情況下,「實際操作」是指會影響使用者服務、資料、裝置、網路、電腦或 API 的任何動作。例如,傳送電子郵件、執行交易、修改智慧型住宅設備的狀態、建立訂閱項目或更新內容。