使用查询字符串自动填充表单字段
上次更新时间: 2026年7月20日
在将表单发送给联系人之前,通过在页面 URL 中添加查询字符串来自动填充表单字段。表单字段(包括隐藏字段)将根据添加的查询字符串自动填充。例如,您可以创建自定义 UTM 属性,并使用 UTM 参数来自动填充隐藏的表单字段。
开始之前
- 查询字符串无法自动填充依赖型表单字段。
- 依赖型表单字段无法根据查询字符串中的多个值进行触发。
使用预定义值创建静态查询字符串
要创建包含静态查询字符串的 URL,您需要复制需要自动填充的任何字段的内部属性名称,然后将其添加到页面 URL 的末尾。
复制该属性的内部名称
- 在 HubSpot 帐户中,单击顶部导航栏中的
“设置”图标。 - 在左侧边栏菜单中,导航至“属性”。
- 点击某个属性的名称以预填充值。
- 复制该属性的内部名称。了解有关内部属性名称的更多信息。
- 对于表单中需要自动填充值的其他属性,请重复此操作。
使用静态查询字符串创建 URL
复制内部属性名称后,您可以设置要发送给联系人的页面 URL:
- 在浏览器中,导航至包含表单的页面。然后,复制该URL。
- 在页面 URL 的末尾添加一个问号 (?)。
- 在页面 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跟踪代码的外部页面上。
获取个性化令牌
获取创建查询字符串所需的个性化令牌。
- 在你的 HubSpot 帐户中,单击更多,然后导航到营销 > 电子邮件。如果你的帐户中未显示更多,请直接导航到营销 > 电子邮件。
- 点击“创建电子邮件”或点击草稿邮件的名称。
- 在富文本工具栏中,点击“个性化”。
- 设置您的个性化令牌:
- 在对话框中,选择一个个性化标记,以便在表单中自动填充。
- 插入个性化标记时,请选中“使用此属性的全局默认值”复选框 。
- 根据需要继续添加其他个性化标记。
- 在富文本工具栏中,单击“更多”,然后 选择codef 源代码图标以查看电子邮件的 HTML 代码。
- 在源代码中,您将看到添加到邮件正文中的每个个性化令牌的原始代码。每个令牌都会被双大括号 {{ }} 包围。 选中一个令牌(例如:
{{ contact.firstname }}),然后右键单击并选择“复制”。 - 对于您希望在表单中预填充的任何个性化标记,请重复此操作。
- 在对话框底部,点击“取消”并关闭以 退出源代码编辑界面。
使用动态查询字符串创建 URL
使用个性化令牌创建包含动态查询字符串的 URL。该 URL 可用作 HubSpot 内容(如电子邮件和页面)中的链接,或作为包含 HubSpot跟踪代码的外部页面。 如果联系人点击该链接,且查询字符串中的字段有已知值,则页面上的表单将自动填充其信息。
要创建包含动态查询字符串的 URL:
- 在浏览器中访问包含表单的页面,然后复制该URL。
- 使用页面 URL 和个性化令牌,按以下格式构建动态查询字符串:
- 在页面 URL 的末尾添加一个问号 (?)。
- 添加 属性的 内部名称 ,后跟等号和个性化令牌。确保从令牌中删除所有空格(例如:{{contact.firstname}})。
- 多个属性之间请用“&”分隔。
- 以下是一个包含格式正确的动态查询字符串的 URL 示例:
http://www.domain.com/marketing-offer?firstname={{contact.firstname}}&lastname={{contact.lastname}}&email={{contact.email}}
下一步
了解如何通过隐藏表单字段传递联系人属性值。