測試版將 HubSpot 連接到 Google BigQuery

將 Google BigQuery 的資料與 HubSpot CRM 物件同步，例如聯絡人、公司、交易、關聯以及您帳戶中的其他資料。

以下章節將介紹如何授權 Google BigQuery 應用程式，然後設定 Google Cloud 帳戶與 HubSpot 之間的同步設定。

連接並設定 Google BigQuery 整合

將您的 Google BigQuery 帳戶連接到 HubSpot：

1. 在你的 HubSpot 帳戶中，點擊頂端導覽列中的「Marketplace 圖示」，然後選取「HubSpot Marketplace」。
2. 點選搜尋列並輸入Google BigQuery。
3. 從列表頁面點選Google BigQuery 。
4. 按一下安裝。
5. 按一下繼續設定。

您將被重定向到資料整合工具，其中側邊窗格將根據您想要同步的方向引導您完成 HubSpot 和 BigQuery 帳戶之間的資料同步：

• Google BigQuery → HubSpot：配置從BigQuery到HubSpot的同步。
• HubSpot → Google BigQuery：配置從 HubSpot 到 BigQuery 的同步。

同步 Google BigQuery 資料到您的 HubSpot 帳戶

若要傳送 Google BigQuery 資料到 HubSpot，請在 BigQuery 帳戶中新增並設定一個具有所需角色的新使用者：

1. 在右側窗格中，選擇Google BigQuery → HubSpot。
2. 複製 HubSpot 產生的 Google 服務帳戶電子郵件。

3. 在您的 Google Cloud 帳戶中，導覽到您的專案 IAM 設定，使用您從 HubSpot 複製的服務帳戶電子郵件建立新使用者，然後為新建立的使用者新增BigQuery Data Viewer 和BigQuery Job User角色。

4. 從 Google Cloud 帳戶複製專案 ID。
5. 回到 HubSpot，粘贴项目 ID，然后单击测试连接。
6. 連接驗證完成後，按一下下一步完成設定。

同步HubSpot數據到您的Google BigQuery帳戶

要將 HubSpot 資料傳送至 Google BigQuery，您需要在 Google Cloud 帳戶中設定具有所需權限的使用者，並指定相關的 GCP 專案和 GCS bucket URI。

請注意：您需要Google Cloud管理員存取BigQuery資料集所在的GCP專案，以及HubSpot將存放Parquet檔案的Google Cloud Storage (GCS)儲存空間。

1. 在右側窗格中，選擇HubSpot → Google BigQuery。
2. 複製 HubSpot 產生的 Google 服務帳戶電子郵件。

3. 在您的 Google Cloud 帳戶中，導覽到您的專案 IAM 設定，使用您從 HubSpot 複製的服務帳戶電子郵件建立新使用者，然後為新建立的使用者新增BigQuery Data Viewer、BigQuery Job User 和Storage object owner 角色。
   

4. 從 Google Cloud 帳戶複製專案 ID。
5. 回到 HubSpot，貼入專案 ID。
6. 新增您的 Google Cloud Storage (GCS) 儲存桶 URI：
   • GCS 儲存桶的 URI 應該遵循以下結構：gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • BigQuery 外部表格在 GCP 專案中的專用資料集中建立，並遵循格式：hubspot_data_set_{hubId}
   • 数据将被写入 GCS 数据桶，相关表将引用 GCS 中的 parquet 文件。
   • 在 Google 的文件中了解更多關於建立 GCS bucket 的資訊。
7. 按一下測試連線。
8. 連線驗證完成後，按一下下一步。
9. 選擇要同步的資料來源 (例如：聯絡人、關聯、活動等) 旁邊的核取方塊。
10. 設定同步頻率和排程。
11. 按一下Start sync（開始同步）。

監控同步

設定帳戶間的同步後，您可以從同步詳細資訊頁面檢視同步狀態和歷史記錄：

1. 在你的 HubSpot 帳戶中，瀏覽「資料管理」>「資料整合」。 檢視同步狀態和歷史記錄。
2. 在監控您的匯入與同步下，按一下應用程式同步索引標籤。
3. 按一下搜尋列，然後搜尋Google BigQuery。
4. 按一下Google BigQuery。請注意，如果您設定了雙向同步，可能會出現多個項目。
5. 在同步詳細資訊頁面中，您可以管理和檢視同步設定和歷史記錄：
   • 若要存檔或編輯同步詳細資訊，請在右上方按一下「行動」，然後選擇對應的選項。
   • 若要立即觸發同步，請在右上方按一下立即 同步。
   • 同步的記錄、關聯和錯誤會總結在頁面頂端。
   • 最近的同步活動會顯示在表格中。按一下同步歷史索引標籤，檢視特定的同步嘗試和完成。您可以依特定日期範圍或同步狀態進行篩選。

同步狀態和錯誤處理

下表概述了可能的同步狀態：

如果同步失敗

• 同步詳細資料頁面上會顯示Failed (失敗) 狀態，以及哪些資料表同步成功或失敗的資訊。
• 失敗時不會寫入部分資料：BigQuery 資料表只會在同步成功完成時更新。
• 下一次排定的同步將自動重新嘗試完整同步。
• 您可以隨時從同步詳細資訊頁面手動觸發重新同步。

網路允許列表

同步 HubSpot 資料到第三方供應商（如 BigQuery）是透過 HubSpot 的代理 IP。這些IP範圍會被其他HubSpot整合使用，例如資料同步和webhooks。

如果您的組織限制對 GCP 資源的入站存取，您應該根據您的 HubSpot hublet 允許列出下列 CIDR 範圍：

瞭解如何找出HubSpot 帳戶資料的託管地點。

測試版限制

在測試期間，請記住以下限制：

• 同步頻率：只有有限的同步頻率可用，包括一次、每 6 小時、每 12 小時、每日、每週和每月。您可以隨時從 HubSpot 的同步詳細資料頁面手動觸發重新同步。
• 每個資料類型 只能匯出一次： 每個 HubSpot 帳戶的每個物件類型、事件類型或關聯對只能匯出一次同步設定。
  
  • 例如，如果聯絡人已匯出至一個 BigQuery 目的地，則在原始目的地歸檔之前，無法將其新增至第二個組態。
  • 這可以防止重複的資料管道，並確保資料倉庫中每種資料類型都有單一的真相來源。
• 有限的敏感資料支援：您可以儲存及同步敏感資料到您的 HubSpot 帳戶，但無法同步敏感資料到您的 BigQuery 帳戶。
• 不支持 object_x_views：目前不支持object_x_views对象与 BigQuery 同步。使用object_with_object_properties ，或將objects 與object_properties 連結，以獲得相等的每記錄檢視。

下一步

連接 BigQuery 整合並設定同步設定後，瞭解BigQuery 中同步資料表的模式。