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

連接HubSpot和Google BigQuery （測試版）

上次更新時間： 九月 25, 2024

可与下列任何一种订阅一起使用，除非有说明：

Operations Hub   Enterprise

瞭解如何連結HubSpot和Google BigQuery ，將HubSpot資料同步到您的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帳戶已選擇加入此測試版：在Google BigQuery中存取HubSpot資料。 
  • 前往此連結，然後選擇您的HubSpot帳戶。 
  • 在右上角，按一下「安裝應用程式」。
  • 輸入您的Bucket URI和專案ID。 
  • 按一下下一步。 

connect-hubspot-bigquery

  • 檢查並記錄Google服務和BigQuery帳戶，因為您在下一步中將需要這些帳戶。 然後前往Google雲端主控臺，完成下一步。 

google-service-account

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

  • 登入您的Google雲端主控臺。 
  • 按一下左側導覽選單，然後選取「IAM與管理員」>「角色」。 
  • 在頂部按一下「建立角色」。
  • 輸入角色的標題、 可選說明和ID 。 
  • 按一下「新增權限」。 

create-iam-role

  • 在表格中，選取下列權限，然後按一下新增：

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.將自訂角色指派給Cloud Storage Service帳戶

  • 按一下左側導覽選單，然後選取「雲端儲存>儲存 區」。 
  • 選取要設定的儲存區。 
  • 按一下「權限」索引標籤。
  • 在「依主體檢視」索引標籤上，按一下「授予存取權限」。 

bigquery-bucket-permissions

  • 在右側面板的「新主體」欄位中，輸入步驟2中的Google服務帳戶名稱。
  • 在分配角色部分，按一下下拉式選單，然後選擇自訂> < role > ，其中< role >是在步驟1中建立的自訂IAM角色。 
  • 按一下[儲存]。Google服務帳戶將新增至儲存物件檢視器角色。 

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

  • 按一下左側導覽選單，然後選取「IAM與管理員」>「IAM」。 
  • 按一下「授予存取權限」。
  • 在右側面板的「新主體」欄位中，輸入步驟2中的Google服務帳戶名稱。
  • 在分配角色部分，按一下下拉式選單，然後選擇自訂> < role > ，其中< role >是在步驟1中建立的自訂IAM角色。 

5.在HubSpot中完成設定

  • 在您的HubSpot帳戶中，按一下「繼續」至「已連結的應用程式」。 

google-service-account

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

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

可用於同步的數據

您可以將以下數據從HubSpot同步到Google BigQuery ： 

  • 物件：標準和自訂物件，例如聯絡人、公司、票證或產品。
  • 記錄：個別物件記錄。 
  • 關聯：所有關聯類型和相關記錄。
  • 事件：標準HubSpot事件和自訂行為事件的事件資料。 
  • 列表： HubSpot聯系人和公司列表。
  • 擁有者：記錄擁有者。 
  • 管線：交易和票證管線以及管線階段。 
  • 屬性：物件記錄上的屬性及其值，包括屬性歷史記錄。 

不同類型的物件資料有兩種組織方式：

  • 個人：每個物件類型都儲存在自己的表格中，並且只有相同物件類型的記錄。 例如， objects_contacts記錄。
  • 合併：所有物件類型的ll記錄合併成一個資料庫物件。 因此，在查詢時，您需要指定一個篩選器，例如“WHERE objectTypeId = ’0-1’

自訂物件將在建立時分配一個ID ，並將被識別為2-unique_ID。 例如， 2-12345。 

objects_x表

每種可用的物件類型（包括自訂物件）都有自己的特定表格。 這些表格的命名格式為OBJECTSOBJECTS_ ，其中是物件類型的複數表單標objecttype。（請注意，如果對象類型沒有複數形式，則將是與“S”連接的對象類型名稱的單數形式標籤）。

以下是可用的HubSpot物件類型的完整清單、它們所代表的資料的簡短說明及其對應的表格。

HubSpot物件類型

ObjectTypeId

描述

聯系方式

0-1

有關個人與貴公司互動的資訊

公司

0-2

個別企業或組織的相關資訊

交易

0-3

聯絡人或公司的營收機會詳細資訊。 

參與度

0-4

儲存來自CRM動作的資料，包括備註、任務、電子郵件、會議和電話。

工單

0-5

代表客戶尋求協助或支援。

引用

0-14

用於與潛在買家分享價格資訊。

FORM_SUBMISSION

0-15

HubSpot表單的個別提交詳情。

LINE_ITEM

0-8

代表在交易中銷售的產品的子集。 當產品附加到交易時，它就會成為一個明細項目。

對話

0-11

來自多個頻道的傳入訊息的詳細資訊。

LANDING_PAGE

0-25

登陸頁面的詳細資訊

 任務

0-27

儲存有關待辦清單的資訊

表單

0-28

用於收集有關訪客和聯絡人的潛在客戶資訊

MARKETING_EMAIL

0-29

行銷中心電郵詳情

AD_ACCOUNT

0-30

在Linkedin、Facebook和Google上儲存有關您廣告帳戶的資訊

AD_CAMPAIGN

0-31

有關廣告活動的詳細資訊。 廣告活動可以包含一個或多個廣告

AD_GROUP

0-32

廣告活動中廣告的邏輯分組

AD

0-33

個別廣告的詳細資訊

行銷活動

0-35

有關相關行銷資產和內容的資訊，以便您輕鬆衡量集體行銷工作的有效性。

SITE_PAGE

0-38

有關您網站上個別頁面的資料

BLOG_POST

0-39

有關網誌文章的資料

對象列表

0-45

有關基於其屬性或活動的目標記錄分組的資訊

致電

0-48

其他CRM記錄的來電，例如客服案件

發票

0-53

使用外部會計系統管理和同步發票

MEDIA_BRIDGE

0-57

有關匯入HubSpot的媒體資產的資訊

序列

0-58

序列是一系列有針對性的定時電子郵件範本，可隨著時間的推移培養客服案件

DEAL_SPLIT

0-72

交易拆分用於在多位用戶之間共享交易信用額度

SALES_DOCUMENT

0-83

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

FEEDBACK_SUBMISSION

0-19

儲存提交給意見調查的資訊。

訂閱

0-69

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

商務付款

0-101

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

object_with_object_properties

此表包含您的HubSpot記錄中的資料。 您可以為物件類型中的每個記錄獲得一行（例如，聯絡人物件類型中的所有聯絡人記錄）。 

object_properties_history

此表包含歷史屬性值。 對於客服案件，它包含最近的45個值。 對於所有其他對象，它包含最近的20個值。 表格中的每個歷史屬性值都有一行。 物業的當前值由物業歷史記錄中最新的UPDATEDAT時間戳記決定。

關聯查詢

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

  • 個人：每個關聯類型都存儲在自己的表中，並且只包含該類型的記錄。 例如， associations_contacts_to_deals只包含連絡人與交易物件之間的關聯記錄。T
  • 合併：所有關聯類型的所有記錄都合併到一個表格中。

associations_x_to_y 

每個關聯類型都有自己的視圖，標記為associations_ ，例如associations_contacts_to_deals。 

association_definitions

此表格包含有關HubSpot物件之間所有可用關聯類型的資訊，每個關聯類型一行。

property_definitions

此表包含有關HubSpot帳戶中的物件屬性和事件屬性的資訊。 事件屬性包括標準事件，例如電子郵件開啟和點擊，以及自訂行為事件屬性。 此信息有助於定義object_properties和events數據中的值。

事件

事件包括標準HubSpot事件和自訂行為事件。 每個事件都有自己的表格，標記為events_eventname。

object_and_event_type_definitions

此表包含您HubSpot帳戶中所有可用物件和事件的定義。

同步頻率和資料組織

HubSpot和Google BigQuery之間的數據每日0900 UTC +0同步。 每天都會建立一個資料夾，資料會與每個資料表的多個子資料夾同步。 最後七個同步將在Google Cloud平臺中可用， BigQuery中的表格將更新為指向最新的儲存桶傾印。

以下每個表格都將作為包含gzip CSV檔案的資料夾提供：

ASSOCIATIONS ASSOCIATION_DEFINITIONSASSOCIATIONS

EVENTS_[Event name]
LISTS
LIST_MEMBERSHIPS
個OBJECTS
OBJECT_AND_EVENT_TYPE_DEFINITIONS
OBJECT_PROPERTIESOBJECT_PROPERTIES_HISTORY
OBJECT
OBJECT_WITH_OBJECT_PROPERTIES
OWNERS
OWNER_TEAM
PIPELINES
PIPELINE_STAGES
PROPERTY_DEFINITIONS
TEAMS
這篇文章有幫助嗎？
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助。
目錄

相關內容