您可以產生直接連結至動作特定意圖的網址。使用者在網頁或行動瀏覽器中點選 Google 助理連結 (舊稱「動作連結」) 時,系統會將他們導向裝置上的 Google 助理,以便直接與動作互動。
Google 助理連結與目錄網頁連結不同,後者會將使用者導向 Google 助理目錄中的動作頁面。
以下是一些適合使用 Google 助理連結的情況:
- 將使用者導向解說網站提供的語音導覽操作說明。
- 讓使用者從說明頁面連結至客戶服務體驗。
- 將使用者連結至更新意圖,方便他們選擇接收日後的更新。
產生 Google 助理連結
您可以透過 Actions 主控台,在自己的專案中產生 Google 助理連結。 所有部署管道 (Alpha 版、Beta 版和正式版) 皆可使用 Google 助理連結。舉例來說,如果動作的 Alpha 版本啟用了您的 Google 助理連結,那麼 Alpha 測試人員能夠使用這個連結。
如要產生動作的網址,請按照下列步驟操作:
- 在動作控制台中,依序前往「部署」>「Google 助理連結」。
- 在「Intent」(意圖) 部分,選取要產生連結的意圖。
- 啟用「Would you like to enable link for intent_name?」選項。
- (選用) 在「Campaign parameters」(廣告活動參數) 部分中,輸入您想在連結中另外擷取的任何資訊做為網址參數。
- (選用) 輸入「連結標題」。請使用這個標題說明動作的用途。舉例來說,如果您的動作讓使用者透過交易流程購買演唱會門票,則連結標題可以是「購買演唱會門票」。
輸入資訊後,您可以查看和複製產生的網址,或產生的 Google 助理連結的程式碼片段。如果您希望使用者前往這項特定動作,請使用 Google 助理連結。
測試 Google 助理連結
您可以透過模擬器或裝置測試任何意圖 (主要或自訂,無論是否包含參數) 的 Google 助理連結。
如要在裝置上測試 Google 助理連結,請按照下列步驟操作:
- 在 Actions 控制台中產生 Google 助理連結。
- 以電子郵件、即時通訊訊息或其他格式將 Google 助理連結以網址的形式傳送給自己。
- 在支援 Google 助理的裝置上,以建立動作專案時所用的帳戶登入 Google 助理。
- 在同一部裝置上,按一下傳送給自己的「Google 助理」連結。
確認 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 助理連結網址規格
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.PLAY_GAME¶m.name=%22ExampleGame%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',
}
使用 Urchin 流量監視器 (UTM) 參數的 Google 助理連結網址
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 助理連結,您可以使用 help.js,提高動作在自家網站上的曝光率。使用者可以試用您的動作,以及透過帳戶連結將自己的 Google 帳戶連結至您的服務。
使用者造訪您的網站時,會看到「使用 Google 助理試用」按鈕,觸發了豐富的 Google 助理連結流程。
為動作啟用帳戶連結功能後,使用者就能在任何支援 Google 助理的裝置上存取動作。此外,使用者可以將自己的帳戶與您的 Google 帳戶連結,進而享有更貼近個人需求的服務。
搭配帳戶連結時,互動式 Google 助理連結會使用你在 Actions 主控台的專案中設定的授權網址。詳情請參閱帳戶連結說明文件。
必要條件
如要使用互動式 Google 助理連結,你必須符合下列條件:
- 動作專案。
- 已為動作啟用 Google 助理連結。
- (選用) 您的動作已啟用帳戶連結。
本機開發
如要在網站中加入豐富的 Google 助理連結,請完成下列步驟:
在網頁中加入下列 JavaScript 程式庫,並將
<PROJECT_ID>
替換成您的動作專案 ID:<script async src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true"> </script>
在網頁的某個位置新增以下 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>
標記。套用此代碼時,連結會在使用者第一次造訪時啟用,且使用者未選取內嵌按鈕。
將
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>
在網頁上放置
<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 助理連結部署動作:
- 在 Actions 控制台的「Deploy」(部署) >「Brand Verification」(品牌驗證) >「Connect Site」(連結網站) 下方,註冊你的公開網域。
從指令碼中移除
dev=true
查詢參數:<script async src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}"> </script>
限制與最佳做法
請務必遵守下列限制和最佳做法,以便將 Google 助理連結網址發布至目錄或其他 Google 服務以外的位置: