跳到内容
请注意::本文仅为方便您阅读而提供。本文由翻译软件自动翻译,可能未经校对。本文的英文版应被视为官方版本,您可在此找到最新信息。您可以在此处访问。

使用查询字符串自动填充表单字段

上次更新时间: 2026年7月27日

可与以下任何订阅一起使用,除非另有说明:

在将表单发送给联系人之前,通过在页面 URL 中添加查询字符串来自动填充表单字段。表单字段(包括隐藏字段)将根据添加的查询字符串自动填充。例如,您可以创建自定义 UTM 属性,并使用 UTM 参数来自动填充隐藏的表单字段

开始之前

  • 查询字符串无法自动填充依赖型表单字段
  • 依赖型表单字段无法根据查询字符串中的多个值进行触发。

使用预定义值创建静态查询字符串

要创建包含静态查询字符串的 URL,您需要复制需要自动填充的任何字段的内部属性名称,然后将其添加到页面 URL 的末尾。

复制该属性的内部名称

  1. 在 HubSpot 帐户中,单击顶部导航栏中的 “设置”图标
  2. 在左侧边栏菜单中,导航至“属性”
  3. 点击某个属性的名称以预填充值。
  4. 复制该属性的内部名称。了解有关内部属性名称的更多信息。
  5. 对于表单中需要自动填充值的其他属性,请重复此操作。

The contact property editor, displaying the property's internal name for the first name contact property.

使用静态查询字符串创建 URL

复制内部属性名称后,您可以设置要发送给联系人的页面 URL:

  1. 在浏览器中,导航至包含表单的页面。然后,复制该URL
  2. 在页面 URL 的末尾添加一个问号 (?)。如果页面 URL 已经包含查询参数,请改用“&”符号
  3. 在页面 URL 末尾添加属性的内部名称,后跟等号,再输入要自动填充到该字段中的值。请注意,根据属性的字段类型,添加值时需遵循相应规则:
    • 单选框:查询字符串必须包含“true”或“false”值,而非“是”或“否”。
    • 日期选择器:查询字符串必须包含YYYY-MM-DD格式的日期值。
    • 多选复选框:查询字符串值必须与该属性的值选项完全匹配,多个值之间用分号分隔。
    • 单选按钮/下拉菜单:查询字符串的值必须与该属性的值选项完全一致。
    • 适用于所有字段类型:在 创建查询字符串,这些规则适用于所有字段类型。
      • 属性值中的空格必须用 %20 分隔。
      • 多个不同的属性必须用“&”分隔。

包含静态查询字符串的示例 URL

创建包含静态查询字符串的 URL 后,您可以在电子邮件和网页等内容中将其用作链接。联系人点击该链接后,页面上的表单将自动填充查询字符串中预定义的值。以下是一个格式正确的静态查询字符串 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 托管页面时才能正常工作。
  • 如果 URL 指向的是HubSpot 独立表单页面,则此功能将无法正常工作。
  • 此外,包含动态查询字符串的 URL 必须放置在您的 HubSpot 内容中,或放置在已嵌入 HubSpot跟踪代码的外部页面上。

获取个性化令牌

获取创建查询字符串所需的个性化令牌。

  1. 在你的 HubSpot 帐户中,单击更多,然后导航到营销 > 电子邮件。如果你的帐户中未显示更多,请直接导航到营销 > 电子邮件
  2. 点击“创建电子邮件”或点击草稿邮件的名称
  3. 在富文本工具栏中,点击“个性化”。
  4. 设置您的个性化令牌:
    • 在对话框中,选择一个个性化标记,以便在表单中自动填充。
    • 插入个性化标记时,请选中“使用此属性的全局默认值”复选框
    • 根据需要继续添加其他个性化标记。
The marketing email editor, highlighting the "Personalize" option in the rich text toolbar. The dialog box to edit the personalization token displays the token type, token name, and the fallback value.
  1. 在富文本工具栏中,单击“更多”,然后 选择codef 源代码图标以查看电子邮件的 HTML 代码。
  2. 在源代码中,您将看到添加到邮件正文中的每个个性化令牌的原始代码。每个令牌都会被双大括号 {{ }} 包围。 选中一个令牌(例如:{{ contact.firstname }}),然后右键单击并选择“复制”
  3. 对于您希望在表单中预填充的任何个性化标记,请重复此操作。
  4. 在对话框底部,点击“取消”并关闭以 退出源代码编辑界面。

The marketing email editor's source code, highlighting the personalization token internal name.

使用动态查询字符串创建 URL

使用个性化令牌创建包含动态查询字符串的 URL。该 URL 可用作 HubSpot 内容(如电子邮件和页面)中的链接,或用于包含 HubSpot跟踪代码的外部页面。 如果联系人点击该链接,且查询字符串中的字段有已知值,则页面上的表单将自动填充其信息。

要创建包含动态查询字符串的 URL:

  1. 在浏览器中访问包含表单的页面,然后复制该URL
  2. 使用页面 URL 和个性化令牌,格式化您的动态查询字符串:
    • 在页面 URL 的末尾添加一个问号 (?)。如果页面 URL 已经包含查询参数,请改用“&”符号
    • 添加 属性的 内部名称 ,后跟等号和个性化令牌。确保从令牌中删除所有空格(例如:{{contact.firstname}})。
    • 多个属性之间请用“&”分隔。

以下是一个包含格式正确的动态查询字符串的 URL 示例:

http://www.domain.com/marketing-offer?firstname={{contact.firstname}}&lastname={{contact.lastname}}&email={{contact.email}}

下一步

了解如何通过隐藏表单字段传递联系人属性值

New Call-to-action
这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助