Google 助理連結

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

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

以下是一些適合使用 Google 助理連結的情況:

  • 將使用者導向解說網站提供的語音導覽操作說明。
  • 讓使用者從說明頁面連結至客戶服務體驗。
  • 將使用者連結至更新意圖,方便他們選擇接收日後的更新。

您可以透過 Actions 主控台,在自己的專案中產生 Google 助理連結。 所有部署管道 (Alpha 版、Beta 版和正式版) 皆可使用 Google 助理連結。舉例來說,如果動作的 Alpha 版本啟用了您的 Google 助理連結,那麼 Alpha 測試人員能夠使用這個連結。

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

  1. 動作控制台中,依序前往「部署」>「Google 助理連結」
  2. 在「Intent」(意圖) 部分,選取要產生連結的意圖。
  3. 啟用「Would you like to enable link for 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 Urchin 流量監視器 (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 助理連結會使用你在 Actions 主控台的專案中設定的授權網址。詳情請參閱帳戶連結說明文件

必要條件

如要使用互動式 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>
    

部署作業

複合式 Google 助理連結僅適用於您所擁有並通過 Google 驗證的網域。在本機進行開發時,您必須具備 Actions 專案的存取權、登入您的 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 助理連結,系統可能會將動作專案標記為健康狀態不良並遭移除。
  • 透過發布連結,您可以支援從不受信任的來源觸發觸發的功能。針對任何連結的動作,您必須先向使用者明確確認,才能採取任何實際操作。舉例來說,如果動作會關閉「智慧型住宅」設備,系統應會顯示提示使用者:「Are you sure you want to off $applianceName?」

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