ベータHubSpotをGoogle BigQueryに接続

Google BigQueryのデータを、コンタクト、会社、取引、関連付けなどのHubSpot CRMオブジェクトや、アカウントのその他のデータと同期します。

以下のセクションでは、Google BigQueryアプリを認証し、Google CloudアカウントとHubSpotとの同期設定を設定する方法について説明します。

Google BigQuery 連携を接続して設定する

Google BigQueryアカウントをHubSpotに接続する手順は、次の通りです。

1. HubSpotアカウントにて、上部のナビゲーションバーに表示されるマーケットプレイスアイコン をクリックし、［HubSpotマーケットプレイス］を選択します。
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サービスアカウントのEメールをコピーします。

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を指定する必要があります。

注: BigQuery データセットが置かれる GCP プロジェクトへの Google Cloud 管理者アクセス権と、HubSpot が Parquet ファイルをステージングする Google Cloud Storage(GCS)バケットが必要です。

1. 右側のペインで、[HubSpot→Google BigQuery]を選択します。
2. HubSpotによって生成されたGoogleサービスアカウントのEメールをコピーします。

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ファイルを参照します。
   • GCSバケットの作成について詳しくは、Googleの ドキュメントをご覧ください。
7. [接続をテスト]をクリックします。
8. 接続が検証されたら、[次へ]をクリックします。
9. 同期するデータソース(コンタクト、関連付け、イベントなど)の横にあるチェックボックスをオンにします 。
10. 同期の頻度とスケジュールを設定
11. [同期を開始]をクリックします。

同期監視

アカウント間の同期を設定したら、同期の詳細ページで同期のステータスと履歴を確認できます。

1. HubSpotアカウントにて、［データ管理］＞［データ連携］の順に進みます。
2. [インポート & 同期をモニタリング]で、[アプリの同期] タブをクリックします。
3. 検索バー をクリックし、Google BigQueryを検索します。
4. [ Google BigQuery]をクリックします。両方向の同期を設定した場合、複数のエントリが表示される場合があります。
5. 同期の詳細ページでは、同期の設定と履歴を管理して確認できます。
   • 同期の詳細をアーカイブまたは編集するには、右上の [アクション ]をクリックし、対応する オプションを選択します。
   • 直ちに同期をトリガーするには、右上の[ 今すぐ同期 ]をクリックします。
   • 同期されたレコード、関連付け、エラーはページの上部に要約されます。
   • 最近の同期アクティビティーがテーブルに表示されます。特定の同期の試行と完了を確認するには、[ 同期履歴 ]タブをクリックします。特定の日付範囲または同期ステータスで絞り込むことができます。

同期ステータスとエラー処理

同期で発生する可能性のあるステータスを次の表に示します。

同期に失敗した場合:

• 同期の詳細ページに[失敗] ステータスが、同期に成功したテーブルまたは失敗したテーブルの情報とともに表示されます。
• 障害時に部分的に書き込まれたデータはありません: BigQuery テーブルは、同期が正常に完了した場合にのみ更新されます。
• 次に予定されている同期では、自動的に完全同期が再試行されます。
• 同期の詳細ページから、いつでも手動で再同期をトリガーできます。

ネットワーク許可リスト

BigQuery などのサードパーティープロバイダーへのHubSpotデータの同期は、HubSpotのプロキシーIP経由でルーティングされます。これらのIP範囲は、データ同期やWebhookなどの他のHubSpot連携で使用されます。

組織でGCPリソースへのインバウンドアクセスを制限している場合、HubSpotハブレットに基づいて次のCIDR範囲を許可リストに登録する必要があります。

HubSpotアカウントのデータがホスティングされている場所 を確認する方法をご覧ください。

ベータ版の制限

このベータ版では、以下の制限事項に留意してください。

• 同期頻度: 1回、6時間ごと、12時間ごと、毎日、毎週、毎月など、限られた同期頻度のセットのみを使用できます。HubSpotの同期の詳細ページから、いつでも手動で再同期をトリガーできます。
• データタイプごとに1回のエクスポート:各オブジェクトタイプ、イベントタイプ、または関連付けペアは、HubSpotアカウントごとに1つの同期設定でのみエクスポートできます。
  
  • たとえば、連絡先がすでに 1 つの BigQuery 宛先にエクスポートされている場合、元の宛先がアーカイブされるまで、連絡先を 2 番目の構成に追加することはできません。
  • これにより、データパイプラインの重複が防止され、データウェアハウス内のデータタイプごとに信頼できる単一の情報源が確保されます。
• センシティブデータのサポートが制限されている: センシティブデータを保存して HubSpot アカウントに同期することはできますが、センシティブデータを BigQuery アカウントに同期することはできません。
• object_x_views のサポートなし: object_x_views オブジェクトは現在のところ BigQuery との同期はサポートされていません。object_with_object_propertiesを使用するか、 objects を object_properties に結合して、同等のレコードごとのビューを取得します。

次のステップ

BigQuery 連携を接続して同期設定を行ったら、 BigQuery で同期されるテーブルのスキーマについて学びます。