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

将 HubSpot 属性映射到 Salesforce 字段

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

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

安装 HubSpot 与 Salesforce 的集成后,请将 HubSpot 属性映射到 Salesforce 字段,以确保两个系统之间的数据保持一致。完成字段映射后,根据您的同步设置,一个系统中的更新将同步到另一个系统。 

例如,您可以将 HubSpot 中的“职位”等联系人属性映射到 Salesforce 的潜在客户或联系人字段,以保持两个平台上的记录保持一致。 

创建或编辑字段映射

添加新的字段映射

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

请注意:若要在 HubSpot 和 Salesforce 之间设置公司或商机字段映射,必须先开启“公司”或“商机”对象的同步功能。

  1. 要添加新的字段映射,请点击“添加新字段映射”。 
  2. 在右侧面板中,使用下拉菜单选择要映射的 HubSpot 属性及 Salesforce 字段。您必须选择兼容的属性和字段映射才能创建映射。下表列出了可与 Salesforce 同步的HubSpot 属性字段类型、对应的 API 名称以及匹配的 Salesforce 字段类型。
HubSpot 属性字段类型 Salesforce 字段类型
下拉选择/单选按钮

下拉列表、引用

多选复选框 多选列表
单选框 布尔
数字 双精度/整数
单行文本 字符串、文本区域
多行文本 textarea
日期选择器 日期, 日期时间

请注意:

  • 如果类型不匹配,或者您所选的属性或字段之一已映射,下拉菜单上方将显示一条消息。点击该消息以了解更多信息。
  • 任何类型为HubSpot 用户字段类型的自定义属性均无法映射到 Salesforce 字段。

 

  1. 点击“下一步”

选择同步规则

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

请注意:
  • 尽管您的 HubSpot 账户可能显示“所有者”映射的选项为“除非为空,否则优先使用 Salesforce”,但“所有者”映射仅支持 HubSpot 与 Salesforce 之间的双向映射。HubSpot 和 Salesforce 中的“所有者”字段值必须完全一致。 
  • 新创建的映射中不支持对现有值进行追溯同步。若需同步现有值,您可以通过 Salesforce 同步卡片在 HubSpot 中手动重新同步记录,重新同步 HubSpot 受众群体以批量同步值至 Salesforce,或运行Salesforce 导入操作以批量同步值至 HubSpot。
  1. 点击“保存”以保存映射。

新映射将显示在所选对象的映射列表中。要编辑现有映射,请将鼠标悬停在其上并点击“编辑映射”

添加映射后,点击“同步 [对象]”开关将其开启,即可开始将所选对象与 Salesforce 同步。对于联系人,此功能默认开启且无法关闭。 

请注意:每个对象的字段映射数量上限为 500 个。

所有者同步

在以下情况下,HubSpot 将 SalesforceStandardPowerPartnerGuestQueue用户识别为 Salesforce 所有者:

  • 它们 从 Salesforce
  • Salesforce 用户拥有与 HubSpot 同步的潜在客户、联系人、客户或商机记录。

默认情况下,Salesforce 潜在客户、联系人、账户或商机记录中的“所有者 ID”字段将同步到 HubSpot的“联系人/公司/商机所有者”属性。

所有者同步的工作原理

任何 Salesforce 所有者均可同步至 HubSpot,但只有姓名和电子邮件地址与活跃 Salesforce 用户完全匹配的 HubSpot 所有者才会同步至 Salesforce。如果 HubSpot 尝试同步一个在 Salesforce 中不存在的所有者,则“所有者 ID”字段将重置为来自 Salesforce 的最后一个值。

Salesforce 所有者分配规则在联系人、公司和商机中有所不同。根据规则,HubSpot 可在 Salesforce 中创建新对象,或同步到现有的 Salesforce 对象。如果您使用时间线同步,请了解 了解活动

联系人所有者分配行为

如果 HubSpot 联系人创建了新的 Salesforce 潜在客户,且在首次同步至 Salesforce 之前,该联系人已被分配给一名与活跃 Salesforce 用户姓名和电子邮件地址相匹配的 HubSpot 所有者,则该所有者将被分配至 Salesforce。否则, 则将应用 Salesforce 潜在客户分配规则 将生效。

在 HubSpot 或 Salesforce 中完成初始负责人分配后,对 HubSpot 中“联系人负责人”属性或 Salesforce 中“负责人 ID”字段的任何更改都将同步到另一系统。

如果 HubSpot 联系人同步到一个已有 Salesforce 潜在客户(且该潜在客户已有活跃的 Salesforce 负责人),则 Salesforce 潜在客户分配规则将适用,首次同步时将保留现有的 Salesforce 负责人。在后续同步中,最新的负责人值将更新到另一系统中。

请注意:Salesforce 要求记录必须具有“所有者”值。当未分配所有者的 HubSpot 记录同步到 Salesforce 并创建新记录时,其“所有者”将设置为创建该记录的 Salesforce 用户,即 HubSpot 账户中的集成用户。

将 Salesforce 引用字段映射到 HubSpot

Salesforce 引用字段的值在同步至 HubSpot 时将以 18位记录 ID 的形式呈现,而非标签。虽然 HubSpot 无法自动检索这些标签,但您可以将 Salesforce 引用字段映射到 HubSpot 下拉属性,以便在 HubSpot 中将这些值用于细分和报告。 

  1. 在您的 HubSpot 账户中,创建一个下拉选择字段类型的 HubSpot 自定义属性
  2. 将 Salesforce 引用字段映射到新创建的 HubSpot 自定义属性
  3. 在 HubSpot 帐户中,单击顶部导航栏中的 settings “设置”图标
  4. 在左侧边栏菜单中,导航至“属性”
  5. 点击字段映射中使用的自定义字段名称
  6. 在左侧边栏菜单中,点击“字段类型”。 
  7. “下拉选项”部分,“内部名称”列将显示来自 Salesforce 的每个引用字段值的 18 位记录 ID。在“标签”字段中输入来自 Salesforce 的对应字段值标签
  8. 在右上角,点击“保存”

现在,您可以根据字段值的标签(而非记录 ID)对引用字段进行细分。

请注意:此 方法需要持续维护。如果 Salesforce 引用字段中添加了新值,则必须按照上述步骤手动编辑 HubSpot 属性中相应选项的标签。

解决字段映射错误

当字段映射存在错误或需要更新时,数据可能无法在 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. 将鼠标悬停在映射上,然后点击“删除映射”。

导出字段映射

要导出字段映射列表:

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