連結至動作 (Dialogflow)

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

以下是一些實用的 Google 助理連結範例:

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

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

  1. Actions Console 中,依序前往「Develop」(開發) >「Actions」(動作)
  2. 按一下要產生連結的動作。
  3. 在「連結」部分下方,啟用「您希望為這個動作啟用網址」
  4. 輸入「連結標題」。這個標題應包含用來描述動作用途的動詞。舉例來說,如果您的動作讓使用者從交易流程購買演唱會門票,則可使用「購買演唱會門票」這個實用的連結標題。
  5. 點按「儲存」

您可以複製提供的網址,並視需求參照該網址,以便將使用者導向這項特定動作。

Google 助理連結可以選擇在網址中加入意圖和參數。Google 會根據網址中指定的意圖類型處理參數。

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.GET_HOROSCOPE&param.astrologySign=%22cancer%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’,
}

如未在 Google 助理連結中指定意圖,Google 預設會連結至動作的 MAIN 意圖 (actions.intent.MAIN),並採取以下行為:

  • 如果您未在 Google 助理連結中明確啟用 MAIN 意圖,Google 會觸發不含任何參數的主要意圖,類似於「與 app_name」一樣的行為。
  • 如果您明確啟用 MAIN 意圖,Google 會將參數傳遞至動作。

以下範例說明如何指定無意圖的 Google 助理連結網址:

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

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 助理連結。

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

  1. 在控制台中啟用 Google 助理連結。
  2. 請使用你建立 Actions on Google 專案時所用的帳戶登入 Google 助理。
  3. 製作可點按的 Google 助理連結 (電子郵件、即時通訊、文件等項目)。
  4. 在支援 Google 助理的裝置上,按一下在上一個步驟中建立的連結。

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

限制與最佳做法

現在起,你的 Google 助理連結網址可能會在目錄或其他 Google 服務以外的位置發布和參照,因此請注意以下限制和最佳做法:

  • 請務必繼續支援所有 Google 助理連結。如果您發布了 Google 助理連結,但該連結之後無法正常運作,我們可能會將你的 Actions 專案標記為健康狀態不良並下架。
  • 透過發布連結,您可以支援從不受信任的來源觸發觸發的功能。針對任何連結的動作,您請務必先向使用者明確進行確認,再採取「實際操作」。舉例來說,如果動作會關閉智慧型住宅設備,使用者應可看到「確定要關閉 $applianceName 嗎?」的提示。

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