HubSpot连接
- 主题:
- 目标
创建对象:
- 管理员
- 用户
HubSpot是一个CRM平台,其中包含连接营销、销售、内容管理和客户服务所需的所有软件、集成和资源。 它允许您在一个CRM平台上连接数据、团队和客户。
此Adobe Experience Platform 目标利用HubSpot 联系人API,在激活后从现有Experience Platform受众更新HubSpot中的联系人。
下面的向目标身份验证部分中进一步提供了向您的HubSpot实例进行身份验证的说明。
用例
为了帮助您更好地了解您应如何以及何时使用HubSpot目标,以下是Adobe Experience Platform客户可以使用此目标解决的示例用例。
HubSpot联系人存储与您的业务交互的个人的相关信息。 您的团队使用HubSpot中存在的联系人来构建Experience Platform受众。 将这些受众发送至HubSpot后,其信息会更新,并且会为每个联系人分配一个属性,其值作为受众名称,指示该联系人属于哪个受众。
先决条件
请参阅以下部分,了解需要在Experience Platform和HubSpot中设置的任何先决条件,以及在使用HubSpot目标之前必须收集的信息。
Experience Platform先决条件
在将数据激活到HubSpot目标之前,您必须在Experience Platform中创建一个架构、数据集和受众。
如果您需要有关受众状态的指导,请参阅Experience Platform文档,了解受众成员资格详细信息架构字段组。
HubSpot目标的先决条件
请注意以下先决条件,以便将数据从Experience Platform导出到您的HubSpot帐户:
您必须拥有HubSpot帐户
要将数据从Experience Platform导出到您的Hubspot帐户,您需要拥有HubSpot帐户。 如果您还没有帐户,请访问设置HubSpot帐户页面,然后按照指南注册和创建帐户。
收集HubSpot私有应用程序访问令牌
您需要您的HubSpot Access token
允许HubSpot目标通过您HubSpot帐户中的HubSpot私人应用进行API调用。 当您对目标进行身份验证时,Access token
将用作Bearer token
。
如果您没有专用应用,请按照文档中的说明在 HubSpot中创建专用应用。
crm.objects.contacts.write
,crm.objects.contacts.read
crm.schemas.contacts.write
,crm.schemas.contacts.read
凭据 | 描述 | 示例 |
---|---|---|
Bearer token | HubSpot私有应用的Access token 。要获取您的HubSpot Access token ,请按照HubSpot文档中的说明,使用您应用程序的访问令牌🔗进行API调用。 | pat-na1-11223344-abcde-12345-9876-1234a1b23456 |
护栏
HubSpot私有应用受速率限制的约束。 您的私人应用可拨打的次数取决于您的HubSpot帐户订阅以及您是否购买了API加载项。 另请参阅其他限制。
支持的身份
HubSpot支持更新下表中描述的标识。 了解有关标识的更多信息。
目标身份 | 示例 | 描述 | 注意事项 |
---|---|---|---|
email | test@test.com | 联系人的电子邮件地址。 | 必需 |
受众类型 | 描述 |
---|---|
自定义上传 | 受众已从CSV文件将导入Experience Platform。 |
导出类型和频率
有关目标导出类型和频率的信息,请参阅下表。
项目 | 类型 | 注释 |
---|---|---|
导出类型 | 基于配置文件 |
|
导出频率 | 正在流式传输 |
|
连接到目标
要连接到此目标,请按照目标配置教程中描述的步骤操作。 在配置目标工作流中,填写下面两个部分中列出的字段。
在 目标 > 目录 中,搜索HubSpot。 或者,您可以在 CRM 类别下找到它。
验证目标
填写下面的必填字段。 有关任何指导,请参阅收集 HubSpot 私有应用程序访问令牌部分。
- 持有者令牌: HubSpot私有应用程序的访问令牌。
要验证到目标,请选择 连接到目标。
如果提供的详细信息有效,则UI会显示 已连接 状态,并带有绿色复选标记。 然后,您可以继续执行下一步。
填写目标详细信息
要配置目标的详细信息,请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。
- 名称:将来用于识别此目标的名称。
- 描述:可帮助您将来识别此目标的描述。
启用警报
您可以启用警报,以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息,请参阅使用UI订阅目标警报的指南。
完成提供目标连接的详细信息后,选择 下一步。
激活此目标的受众
有关将受众激活到此目标的说明,请阅读将配置文件和受众激活到流式受众导出目标。
映射属性和身份
要将受众数据从Adobe Experience Platform正确发送到HubSpot目标,您必须完成字段映射步骤。 映射包括在Experience Platform帐户中的Experience Data Model (XDM)架构字段与其与目标中的相应等效字段之间创建链接。
要将XDM字段正确映射到HubSpot目标字段,请执行以下步骤:
映射Email
标识
Email
标识是此目标的必需映射。 请按照以下步骤对其进行映射:
- 在 映射 步骤中,选择 添加新映射。 您现在可以在屏幕上看到新的映射行。
- 在 选择源字段 窗口中,选择 选择身份命名空间 并选择身份。
- 在 选择目标字段 窗口中,选择 选择属性 并选择
email
。
IdentityMap: Email
Identity: email
下面显示了具有标识映射的示例:
映射 可选 属性
要添加任何其他要在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
以下显示了使用这些属性映射的示例:
完成提供目标连接的映射后,请选择 下一步。
验证数据导出
要验证您是否正确设置了目标,请执行以下步骤:
-
登录到HubSpot网站,然后导航到 联系人 页面以检查受众状态。 此列表可以配置为显示使用受众名称创建的自定义属性的列,其值是受众状态。
-
或者,您可以向下钻取到单个 人员 页面,并导航到显示受众名称和受众状态的属性。
数据使用和治理
在处理您的数据时,所有Adobe Experience Platform目标都符合数据使用策略。 有关Adobe Experience Platform如何实施数据治理的详细信息,请参阅数据治理概述。
其他资源
HubSpot文档中的其他有用信息如下:
Changelog
此部分捕获此目标连接器的功能和重要文档更新。