跳到內容
請注意：：這篇文章的翻譯只是為了方便而提供。譯文透過翻譯軟體自動建立，可能沒有經過校對。因此，這篇文章的英文版本應該是包含最新資訊的管理版本。你可以在這裡存取這些內容。

連接 HubSpot 和 Google BigQuery (BETA)

上次更新時間： 三月 21, 2025

可搭配下列任何訂閱使用，除非另有註明：

Operations Hub   Enterprise

瞭解如何連接 HubSpot 和 Google BigQuery，以將 HubSpot 資料同步至您的 Google BigQuery 實例。

請注意：HubSpot不會將HIPAA 資料分享給 Google BigQuery。

連接 HubSpot 和 BigQuery

若要連接 HubSpot 和 Google BigQuery，您必須依序執行下列步驟：

  1. 從 HubSpot App Marketplace 安裝 Google BigQuery
  2. 在 Google Cloud Platform 中建立自訂 IAM 角色
  3. 指定自訂角色給 Google 服務帳戶
  4. 授予 HubSpot 產生的 Google BigQuery 帳戶修改 BigQuery 資料表的權限
  5. 在 HubSpot 中完成設定

1.從 HubSpot App Marketplace 安裝 Google BigQuery

建議您在連接兩個應用程式時，分別在不同的標籤中開啟 HubSpot 帳戶和 Google BigQuery 帳戶。

  • 確保您的 HubSpot 帳戶已選擇加入此測試版：在 Google BigQuery 中存取 HubSpot 資料。
  • 導覽到此連結並選擇您的 HubSpot 帳戶。
  • 在右上方，按一下安裝應用程式。
  • 輸入您的Bucket URI 和專案 ID。
  • 按一下下一步。

  • 查看並記下 Google Service 和 BigQuery 帳戶，因為下一步中您會用到它們。然後導航到您的 Google Cloud 主控台，完成下一步。

2.在 Google Cloud Platform 中建立自訂 IAM 角色

  • 登入 Google Cloud 主控台。
  • 按一下左側導覽功能表，然後選取IAM & Admin > Roles。
  • 在頂部，按一下建立角色。
  • 輸入角色的標題、 可選描述和 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.授予 Google 服務帳戶存取 Cloud Storage Buckets 的權限

  • 按一下左側導覽功能表，然後選取Cloud Storage>Buckets。
  • 選取要設定的水桶。
  • 按一下權限索引標籤。
  • 在「依主事人檢視」標籤上，按一下「授權存取」。

  • 在右側面板的New principals欄位中，輸入步驟 1 中的Google 服務帳戶名稱。

請注意：請確保指定 Google 服務帳戶，而非 BigQuery 帳戶。

  • 在指定角色部分，按一下下拉功能表並選擇 自訂><角色>，其中<角色>是在步驟 2 中建立的自訂 IAM 角色。
  • 按一下儲存。Google 服務帳戶將會新增至儲存物件檢視器 角色。

4.授予 HubSpot 生成的 Google BigQuery 帳戶修改 BigQuery 表的權限

  • 按一下左側導覽功能表，然後選取IAM & Admin>IAM。
  • 按一下「授權存取」。
  • 在右側面板的New principals欄位中，輸入步驟 1 中HubSpot 產生的 Google BigQuery 帳戶。
  • 在指定角色部分，按一下下拉功能表並選擇 自訂><角色>，其中<角色>是在步驟 2 中建立的自訂 IAM 角色。

5.在 HubSpot 中完成設定

  • 在您的 HubSpot 帳戶中，按一下Continue to Connected Apps。

  • 在對話方塊中，選擇核取方塊，然後按一下允許並安裝。

HubSpot 和 Google BigQuery 之間同步的資料格式

可用於同步的資料

您可以將下列資料從 HubSpot 同步至 Google BigQuery：

  • 物件：標準和自訂物件，例如聯絡人、公司、票券或產品。
  • 記錄：個別物件記錄。
  • 關聯： 所有關聯類型和相關記錄。
  • 事件：標準 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 物件類型

ObjectTypeId

說明

聯繫

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

儲存待辦事項清單的相關資訊

FORM

0-28

用於收集您的訪客和聯絡人的線索資訊

行銷郵件

0-29

關於Marketing Hub電子郵件的詳細資訊

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

其他 CRM 記錄撥打的電話，例如聯絡人

發票

0-53

管理發票並與外部會計系統同步

媒體橋樑

0-57

匯入 HubSpot 的媒體資產資訊

序列

0-58

序列是一系列有針對性、有時限的電子郵件範本，以隨時間推移培育聯絡人

DEAL_SPLIT

0-72

交易分割用於在多位使用者之間分享交易信用額度

銷售文件

0-83

銷售文件建立內容庫，讓整個團隊上傳文件並與聯絡人分享。

回饋提交

0-19

儲存提交至回饋意見調查的資訊。

訂閱

0-69

訂閱包含定期付款的詳細資訊

商務付款

0-101

包含從客戶收取資金的相關資料

有物件屬性的物件

此表包含 HubSpot 記錄的資料。您可以為物件類型中的每筆記錄取得一列資料 (例如，連絡人物件類型中的所有連絡人記錄)。

物件屬性記錄

本表包含歷史的財產值。對於聯絡人，它包含最近的 45 個值。對於所有其他物件，則包含最近的 20 個值。每個歷史屬性值都有一行。屬性的目前值由該屬性歷史中最近的 UPDAT 時間戳決定。

協會查詢

與物件資料一樣，關聯資料也是以兩種方式組織：

  • 個別：每種關聯類型儲存在自己的表中，並且只包含該類型的記錄。例如，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 與 Google BigQuery 之間的資料每日於 0900 UTC +0 同步。資料同步的每一天都會建立一個資料夾，每個資料表都會有幾個子資料夾。最近七次的同步資料將提供給 Google Cloud 平台，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
這篇文章有幫助嗎？
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助。

相關內容