HubSpot 连接

上次更新： 2023-11-02

主题：
Destinations
查看有关此主题的更多信息

创建对象：
Developer

User

Admin

Leader

HubSpot 是一个CRM平台，它提供了连接营销、销售、内容管理和客户服务所需的所有软件、集成和资源。它允许您在一个CRM平台上连接数据、团队和客户。

此 Adobe Experience Platform 目标利用 HubSpot 联系人API，以更新中的联系人 HubSpot 从现有Experience Platform受众进行激活。

向您的验证的说明 HubSpot 实例位于向目标进行身份验证部分。

用例

为了帮助您更好地了解您应该如何以及何时使用 HubSpot 目标，以下是Adobe Experience Platform客户可以使用此目标解决的示例用例。

HubSpot 联系人存储有关与您的业务互动的个人的信息。您的团队使用中存在的联系人 HubSpot 以构建Experience Platform受众。将这些受众发送至 HubSpot，将会更新其信息，并且会为每个联系人分配一个属性，其值作为指示联系人属于哪个受众的受众名称。

先决条件

请参阅以下部分，以了解需要在Experience Platform中设置的任何先决条件， HubSpot ，以了解在使用之前必须收集的信息 HubSpot 目标。

Experience Platform先决条件

将数据激活到之前 HubSpot 目标，您必须拥有架构， a 数据集、和受众创建于 Experience Platform.

请参阅Experience Platform文档受众成员资格详细信息架构字段组如果您需要有关受众状态的指南。

的先决条件 HubSpot 目标

请注意以下先决条件，以便将数据从Platform导出到 HubSpot 帐户：

您必须拥有 HubSpot 帐户

为了将数据从Platform导出到 Hubspot 您需要拥有 HubSpot 帐户。如果您还没有这样的网站，请访问设置您的HubSpot帐户并遵循相关指南注册和创建您的帐户。

收集 HubSpot 专用应用程序访问令牌

您需要您的 HubSpot Access token 以允许 HubSpot 通过进行API调用的目标 HubSpot 您的中的私有应用程序 HubSpot 帐户。此 Access token 将用作 Bearer token 当您验证目标.

如果您没有专用应用程序，请按照文档操作在中创建专用应用程序 HubSpot.

重要

应为专用应用程序分配以下范围：
crm.objects.contacts.write， crm.objects.contacts.read
crm.schemas.contacts.write, crm.schemas.contacts.read

凭据	描述	示例
`Bearer token`	此 `Access token` 的 HubSpot 专用应用程序。获取 HubSpot `Access token` 请遵循 HubSpot 文档目标使用应用程序的访问令牌进行API调用.	`pat-na1-11223344-abcde-12345-9876-1234a1b23456`

护栏

HubSpot 专用应用程序受速率限制. 您的专用应用程序可拨打的次数取决于您的 HubSpot 帐户订阅以及您是否购买了API加载项。此外，另请参阅其他限制.

支持的身份

HubSpot 支持更新下表中描述的标识。了解有关身份.

目标身份	示例	描述	注意事项
`email`	`test@test.com`	联系人的电子邮件地址。	必需

支持的受众

此部分介绍可导出到此目标的所有受众。

此目标支持激活通过Experience Platform生成的所有受众分段服务.

此目标还支持激活下表所述的受众。

受众类型	描述
自定义上传	受众已导入从CSV文件Experience Platform到。

导出类型和频率

有关目标导出类型和频率的信息，请参阅下表。

项目	类型	注释
导出类型	基于配置文件	您正在导出受众的所有成员以及所需的架构字段（例如：电子邮件地址、电话号码、姓氏），根据您的字段映射。此外，还会在中创建一个新资产 HubSpot 使用受众名称，且其值与Platform中每个选定受众对应的受众状态一致。
导出频率	流	流目标为基于API的“始终运行”连接。一旦根据受众评估在Experience Platform中更新了用户档案，连接器就会将更新发送到下游目标平台。详细了解流目标.

连接到目标

重要

要连接到目标，您需要 管理目标 访问控制权限. 阅读访问控制概述或与产品管理员联系以获取所需的权限。

要连接到此目标，请按照目标配置教程. 在配置目标工作流中，填写下面两个部分中列出的字段。

范围目标 > 目录搜索 HubSpot. 或者，您可以将其定位到 CRM 类别。

验证目标

填写下面的必填字段。请参阅收集 HubSpot 专用应用程序访问令牌部分获取任何指导。

持有者令牌：您的访问令牌 HubSpot 专用应用程序。

要验证目标，请选择 连接到目标.
显示如何进行身份验证的平台UI屏幕截图。

如果提供的详细信息有效，UI将显示 已连接 带有绿色复选标记的状态。然后，您可以继续执行下一步。

填写目标详细信息

要配置目标的详细信息，请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。
显示目标详细信息的平台UI屏幕截图。

名称：将来用于识别此目标的名称。
描述：可帮助您将来识别此目标的描述。

启用警报

您可以启用警报，以接收有关发送到目标的数据流状态的通知。从列表中选择警报以订阅接收有关数据流状态的通知。有关警报的详细信息，请参阅以下内容中的指南：使用UI订阅目标警报.

完成提供目标连接的详细信息后，选择 下一个.

激活此目标的受众

重要

要激活数据，您需要 管理目标， 激活目标， 查看配置文件、和 查看区段 访问控制权限. 阅读访问控制概述或与产品管理员联系以获取所需的权限。

读取将用户档案和受众激活到流式受众导出目标有关将受众激活到此目标的说明。

映射属性和身份

要正确地将受众数据从Adobe Experience Platform发送到 HubSpot 目标，您必须完成字段映射步骤。映射包括在您的Platform帐户中的Experience Data Model (XDM)架构字段与其在目标目标中的相应等效字段之间创建链接。

要将XDM字段正确映射到 HubSpot 目标字段，请执行以下步骤：

映射 `Email` 身份

此 Email 标识是此目标的强制映射。请按照以下步骤对其进行映射：

在映射步骤，选择 添加新映射. 您现在可以在屏幕上看到新的映射行。
在 选择源字段 窗口中，选择 选择身份命名空间 并选择身份。
在 选择目标字段 窗口中，选择 选择属性 并选择 email.

源字段	目标字段	必需
`IdentityMap: Email`	`Identity: email`	是

下面显示了具有标识映射的示例：
带有电子邮件标识映射的平台UI屏幕快照示例。

映射可选属性

要添加任何其他要在XDM配置文件架构与 HubSpot 帐户重复以下步骤：

在映射步骤，选择 添加新映射. 您现在可以在屏幕上看到新的映射行。
在 选择源字段 窗口中，选择 选择属性 类别并选择XDM属性。
在 选择目标字段 窗口，选择 选择属性 类别并从将自动填充的属性列表中进行选择 HubSpot 帐户。目标使用 HubSpot 属性用于检索此信息的API。两者 HubSpot 默认属性和任何自定义属性都将检索以供选择作为目标字段。

XDM配置文件架构和之间的几个可用映射 Hubspot 如下所示：

源字段	目标字段
`xdm: person.name.firstName`	`Attribute: firstname`
`xdm: person.name.lastName`	`Attribute: lastname`
`xdm: workAddress.street1`	`Attribute: address`
`xdm: workAddress.city`	`Attribute: city`
`xdm: workAddress.country`	`Attribute: country`

以下显示了使用这些属性映射的示例：
具有属性映射的平台UI屏幕快照示例。

完成提供目标连接的映射后，选择 下一个.

验证数据导出

要验证您是否正确设置了目标，请执行以下步骤：

登录到 HubSpot 网站，然后导航到 联系人 页面检查受众状态。此列表可以配置为显示使用受众名称创建的自定义属性的列，其值是受众状态。
或者，您可以深入到个人人员页面，然后导航到显示受众名称和受众状态的属性。

数据使用和治理

全部 Adobe Experience Platform 目标在处理您的数据时符合数据使用策略。有关如何执行操作的详细信息 Adobe Experience Platform 强制执行数据管理，请参见数据管理概述.

其他资源

其他有用信息来自 HubSpot 文档如下所示：

HubSpot上的身份验证方法
HubSpot 的API参考联系人和属性 API。

Changelog

此部分捕获此目标连接器的功能和重要文档更新。

查看更改日志

发行月份	更新类型	描述
2023 年 9 月	初始版本	初始目标版本和文档发布。

HubSpot 连接

用例