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

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

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

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

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

开始之前

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

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

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

复制该属性的内部名称

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

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

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

  1. 在浏览器中,导航至包含表单的页面。然后,复制该URL
  2. 在页面 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. 设置您的个性化令牌:
    • 在对话框中,选择一个个性化标记,以便在表单中自动填充。
    • 插入个性化标记时,请选中“使用此属性的全局默认值”复选框
    • 根据需要继续添加其他个性化标记。

  1. 在富文本工具栏中,单击“更多”,然后 选择codef 源代码图标以查看电子邮件的 HTML 代码。
  2. 在源代码中,您将看到添加到邮件正文中的每个个性化令牌的原始代码。每个令牌都会被双大括号 {{ }} 包围。 选中一个令牌(例如:{{ contact.firstname }}),然后右键单击并选择“复制”
  3. 对于您希望在表单中预填充的任何个性化标记,请重复此操作。
  4. 在对话框底部,点击“取消”并关闭以 退出源代码编辑界面。

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

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

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

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

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

下一步

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

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