HubSpot连接

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

此Adobe Experience Platform 目标利用HubSpot 联系人API,在激活后从现有Experience Platform受众更新HubSpot中的联系人。

下面的向目标身份验证部分中进一步提供了向您的HubSpot实例进行身份验证的说明。

用例 use-cases

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

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

先决条件 prerequisites

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

Experience Platform先决条件 prerequisites-in-experience-platform

在将数据激活到HubSpot目标之前,您必须在Experience Platform中创建一个架构数据集受众

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

HubSpot目标的先决条件 prerequisites-destination

请注意以下先决条件,以便将数据从Platform导出到您的HubSpot帐户:

您必须拥有HubSpot帐户 prerequisites-account

若要将数据从Platform导出到您的Hubspot帐户,您需要拥有HubSpot帐户。 如果您还没有帐户,请访问设置HubSpot帐户页面,然后按照指南注册和创建帐户。

收集HubSpot私有应用程序访问令牌 gather-credentials

您需要您的HubSpot Access token允许HubSpot目标通过您HubSpot帐户中的HubSpot私人应用进行API调用。 当您对目标进行身份验证时,Access token将用作Bearer token

如果您没有专用应用,请按照文档中的说明在 HubSpot中创建专用应用。

IMPORTANT
应为专用应用程序分配以下范围:
crm.objects.contacts.writecrm.objects.contacts.read
crm.schemas.contacts.writecrm.schemas.contacts.read
凭据
描述
示例
Bearer token
HubSpot私有应用的Access token
要获取您的HubSpot Access token,请按照HubSpot文档中的说明,使用您应用程序的访问令牌🔗进行API调用。
pat-na1-11223344-abcde-12345-9876-1234a1b23456

护栏 guardrails

HubSpot私有应用受速率限制的约束。 您的私人应用可拨打的次数取决于您的HubSpot帐户订阅以及您是否购买了API加载项。 另请参阅其他限制

支持的身份 supported-identities

HubSpot支持更新下表中描述的标识。 了解有关标识的更多信息。

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

支持的受众 supported-audiences

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

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

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

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

导出类型和频率 export-type-frequency

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

项目
类型
注释
导出类型
基于配置文件
  • 您正在导出受众的所有成员,以及所需的架构字段​ (例如:电子邮件地址、电话号码、姓氏)(根据字段映射)。
  • 此外,在HubSpot中使用受众名称创建新属性,对于每个所选受众,其值与Platform中的相应受众状态相同。
导出频率
正在流式传输
  • 流目标为基于API的“始终运行”连接。 一旦根据受众评估在Experience Platform中更新了用户档案,连接器就会将更新发送到下游目标平台。 阅读有关流式目标的更多信息。

连接到目标 connect

IMPORTANT
若要连接到目标,您需要​ 查看目标 ​和​ 管理目标 访问控制权限。 阅读访问控制概述或联系您的产品管理员以获取所需的权限。

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

在​ 目标 > 目录 ​中,搜索HubSpot。 或者,您可以在​ CRM ​类别下找到它。

验证目标 authenticate

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

  • 持有者令牌: HubSpot私有应用程序的访问令牌。

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

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

填写目标详细信息 destination-details

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

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

启用警报 enable-alerts

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

完成提供目标连接的详细信息后,选择​ 下一步

激活此目标的受众 activate

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

有关将受众激活到此目标的说明,请阅读将配置文件和受众激活到流式受众导出目标

映射属性和身份 map

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

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

映射Email标识

Email标识是此目标的必需映射。 请按照以下步骤对其进行映射:

  1. 在​ 映射 ​步骤中,选择​ 添加新映射。 您现在可以在屏幕上看到新的映射行。
    突出显示了“添加新映射”按钮的Platform UI屏幕截图。
  2. 在​ 选择源字段 ​窗口中,选择​ 选择身份命名空间 ​并选择身份。
    Platform UI屏幕截图选择电子邮件作为要映射为标识的源属性。
  3. 在​ 选择目标字段 ​窗口中,选择​ 选择属性 ​并选择email
    Platform UI屏幕截图选择电子邮件作为要映射为身份的目标属性。
源字段
目标字段
必需
IdentityMap: Email
Identity: email

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

映射​ 可选 ​属性

要添加任何其他要在XDM配置文件架构和HubSpot帐户之间更新的属性,请重复以下步骤:

  1. 在​ 映射 ​步骤中,选择​ 添加新映射。 您现在可以在屏幕上看到新的映射行。
    突出显示了“添加新映射”按钮的Platform UI屏幕截图。
  2. 在​ 选择源字段 ​窗口中,选择​ 选择属性 ​类别并选择XDM属性。
    Platform UI屏幕截图选择“名字”作为源属性。
  3. 在​ 选择目标字段 ​窗口中,选择​ 选择属性 ​类别,然后从自动从HubSpot帐户填充的属性列表中进行选择。 目标使用HubSpot 属性 API检索此信息。 已检索HubSpot 默认属性和任何自定义属性,以便选择它们作为目标字段。
    Platform UI屏幕截图选择“名字”作为目标属性。

下面显示了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

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

完成提供目标连接的映射后,请选择​ 下一步

验证数据导出 exported-data

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

  1. 登录到HubSpot网站,然后导航到​ 联系人 ​页面以检查受众状态。 此列表可以配置为显示使用受众名称创建的自定义属性的列,其值是受众状态。
    HubSpot UI屏幕截图显示“联系人”页面,该页面带有列标题,其中显示受众名称和单元格受众状态

  2. 或者,您可以向下钻取到单个​ 人员 ​页面,并导航到显示受众名称和受众状态的属性。
    HubSpot UI屏幕截图显示“联系人”页面,该页面具有显示受众名称和受众状态的自定义属性。

数据使用和治理 data-usage-governance

在处理您的数据时,所有Adobe Experience Platform目标都符合数据使用策略。 有关Adobe Experience Platform如何实施数据治理的详细信息,请参阅数据治理概述

其他资源 additional-resources

HubSpot文档中的其他有用信息如下:

Changelog

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

查看更改日志
table 0-row-3 1-row-3 layout-auto
发行月份 更新类型 描述
2023 年 9 月 初始版本 初始目标版本和文档发布。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6