使用查詢字串自動填入表單欄位
上次更新時間: 2026年7月27日
在將表單傳送給您的聯絡人之前,透過在頁面網址中加入查詢字串,即可自動填入表單欄位。表單欄位(包括隱藏欄位)將根據所加入的查詢字串自動填入。例如,您可以建立自訂的 UTM 屬性,並使用 UTM 參數來自動填入隱藏的表單欄位。
開始之前
- 查詢字串無法自動填入依賴型表單欄位。
- 依賴型表單欄位無法根據查詢字串中的多個值來觸發。
建立包含預先定義值的靜態查詢字串
若要建立包含靜態查詢字串的網址,您需要複製任何欲自動填入的欄位的內部屬性名稱,然後將其新增至頁面網址的末尾。
複製該屬性的內部名稱
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的
「設定圖示」。 - 在左側邊欄選單中,導航至「屬性」。
- 點擊某個屬性的名稱以預先填入值。
- 複製該屬性的「內部名稱」。進一步了解內部屬性名稱。
- 對於表單中您希望自動填入值的任何其他屬性,請重複此步驟。

使用靜態查詢字串建立 URL
複製內部屬性名稱後,即可設定將傳送給聯絡人的頁面網址:
- 在瀏覽器中,導航至包含表單的頁面。接著,複製該網址。
- 在頁面網址末尾加上問號 (?)。若頁面網址已有查詢參數,則改為加上「&」符號。
- 在頁面網址末尾加入屬性的內部名稱,接著加上等號,然後是要用來自動填入該欄位的值。請注意,根據屬性欄位的類型,填入值的規則有所不同:
- 單一核取方塊:查詢字串必須包含「true」或「false」值,而非「是」或「否」。
- 日期選擇器:查詢字串必須包含YYYY-MM-DD格式的日期值。
- 多個核取方塊:查詢字串的值必須與該屬性的值選項完全一致,且多個值之間需以分號分隔。
- 單選鈕/下拉式選單:查詢字串的值必須與該屬性的值選項完全一致。
- 適用於所有欄位類型: 建立查詢字串時, 這些規則適用於所有欄位類型。
- 屬性值中的空格必須以 %20 分隔。
- 多個不同的屬性必須以「&」分隔。
包含靜態查詢字串的範例 URL
建立包含靜態查詢字串的網址後,您可將其作為連結,嵌入電子郵件或網頁等內容中。當聯絡人點擊該連結時,頁面上的表單會自動填入查詢字串中預先定義的值。以下是一個格式正確的靜態查詢字串網址範例及其解析:
http://www.domain.com/marketing-offer?firstname=John&lastname=Smith&email=jsmith@email.com&favorite_season=Winter%20Season&favorite_fast_food=Burger;Taco&number_property=7&will_you_come_to_the_party=Maybe&do_you_like_parties=true&date_of_party=2018-10-24
- 查詢字串開頭與單行文字欄位:?firstname=John
- 單行文字欄位:&lastname=Smith
- 單行文字欄位:&email=jsmith@email.com
- 下拉式選單欄位:&favorite_season=Winter%20Season
- 多選方塊欄位:&favorite_fast_food=漢堡;塔可
- 數字欄位:&favorite_number=7
- 單選按鈕欄位:&will_you_come_to_the_party=Maybe
- 單一核取方塊欄位:&do_you_like_parties=true
- 日期選擇器欄位:&date_of_party=2018-10-2
使用個人化標記建立動態查詢字串
需要訂閱 需具備Marketing HubProfessional 或 Enterprise訂閱方案,方可建立動態查詢字串。
使用個人化標記來建立動態查詢字串,這些查詢字串會根據已知的聯絡人屬性自動填入表單欄位。
請注意:
- 包含個人化標記的動態查詢字串,僅在 URL 導向至由 HubSpot 託管且包含 HubSpot 表單的頁面時,才會正常運作。
- 若網址指向的是HubSpot 獨立表單頁面,此功能將無法運作。
- 此外,包含動態查詢字串的網址必須置於您的 HubSpot 內容中,或置於已嵌入 HubSpot追蹤代碼的外部頁面中。
擷取個人化標記
檢索建立查詢字串所需的個人化代幣。
- 在你的 HubSpot 帳戶中,點擊「更多」,然後前往「行銷」 > 「電子郵件」。如果你的帳戶中沒有顯示「更多」,請直接前往「行銷」 > 「電子郵件」。
- 點擊「建立電子郵件」或點擊草稿電子郵件的名稱。
- 在富文本工具列中,點擊「個人化」。
- 設定您的個人化代碼:
- 在對話方塊中,選取一個個人化標記,系統將自動填入您的表單中。
- 插入個人化標記時,請勾選「使用此屬性的全域預設值」核取方塊 。
- 根據需要繼續新增其他個人化標記。
- 在富文本工具列中,按一下「更多」,然後 選取「codef 」原始碼圖示,以檢視電子郵件的 HTML 內容。
- 在原始碼中,您將看到已新增至電子郵件正文的每個個人化代碼的原始程式碼。每個代碼都會被雙大括號 {{ }} 包圍。 選取一個標記(例如:
{{ contact.firstname }}),然後按右鍵並選擇「複製」。 - 對於您希望在表單中預先填入的任何個人化標記,請重複此步驟。
- 在對話方塊底部,按一下「取消」並關閉視窗,以 退出原始碼編輯模式。

建立包含動態查詢字串的 URL
使用個人化標記來建立包含動態查詢字串的 URL。此 URL 可用作 HubSpot 內容(例如電子郵件和頁面)中的連結,或用於已嵌入 HubSpot追蹤程式碼的外部頁面。 若聯絡人點擊該連結,且查詢字串中的欄位具有已知值,則頁面上的表單將自動填入其資訊。
要建立包含動態查詢字串的網址:
- 在瀏覽器中,導航至包含表單的頁面。接著,複製該網址。
- 使用該頁面的網址和個人化標記,格式化您的動態查詢字串:
- 在頁面網址末尾加上問號 (?)。若頁面網址已有查詢參數,則改為加上「&」符號。
- 加入 屬性的 內部名稱 ,後接等號,再接個人化標記。請確保標記中已移除所有空格(例如:{{contact.firstname}})。
- 若有多個屬性,請以「&」分隔。
以下是一個 URL 範例,其中動態查詢字串的格式已正確設定:
http://www.domain.com/marketing-offer?firstname={{contact.firstname}}&lastname={{contact.lastname}}&email={{contact.email}}
下一步
瞭解如何透過隱藏表單欄位傳遞聯絡人屬性值。
