Google 助理連結

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

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

Google 助理連結在以下情況中相當實用:

  • 將使用者導向操作說明網站上的語音導覽操作說明。
  • 從說明頁面將使用者導向客戶服務體驗。
  • 將使用者導向更新意圖,以便他們選擇 未來更新

你可以在動作主控台中透過專案產生 Google 助理連結。 所有部署管道 (Alpha 版、Beta 版、 和正式版群組)。舉例來說,如果您的 Google 助理連結已啟用 Alpha 版

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

  1. 動作控制台中,依序前往「部署」>「部署」Google 助理連結
  2. 在「Intent」Intent部分,選取要產生連結的意圖。
  3. 啟用「Would you like to enable links for intent_name?」選項。
  4. (選用) 在「廣告活動參數」部分,輸入您想要的任何資訊 額外擷取連結做為網址參數。
  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 意圖,但不含 其他參數:

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',
}

UTM 參數是 Google 助理傳送給 使用者點選 Google 助理連結時的動作。您可以使用 這些字串稍後用於數據分析

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

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

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

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 助理連結會使用您在 Actions 主控台專案中設定的授權網址。詳情請參閱帳戶連結說明文件

必要條件

如要使用複合式助理連結,必須符合下列條件:

本機開發

如要在網站中加入複合式 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 主控台的「部署」>「部署」下方註冊您的公開網域品牌驗證 >連結網站
  2. 從指令碼中移除 dev=true 查詢參數:

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

限制和最佳做法

請遵守下列限制和最佳做法,確保 Google 助理連結網址 可在目錄之外,或其他 Google 服務:

  • 繼續支援所有 Google 助理連結。如果您將某個應用程式 稍後中斷的 Google 助理連結,系統可能會將 Actions 專案標記為 並且被下架
  • 發布連結即表示你支援透過不受信任的來源觸發動作。對於任何 已連結的動作,您必須明確與使用者確認,才能採取任何因應措施 會用於模擬例如關閉智慧型住宅的動作 設備應該會提示使用者說 「確定要關閉$applianceName嗎?」

    在此情況下,實際操作是指任何會影響使用者 服務、資料、裝置、網路、電腦或 API舉例來說,傳送 執行交易, 變更智慧型住宅的狀態 設備、建立訂閱或更新內容。