您可以產生網址,直接連到特定動作。使用者在網頁或行動瀏覽器中點選 Google 助理連結 (舊稱「動作連結」) 時,系統會將他們導向至裝置上的 Google 助理,並透過該連結直接與對應動作互動。
以下是一些實用的 Google 助理連結範例:
- 將使用者導向解說網站提供的語音導覽操作說明。
- 讓使用者從「取得說明」頁面連結到客戶服務體驗。
- 將使用者導向更新意圖,方便他們選擇接收您日後的更新。
如要為動作產生網址,請按照下列步驟操作:
- 在 Actions Console 中,依序前往「Develop」(開發) >「Actions」(動作)。
- 按一下要產生連結的動作。
- 在「連結」部分下方,啟用「您希望為這個動作啟用網址」。
- 輸入「連結標題」。這個標題應包含用來描述動作用途的動詞。舉例來說,如果您的動作讓使用者從交易流程購買演唱會門票,則可使用「購買演唱會門票」這個實用的連結標題。
- 點按「儲存」。
您可以複製提供的網址,並視需求參照該網址,以便將使用者導向這項特定動作。
Google 助理連結參數
Google 助理連結可以選擇在網址中加入意圖和參數。Google 會根據網址中指定的意圖類型處理參數。
Google 助理連結網址規格
Google 助理連結網址的通用語法如下:
https://assistant.google.com/services/invoke[/$action_id][?intent=$intent¶m.$param=$value][&$utm_param=$utm_value]
下表說明您可以設定的網址參數:
網址參數 | 說明 |
---|---|
$action_id |
動作的數字 ID。 |
$intent |
內建或自訂意圖的全名。 |
$param |
在動作套件中指定的意圖參數全名。 |
$value |
動作套件中針對 $param 宣告類型的網址編碼值。 |
$utm_param |
一或多個 Urchin 流量監視器 (UTM) 參數類型的清單。有效值包括:utm_source 、utm_medium 、utm_campaign 、utm_term 和 utm_content 。 |
$utm_value |
Urchin 流量監視器 (UTM) 參數的字串值。 |
內建意圖的 Google 助理連結網址
如果 Google 助理連結包含內建意圖 (意圖以 actions.intent.*
開頭),Google 會嘗試擷取網址中的任何內建意圖參數,並傳遞至動作。系統會移除所有 Google 無法解讀的內建意圖參數。
如果是對話動作,Google 會將這些參數做為 AppRequest
訊息的一部分傳送至執行要求。
以下範例說明如何指定 Google 助理連結網址,其中包含只有單一意圖參數的內建意圖:
https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.GET_HOROSCOPE¶m.astrologySign=%22cancer%22
包含自訂意圖的 Google 助理連結網址
如為自訂意圖,Google 只會擷取動作在意圖中定義的參數,並捨棄任何其他參數。
以下範例說明如何指定包含自訂意圖的 Google 助理連結網址:
https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK¶m.topic=sports
針對上述範例網址,Google 會在 AppRequest
中新增 JSON 物件,如下所示:
argument {
name: ‘topic’,
raw_text: ‘sports’,
text_value: ‘sports’,
}
不含意圖的 Google 助理連結網址
如未在 Google 助理連結中指定意圖,Google 預設會連結至動作的 MAIN
意圖 (actions.intent.MAIN
),並採取以下行為:
- 如果您未在 Google 助理連結中明確啟用
MAIN
意圖,Google 會觸發不含任何參數的主要意圖,類似於「與 app_name」一樣的行為。 - 如果您明確啟用
MAIN
意圖,Google 會將參數傳遞至動作。
以下範例說明如何指定無意圖的 Google 助理連結網址:
https://assistant.google.com/services/invoke/uid/000000d139bbc4d4
Google 助理連結網址和 Urchin 流量監視器 (UTM) 參數
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 助理連結。
如要測試 Google 助理連結,請按照下列步驟操作:
- 在控制台中啟用 Google 助理連結。
- 請使用你建立 Actions on Google 專案時所用的帳戶登入 Google 助理。
- 製作可點按的 Google 助理連結 (電子郵件、即時通訊、文件等項目)。
- 在支援 Google 助理的裝置上,按一下在上一個步驟中建立的連結。
確認 Google 助理連結可正常運作後,您必須重新部署動作,使用者才能使用連結。
限制與最佳做法
現在起,你的 Google 助理連結網址可能會在目錄或其他 Google 服務以外的位置發布和參照,因此請注意以下限制和最佳做法:
- 請務必繼續支援所有 Google 助理連結。如果您發布了 Google 助理連結,但該連結之後無法正常運作,我們可能會將你的 Actions 專案標記為健康狀態不良並下架。
透過發布連結,您可以支援從不受信任的來源觸發觸發的功能。針對任何連結的動作,您請務必先向使用者明確進行確認,再採取「實際操作」。舉例來說,如果動作會關閉智慧型住宅設備,使用者應可看到「確定要關閉
$applianceName
嗎?」的提示。在這種情況下,「實際動作」是指影響使用者服務、資料、裝置、網路、電腦或 API 的任何動作。例如傳送電子郵件、執行交易、變更 Smart Home 設備的狀態、建立訂閱項目或更新內容。