测试版连接 HubSpot 和 AWS S3（BETA）

{
 "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 数据 "。

• 在 HubSpot 帐户中，单击顶部导航栏中的“商城”图标 marketplace，然后选择应用程序商城。搜索并选择AWS S3。您也可以使用此 URL 直接导航到您账户中的集成。
• 在右上角单击 "安装应用"。
• 输入在步骤 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。

objects_x 表

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

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

HubSpot 对象类型	对象类型标识	描述
联系	0-1	与您的企业互动的个人相关信息
公司	0-2	有关单个企业或组织的信息
交易	0-3	有关联系人或公司收入机会的详细信息。
参与	0-4	存储来自 CRM 操作的数据，包括备注、任务、电子邮件、会议和通话。
票务	0-5	代表客户的帮助或支持请求。
报价	0-14	用于与潜在买家共享定价信息。
提交表单	0-15	HubSpot 表单单个提交的详细信息。
行项目	0-8	代表交易中销售产品的子集。当产品附加到交易中时，它就成为一个细列项目。
对话	0-11	来自多个渠道的传入信息的详细信息。
页面	0-25	登陆页面的详细信息
任务	0-27	存储有关待办事项列表的信息
表格	0-28	用于收集访客和联系人的线索信息
营销电子邮件	0-29	营销中心电子邮件的详细信息
广告费用	0-30	存储您在 Linkedin、Facebook 和 Google 上的广告账户信息
广告设计	0-31	有关广告系列的详细信息。一个广告系列可包含一个或多个广告
广告组	0-32	广告系列中广告的逻辑分组
广告	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 账户中对象属性和事件属性的信息。事件属性包括标准事件（如电子邮件打开和点击）和自定义行为事件属性。这些信息有助于定义object_properties 和事件数据中的值。

事件

事件包括标准 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 文件。