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

将 HubSpot 属性映射到 Salesforce 字段

上次更新时间: 2025年10月15日

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

安装 HubSpot-Salesforce 集成后,你可以设置和管理 HubSpot 属性与 Salesforce 联系人、公司和交易字段之间的同步。

创建或编辑字段映射

添加新字段映射

  1. 在 HubSpot 帐户中,单击顶部导航栏中的settings设置图标。在左侧栏菜单中,导航到集成 > 连接的应用程序
  2. 在已连接应用程序列表中,单击Salesforce
  3. 单击要映射对象的选项卡:联系人公司交易
  4. 单击[对象] 属性映射选项卡。

请注意:HubSpot 和 Salesforce 之间的公司或交易必须打开对象同步,才能设置公司或交易字段映射。

Screenshot showing the tab to create contact property mappings for the Salesforce integration in HubSpot.
  1. 要添加新的字段映射,请单击 "添加新字段映射"。
  2. 在右侧面板中,使用下拉菜单选择要映射的 HubSpot 属性和 Salesforce 字段。必须选择兼容的属性和字段映射才能创建映射。下表显示了可以同步到 Salesforce 的HubSpot 属性字段类型、相应的 API 名称以及匹配的 Salesforce 字段类型。
HubSpot 属性字段类型 Salesforce 字段类型
下拉选择/单选

拾取列表、引用

多个复选框 多选列表
单复选框 布尔
数字 双/整数
单行文本 字符串、文本框
多行文本 文本框
日期选择器 日期、日期时间

请注意

  • 如果出现类型不匹配,或所选属性或字段已被映射,下拉菜单上方会显示一条信息。点击该信息了解更多信息。
  • 任何HubSpot 用户字段类型的自定义属性都不能映射到 Salesforce 字段。

Screenshot showing an error message in HubSpot when the selected property is already mapped or if there is a type mismatch.

  1. 单击下一步

选择同步规则

  1. 映射的同步规则决定了数据在 HubSpot 和 Salesforce 之间的同步方式。从以下选项中选择一个同步规则
    • 除非空白,否则首选 Salesforce
      • 只有当 Salesforce 中当前没有值时,HubSpot 才会将值传递给 Salesforce。
      • 如果 Salesforce 中存在值,该值将始终覆盖 HubSpot 中的现有值。
      • 如果在 Salesforce 中删除值,HubSpot 中也会删除该值。
    • 始终使用 Salesforce
      • 即使Salesforce中没有值,HubSpot也不会把数据传给Salesforce。
      • 如果 Salesforce 中有值,该值将始终覆盖 HubSpot 中的现有值。
      • 如果你删除 Salesforce 中的值,HubSpot 中的值也会被删除。
    • 双向
      • 最新值将始终覆盖任何现有值。
      • 如果在 HubSpot 中删除值,也会在 Salesforce 中删除,反之亦然。
    • 不同步
      • 数据永远不会在 HubSpot 和 Salesforce 之间传递。
      • 如果在 HubSpot 中删除了值,则不会在 Salesforce 中删除,反之亦然。

Screenshot showing how to select the sync rule for a new property mapping in HubSpot.


请注意
  • 虽然您的 HubSpot 帐户可能会显示首选 Salesforce,但除非"所有者 "映射为空白,否则 "所有者 "映射只能在 HubSpot 和 Salesforce 之间进行双向映射。所有者字段值必须在 HubSpot 和 Salesforce 之间完全匹配。
  • 新创建映射中的现有值不会追溯同步。要同步现有值,可以从 Salesforce 同步卡手动重新同步 HubSpot 中的记录,重新同步 HubSpot 段以将值批量同步到 Salesforce,或运行Salesforce 导入以将值批量同步到 HubSpot。
  1. 单击 "保存 "保存映射。

现在,新映射将出现在所选对象的映射列表中。要编辑现有映射,请将鼠标悬停在该映射上,然后单击 "编辑映射"。

添加映射后,单击打开同步 [对象]开关,开始将选定对象与 Salesforce 同步。对于联系人,默认情况下是打开的,无法关闭。

Screenshot showing the sync toggle for the Company object.

请注意:每个对象有 500 个字段映射的限制。

解决字段映射错误

当字段映射有错误或需要更新时,数据可能无法在 HubSpot 和 Salesforce 之间传递。修复或刷新字段映射:

  1. 在 HubSpot 帐户中,单击顶部导航栏中的settings设置图标。在左侧栏菜单中,导航到集成 > 连接的应用程序
  2. 单击Salesforce
  3. 单击 "同步健康状况"选项卡。
  4. 如果存在任何同步错误或警告,它们将显示在 "同步错误"部分。单击同步错误类型可查看更多信息、受影响的记录并采取进一步措施。
  5. 如果映射包含 Salesforce 挑选列表字段,你可以刷新该字段,检查 Salesforce 中是否有新的挑选列表选项,并将这些选项添加到 HubSpot 中相应的下拉菜单属性中。为此,请将鼠标悬停在映射上,然后单击 "刷新"。

请注意:批量重新同步公司/账户字段映射时,HubSpot 无法同时同步超过 200,000 家公司。这可能会导致 "我们无法同步您对此映射的所有更新"错误。

删除自定义字段映射

如果不想再同步自定义字段映射中的 HubSpot 属性和 Salesforce 字段之间的数据,可以删除映射。

请注意:只有自定义字段映射可以在 HubSpot 中删除。虽然标准字段映射不能删除,但可以通过将更新规则设置为 "不同步 "来停止数据同步。这不适用于取消订阅所有电子邮件 联系人属性。

  1. 在 HubSpot 帐户中,单击顶部导航栏中的settings设置图标。在左侧栏菜单中,导航到集成 > 连接的应用程序
  2. 单击Salesforce
  3. 单击映射的对象选项卡:联系人公司交易
  4. 单击[对象] 属性映射选项卡。
  5. 将鼠标悬停在映射上,然后单击 "删除映射"。

Screenshot showing the option to delete a mapping.

导出字段映射

导出字段映射列表:

  1. 在 HubSpot 帐户中,单击顶部导航栏中的settings设置图标。在左侧栏菜单中,导航到集成 > 连接的应用程序。 导出字段映射列表
  2. 单击Salesforce
  3. 单击要导出映射的对象选项卡:联系人公司交易
  4. 单击[对象] 属性映射选项卡。
  5. 单击导出字段映射 (CSV)
这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助