跳到内容

连接 HubSpot 和 AWS S3(BETA)

上次更新时间: 二月 13, 2025

除非另有说明,否则适用于以下任何订阅

Operations Hub   Enterprise

了解如何连接 HubSpot 和 AWS S3,将 HubSpot 数据同步到您的 S3 存储桶。

连接 HubSpot 和 AWS S3

要连接 HubSpot 和 AWS S3,必须按以下步骤依次进行:

  1. 配置 AWS S3 存储桶的访问权限
  2. 创建 IAM 策略
  3. 在 AWS 中创建 IAM 角色
  4. 连接 HubSpot 和 AWS S3
  5. 授予 IAM 用户访问 S3 存储桶对象的权限

1.配置 S3 存储桶的访问权限

HubSpot 需要 AWS S3 存储桶和文件夹的以下权限,才能访问文件夹和子文件夹中的文件:

  • s3:GetBucketLocation
  • s3:GetObject
  • s3:GetObjectVersion
  • s3:ListBucket
  • s3:PutObject
  • s3:DeleteObject

2.创建 IAM 策略

  • 登录AWS 管理控制台
  • 在主控制面板上,单击服务>安全、身份和合规性 >IAM。
  • 在左侧边栏点击账户设置。
  • 在安全令牌服务 (STS) 部分,查找与您的 AWS 账户所在区域相对应的 AWS 区域。单击打开开关以激活该区域。
  • 在左侧面板上单击 "政策"。
  • 单击创建策略。
  • 在JSON选项卡上,单击 添加新语句。
  • 添加下面的策略文档,为 HubSpot 提供使用单一数据桶和文件夹路径加载或卸载数据所需的权限。你还可以使用 PURGE 复制选项清除数据文件。

请注意

  • 确保将<bucket><prefix> 替换为实际的数据桶名称和文件夹路径前缀。政府区域中的存储桶的亚马逊资源名称(ARN) 前缀为arn:aws-us-gov:s3:::。
  • s3:prefix 条件设置为["*"]或["<path> /*"],可分别访问指定邮筒或邮筒中路径的所有前缀。
{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Effect": "Allow",
 "Action": [
 "s3:PutObject",
 "s3:GetObject",
 "s3:GetObjectVersion",
 "s3:DeleteObject",
 "s3:DeleteObjectVersion"
 ],
 "Resource": "arn:aws:s3:::<bucket>/<prefix>/*"
 },
 {
 "Effect": "Allow",
 "Action": [
 "s3:ListBucket",
 "s3:GetBucketLocation"
 ],
 "Resource": "arn:aws:s3:::<bucket>",
 "Condition": {
 "StringLike": {
 "s3:prefix": [
 "<prefix>/*"
 ]
 }
 }
 }
 ]
}
  • 单击下一步。
  • 在"审查和创建 "部分,添加政策名称和可选说明。
  • 单击创建策略。

3.在 AWS 中创建 IAM 角色

在 AWS 管理控制台中配置 HubSpot 的访问权限:

  • 登录AWS 管理控制台
  • 在主控制面板上,单击服务>安全、身份和合规性 >IAM。
  • 在左侧边栏单击 "角色"。
  • 单击创建角色。
  • 在受信任实体类型部分,选择AWS 账户。
  • 在 "一个 AWS 账户"部分,选择 "另一个 AWS账户 "并输入您自己的 AWS 账户 ID。稍后您将更改信任关系,以便向 HubSpot 提供访问权限。
  • 选择 "要求外部 ID",然后输入一个占位符 ID(如 0000)。稍后,您将更改 IAM 角色的信任关系,并为存储集成指定外部 ID。外部 ID 用于授予 HubSpot 等第三方应用程序访问 AWS 资源的权限。

  • 单击下一步。
  • 选择步骤 1 中创建的策略,然后单击下一步。
  • 在 "角色详细信息"部分,输入 "角色名称"和 "描述"以标识角色。
  • 单击创建角色。
  • 在角色摘要页面,复制ARN值。您将在下一步中使用该值。

4.连接 HubSpot 和 AWS S3

  • 确保您的 HubSpot 帐户已选择加入此测试版:访问 AWS S3 中的 HubSpot 数据。
  • 导航至此 URL并选择您的 HubSpot 账户。
  • 在右上角,单击安装应用程序。
  • 输入在步骤 3 中配置的IAM 角色名称 和要将数据转储到存储桶的S3 URL 路径。
  • 单击下一步。
  • 查看并复制AWS IAM 用户和 AWS 外部 ID 值,因为下一步中需要它们。 然后,单击 "继续连接应用程序"。

5.授予 IAM 用户访问桶对象的权限

  • 登录AWS 管理控制台
  • 在主控制面板上,单击服务>安全、身份和合规性 >IAM。
  • 在左侧边栏中,单击 "角色"。
  • 选择在步骤 3 中创建的角色。
  • 选择 "信任关系"选项卡,然后单击 "编辑信任策略"。
  • 用步骤 3 中记录的值修改保单文件。

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Sid": "",
 "Effect": "Allow",
 "Principal": {
 "AWS": "<hubspot_user_arn>"
 },
 "Action": "sts:AssumeRole",
 "Condition": {
 "StringEquals": {
 "sts:ExternalId": "<hubspot_external_id>"
 }
 }
 }
 ]
}

在上述策略中,将以下两个字段更改为步骤 4 中记录的值:

  • 将hubspot_user_arn设为STORAGE_AWS_IAM_USER_ARN值
  • 将hubspot_external_id改为STORAGE_AWS_EXTERNAL_ID 值

完成上述步骤后,HubSpot 就可以将数据同步到 AWS S3。

在 HubSpot 和 AWS S3 之间同步的数据格式

可用的同步数据

您可以将以下数据从 HubSpot 同步到 AWS S3:

  • 对象:标准和自定义对象,如联系人、公司、机票或产品。
  • 记录:单个对象的记录。
  • 关联: 所有关联类型和相关记录。
  • 事件:标准 HubSpot 事件和自定义行为事件的事件数据。
  • 列表: HubSpot 联系人和公司列表。
  • 所有者:有 记录的所有者。
  • 管道: 交易和票据管道以及管道阶段。
  • 属性: 对象记录上的属性及其值,包括属性历史记录。

不同类型的对象数据以两种方式组织和提供:

  • 单个: 每个对象类型存储在自己的表中,并且只有相同对象类型的记录。例如,objects_contacts 只包含联系人记录。
  • 合并:所有对象类型的所有记录都合并到一个数据库对象中。因此,在查询时,需要指定一个过滤器,如 "WHERE objectTypeId='0-1'

自定义对象将在创建时分配一个 ID,标识为2-unique_ID。例如,2-12345。

对象_x 表

每种可用的对象类型(包括自定义对象)都有自己特定的表格。这些表格按照OBJECTS_<object type name> 的格式命名,其中<object type name>objecttype 的复数形式标签。(注意,如果对象类型没有复数形式,则<object type name> 将是对象类型名称的单数形式标签,并与 "S "连接)。

下面是可用 HubSpot 对象类型的完整列表、它们所代表数据的简短描述以及相应的表格。

HubSpot 对象类型

对象类型标识

说明

联系

0-1

与您的企业互动的个人相关信息

公司

0-2

有关个别企业或组织的信息

DEAL

0-3

有关联系人或公司收入机会的详细信息。

参与

0-4

存储来自 CRM 操作的数据,包括备注、任务、电子邮件、会议和通话。

门票

0-5

代表客户寻求帮助或支持。

引用

0-14

用于与潜在买家分享定价信息。

提交表单

0-15

HubSpot 表单个人提交的详细信息。

行_项目

0-8

代表交易中销售产品的子集。产品附加到交易后,就成为一个细列项目。

对话

0-11

多渠道接收信息的详细信息。

登陆页面

0-25

登陆页面的详细信息

任务

0-27

存储待办事项信息

表格

0-28

用于收集访客和联系人的线索信息

营销电子邮件

0-29

营销中心电子邮件的详细信息

AD_ACCOUNT

0-30

存储您在 Linkedin、Facebook 和 Google 上的广告账户信息

AD_CAMPAIGN

0-31

有关广告系列的详细信息。一个广告系列可包含一个或多个广告

AD_GROUP

0-32

在广告系列中对广告进行逻辑分组

AD

0-33

单个广告的详细信息

活动

0-35

相关营销资产和内容的信息,便于衡量集体营销工作的效果。

网站页面

0-38

有关网站单个页面的数据

博客文章

0-39

博客文章数据

目标 清单

0-45

基于属性或活动的对象记录分组信息

呼叫

0-48

其他客户关系管理记录(如联系人)拨打的电话

发票

0-53

管理发票并与外部会计系统同步

媒体桥

0-57

有关导入 HubSpot 的媒体资产的信息

序列

0-58

序列是一系列有针对性、定时的电子邮件模板,用于在一段时间内培养联系人

DEAL_SPLIT

0-72

交易拆分用于在多个用户之间共享交易积分

销售文档

0-83

销售文档可为整个团队建立一个内容库,以便上传文档并与联系人共享。

反馈提交

0-19

存储提交给反馈调查的信息。

订阅

0-69

订阅包含定期付款的详细信息

商务付款

0-101

包含从客户处收集的资金数据

带对象属性的对象

该表包含 HubSpot 记录中的数据。您可以为对象类型中的每条记录获取一行数据(例如,联系人对象类型中的所有联系人记录)。

对象属性历史

本表包含历史属性值。对于联系人,它包含最近的 45 个值。对于所有其他对象,它包含最近的 20 个值。该表中的每个历史属性值都有一行。属性的当前值由属性历史记录中最新的 UPDATEDAT 时间戳决定。

关联查询

与对象数据一样,关联数据也有两种组织方式:

  • 单个:每种关联类型存储在自己的表中,只包含该类型的记录。例如,associations_contacts_to_deals 只包含联系人和交易对象之间的关联记录。T
  • 合并:将所有关联类型的所有记录合并到一个表中。

联想_x_to_y

每种关联类型都有自己的视图,标记为associations_<association type name> ,如associations_contacts_to_deals

关联定义

此表包含 HubSpot 对象之间所有可用关联类型的信息,每个关联类型有一行。

属性定义

本表包含有关 HubSpot 账户中对象属性和事件属性的信息。事件属性包括标准事件(如电子邮件打开和点击)和自定义行为事件属性。这些信息有助于定义对象属性事件数据中的值。

活动

事件包括标准 HubSpot 事件和自定义行为事件。每个事件都有自己的表格,标记为events_eventname

对象和事件类型定义

本表包含 HubSpot 账户中所有对象和事件的定义。

同步频率和数据组织

数据每日在 HubSpot 和 AWS S3 之间同步。数据同步的每一天都会创建一个文件夹。以下每个表格都将以文件夹形式提供,其中包含压缩后的 CSV 文件:

ASSOCIATIONS
ASSOCIATION_DEFINITIONS
EVENTS_[Event name]
LISTS
LIST_MEMBERSHIPS
OBJECTS
OBJECT_AND_EVENT_TYPE_DEFINITIONS
OBJECT_PROPERTIES
OBJECT_PROPERTIES_HISTORY
OBJECT_WITH_OBJECT_PROPERTIES
OWNERS
OWNER_TEAM
PIPELINES
PIPELINE_STAGES
PROPERTY_DEFINITIONS
TEAMS

每个表格将有多个子文件夹。如果表格大小超过 15MB,则每个表格文件夹下会有多个压缩 CSV 文件。

这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助