测试版连接 HubSpot 和 Google BigQuery(BETA)
上次更新时间: 二月 13, 2025
除非另有说明,否则适用于以下任何订阅:
|
了解如何连接 HubSpot 和 Google BigQuery,以便将 HubSpot 数据同步到 Google BigQuery 实例。
连接 HubSpot 和 BigQuery
要连接 HubSpot 和 Google BigQuery,必须依次完成以下步骤:
- 从 HubSpot 应用程序市场安装 Google BigQuery
- 在 Google 云平台中创建自定义 IAM 角色
- 将自定义角色分配给 Google 服务帐户
- 授予 HubSpot 生成的 Google BigQuery 帐户修改 BigQuery 表的权限
- 在 HubSpot 中完成设置
1.从 HubSpot 应用程序市场安装 Google BigQuery
在连接这两个应用程序时,建议在不同的标签页中分别打开 HubSpot 帐户和 Google BigQuery 帐户。
- 确保您的 HubSpot 帐户已选择加入此测试版:在 Google BigQuery 中访问 HubSpot 数据。
- 导航至此链接并选择您的 HubSpot 账户。
- 在右上角,单击安装应用程序。
- 输入您的水桶 URI 和项目 ID。
- 单击下一步。
- 查看并记下 Google 服务和 BigQuery 帐户,因为下一步会用到它们。然后,导航到 Google 云控制台完成下一步。
2.在谷歌云平台中创建自定义 IAM 角色
- 登录 Google Cloud 控制台。
- 单击左侧导航菜单,选择IAM 和管理员 > 角色。
- 在顶部单击 "创建角色"。
- 输入角色的标题、 可选描述和 ID 。
- 单击添加权限。
- 在表中选择以下权限,然后单击添加:
bigquery.datasets.create
bigquery.datasets.get
bigquery.datasets.getIamPolicy
bigquery.jobs.create
bigquery.tables.create
bigquery.tables.createIndex
bigquery.tables.createSnapshot
bigquery.tables.createTagBinding
bigquery.tables.delete
bigquery.tables.deleteIndex
bigquery.tables.deleteSnapshot
bigquery.tables.update
bigquery.tables.get
storage.buckets.get
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list
- 单击创建。
3.将自定义角色分配给云存储服务帐户
- 单击左侧导航菜单并选择云存储>桶。
- 选择要配置的水桶。
- 单击 "权限"选项卡。
- 在 "按负责人查看"选项卡上,单击 "授予访问权限"。
- 在右侧面板的 "新委托人"字段中,输入步骤 1 中的Google 服务账户名称。
- 在 "分配角色"部分,单击下拉菜单并选择 自定义><角色>,其中<角色>是在步骤 2 中创建的自定义 IAM 角色。
- 单击保存。Google 服务账户将添加到存储对象查看器 角色中。
4.授予 HubSpot 生成的 Google BigQuery 账户修改 BigQuery 表的权限
- 单击左侧导航菜单,选择IAM 和管理>IAM。
- 单击 "授予访问权限"。
- 在右侧面板的 "新委托人"字段中,输入步骤 1 中HubSpot 生成的 Google BigQuery 账户。
- 在 "分配角色"部分,单击下拉菜单并选择 自定义><角色>,其中<角色>是在步骤 2 中创建的自定义 IAM 角色。
5.在 HubSpot 中完成设置
- 在 HubSpot 账户中,单击 "继续连接应用程序"。
- 在对话框中,选择复选框,然后单击允许并安装。
在 HubSpot 和 Google BigQuery 之间同步的数据格式
可用的同步数据
您可以将以下数据从 HubSpot 同步到 Google BigQuery:
- 对象:标准和自定义对象,如联系人、公司、机票或产品。
- 记录:单个对象的记录。
- 关联: 所有关联类型和相关记录。
- 事件:标准 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 |
有关个别企业或组织的信息 |
|
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 上的广告账户信息 |
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 |
序列是一系列有针对性、定时的电子邮件模板,用于在一段时间内培养联系人 |
|
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 和 Google BigQuery 之间的数据每日同步,同步时间为 0900 UTC +0。最近七次同步的数据将在 Google 云平台上提供,BigQuery 中的表也会更新以指向最新的数据包转储。
以下每个表格都将以 Parquet 格式文件提供:
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