将 HubSpot 属性映射到 Salesforce 字段

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

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

创建或编辑字段映射

添加新的字段映射

1. 在 HubSpot 帐户中，单击顶部导航栏中的设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 在已连接的应用程序列表中，点击Salesforce。
3. 转到“数据同步”选项卡。 
4. 在左侧边栏菜单中，点击您要映射的对象的选项卡。 
   
5. 然后点击“属性映射”。 

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

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

HubSpot 属性字段类型	Salesforce 字段类型
下拉菜单/单选按钮	下拉列表、引用
多选复选框	多选列表
单选框	布尔型
数字	double/int
单行文本	字符串、文本区域
多行文本	textarea
日期选择器	日期, 日期时间

请注意：

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

 

8. 点击“下一步”。

选择一条同步规则

9. 映射的同步规则决定了数据在 HubSpot 和 Salesforce 之间的同步方式。请从以下选项中选择一个同步规则：

• • 除非为空，否则优先使用 Salesforce
    • 只有当 Salesforce 中当前没有该值时，HubSpot 才会将该值传递给 Salesforce。

• • • 如果 Salesforce 中已存在该值，则该值将始终覆盖 HubSpot 中的现有值。
    • 如果您在 Salesforce 中删除了该值，该值在 HubSpot 中也会被删除。
  • 始终使用 Salesforce
    • HubSpot绝不会将数据传递给 Salesforce，即使 Salesforce 中没有该值也是如此。
    • 如果 Salesforce 中存在该值，该值将始终覆盖 HubSpot 中的现有值。
    • 如果您在 Salesforce 中删除了该值，该值在 HubSpot 中也会被删除。
  • 双向
    • 最新值将始终覆盖任何现有值。 
    • 如果在 HubSpot 中删除了该值，该值在 Salesforce 中也会被删除，反之亦然。
  • 不同步
    • 数据绝不会在 HubSpot 和 Salesforce 之间传递。
    • 如果在 HubSpot 中删除了该值，该值在 Salesforce中不会被删除，反之亦然。

10. 点击“保存”以保存映射。

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

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

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

所有者同步

在以下情况下，HubSpot 将 Salesforce标准用户、PowerPartner 用户、访客用户和 队列用户识别为 Salesforce 所有者：

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

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

所有者同步的工作原理

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

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

联系人所有者分配行为

如果某个 HubSpot 联系人创建了新的 Salesforce 潜在客户，且在首次同步到 Salesforce 之前，该潜在客户被分配的 HubSpot 所有者与某个活跃 Salesforce 用户的姓名和电子邮件地址相匹配，则该所有者将被分配到 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 帐户中，单击顶部导航栏中的 “设置”图标。
4. 在左侧边栏菜单中，导航至“属性”。
5. 点击字段映射中使用的自定义属性的名称。
6. 在左侧边栏菜单中，点击“字段类型”。 
7. 在“下拉选项”部分，“内部名称”列将显示来自 Salesforce 的每个引用字段值的 18 位记录 ID。请在“标签”字段中输入来自 Salesforce 的相应字段值标签。
8. 在右上角，点击“保存”。

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

解决字段映射错误

当字段映射存在错误或需要更新时，HubSpot 与 Salesforce 之间可能无法传输数据。要修复或刷新字段映射：

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

请注意：在批量重新同步公司/账户字段映射时，HubSpot 无法同时同步超过 200,000 家公司。这可能会导致“无法同步此映射的所有更新”错误。

删除自定义字段映射

如果您不再希望在自定义字段映射中同步 HubSpot 属性与 Salesforce 字段之间的数据，可以删除该映射。

请注意：在 HubSpot 中仅可删除自定义字段映射。虽然标准字段映射无法删除，但可通过将更新规则设置为“不同步”来停止数据同步。此规则不适用于“已从所有电子邮件联系人中 取消订阅”属性。 

1. 在 HubSpot 帐户中，单击顶部导航栏中的设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 点击“Salesforce”。
3. 导航至“数据同步”选项卡。 
4. 在左侧边栏菜单中，点击您映射对应的“对象”选项卡。 
5. 然后点击“属性映射”。 
6. 将鼠标悬停在映射上，然后点击“删除映射”。

导出字段映射

要导出字段映射列表：

1. 在 HubSpot 帐户中，单击顶部导航栏中的设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 点击“Salesforce”。 
3. 导航至“数据同步”选项卡。 
4. 在左侧边栏菜单中，点击要导出的映射对应的“对象”选项卡。 
5. 然后点击“属性映射”。 
6. 点击“导出字段映射（CSV）”。