測試版將 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 資料檢視者 」和 「BigQuery 工作使用者」角色。

4. 從您的 Google Cloud 帳戶中複製專案 ID。
5. 返回 HubSpot，貼上該專案 ID，然後點擊「測試連線」。
6. 確認連線無誤後，請點擊「下一步」 以 完成設定。

將 HubSpot 資料同步至您的 Google BigQuery 帳戶

若要將 HubSpot 資料傳送至 Google BigQuery，您需在 Google Cloud 帳戶中設定一位具備必要權限的使用者，並指定相關的 GCP 專案及 GCS 儲存桶 URI。

請注意：您需要具備 Google Cloud 管理員權限，才能存取將存放 BigQuery 資料集的 GCP 專案，並需有一個 Google Cloud Storage (GCS) 儲存桶，供 HubSpot 暫存 Parquet 檔案。

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

3. 在您的 Google Cloud 帳戶中，前往專案的 IAM 設定，使用從 HubSpot 複製的服務帳戶電子郵件建立新使用者，然後為該新建立的使用者新增「BigQuery 資料檢視者」、「BigQuery 工作使用者」及「儲存空間物件擁有者」角色。

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 儲存桶。
7. 點擊「測試連線」。
8. 確認連線無誤後，請點擊「下一步」。
9. 勾選您要同步的資料來源旁邊的核取方塊（例如：聯絡人、關聯、活動等）。
10. 設定同步頻率與排程。
11. 點擊「開始同步」。

監控同步狀況

在設定好帳戶之間的同步後，您可以從「同步詳細資訊」頁面查看同步狀態和歷史紀錄：

1. 在你的 HubSpot 帳戶中，點擊「更多」，然後前往「資料管理」 > 「資料整合」。如果你的帳戶中沒有顯示「更多」，請直接前往「資料管理」 > 「資料整合」。
2. 在「監控您的匯入與同步」下方，點選「應用程式同步」分頁。
3. 點擊搜尋欄，並搜尋「Google BigQuery」。
4. 點擊「Google BigQuery」。請注意，若您已設定雙向同步，可能會出現多個項目。
5. 在同步詳細資訊頁面上，您可以管理及檢視同步設定與歷史紀錄：
   • 若要歸檔或編輯同步詳細資訊，請在右上角點選「動作」，然後選擇對應的選項。
   • 若要立即觸發同步，請在右上角點選「立即 同步」。
   • 已同步的記錄、關聯關係及錯誤會彙總顯示於頁面頂端。
   • 最近的同步活動將顯示於表格中。點擊「同步歷史記錄」分頁，即可檢視特定的同步嘗試與完成紀錄。您可以根據特定日期範圍或同步狀態進行篩選。

同步狀態與錯誤處理

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

若同步失敗：

• 同步詳細資訊頁面上將顯示「失敗」狀態，並附有哪些資料表同步成功或失敗的相關資訊。
• 失敗時不會產生部分寫入的資料：BigQuery 資料表僅會在同步成功完成後才會更新。
• 下次排定的同步作業將自動重新嘗試執行完整同步。
• 您可隨時從同步詳細資訊頁面手動觸發重新同步。

網路白名單

將 HubSpot 資料同步至 BigQuery 等第三方服務供應商的過程，會透過 HubSpot 的代理 IP 進行路由。這些 IP 範圍亦會被其他 HubSpot 整合功能（例如資料同步和 Webhooks）所使用。

若您的組織限制對 GCP 資源的傳入存取，您應根據您的 HubSpot hublet，將以下 CIDR 範圍加入白名單：

瞭解如何查明您的 HubSpot 帳戶資料託管於何處。

測試版限制

在本次 Beta 測試期間，請留意以下限制：

• 同步頻率：目前僅提供有限的同步頻率選項，包括「一次」、「每 6 小時」、「每 12 小時」、「每日」、「每週」及「每月」。您可隨時透過 HubSpot 中的同步詳細資訊頁面手動觸發重新同步。
• 每種資料類型限一次匯出：每個 物件類型、事件類型或關聯對，在每個 HubSpot 帳戶中僅能透過一組同步設定進行匯出。
  
  • 例如，若聯絡人資料已匯出至某個 BigQuery 目標，則在原始目標被歸檔之前，無法將其新增至第二個設定中。
  • 此機制可避免資料管線重複，並確保您的資料倉儲中每種資料類型僅有一個可信來源。
• 對敏感資料的支援有限：您可以將敏感資料儲存並同步至您的 HubSpot 帳戶，但無法將敏感資料同步至您的 BigQuery 帳戶。
• 不支援 object_x_views：目前不支援將object_x_views 物件與 BigQuery 同步。請使用object_with_object_properties ，或將objects 與object_properties 進行聯結，以取得等效的每筆記錄檢視。

後續步驟

在您完成 BigQuery 整合的連線並設定好同步設定後，請進一步了解BigQuery 中同步資料表的資料結構。