Hubspot Export Integration

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Cursorに接続

  CursorにMCPサーバーをインストール
• VS Codeに接続

  VS CodeにMCPサーバーをインストール

HubSpot Import Integrationについて詳しく知る。

Treasure DataからHubSpot Marketing Cloudへ直接データをエクスポートできます。HubSpotは、マーケティング、営業、カスタマーサービスを連携するために必要なソフトウェア、インテグレーション、リソースを備えたAI搭載のカスタマープラットフォームです。

前提条件

• toolbeltを含むTreasure Dataの基本的な知識。
• Treasure Dataに権限を付与できるHubSpotアカウント。

制限事項

null の company_id を繰り返し送信すると、会社レコードの重複が発生します。データのスキップを許可する代わりにレコードの作成を指定した場合、NULL の company_id またはHubSpot上に存在しない company_id により、HubSpot上で新しい company_id を持つ会社レコードが作成されます。同じ結果セットに対して同じクエリを再実行すると、重複したレコードが表示されます。

この制限を解決するには、次回の実行前に company_id の値を取り込み、Treasure Data内の既存レコードを重複排除して、これらの重複を減らしてください。

Treasure Data Integration の静的 IP アドレス

セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。

リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります: https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/

必要なHubspot設定

HubSpotポータルで Automatically create and associate companies with contacts の設定を有効にして、コンタクトが会社に自動的に関連付けられるようにする必要があります。

一括挿入/更新機能を無効にする場合は、まずターゲットのContactsを使用してコンタクトを作成する必要があります。各会社のデータは、HubSpotポータルの Automatically create and associate companies with contacts 設定がオンかオフかに関わらず、自動的に作成されます。

詳細については、Create or update a group of the contacts pageを参照してください。

新しい認証の作成

Treasure Dataでは、クエリを実行する前に、エクスポート時に使用するデータコネクションを作成および設定する必要があります。データコネクションの一部として、インテグレーションにアクセスするための認証を提供します。

1. TD Consoleを開きます。

2. Integrations Hub > Catalog に移動します。

3. Hubspotを検索して選択します。

次のダイアログが開きます。

4. Click here to connect to a new account. を選択します。

まだログインしていない場合はHubspotにログインするためのページへ、またはTreasure Dataへのアクセス許可を付与する同意ページにリダイレクトされます。

Treasure Dataへのアクセスを許可すると、TD Consoleにリダイレクトされます。

5. Integrations Hub > Catalog に移動します。

6. 再度Hubspotを選択します。

7. New Authenticationダイアログが開きます。

8. ドロップダウンリストからアカウント名を含むOAuth接続を選択します。

9. Continue を選択します。

10. 接続に名前を付けます。

11. Done を選択します。

クエリの定義

1. Creating a Destination Integrationの手順を完了します。
2. Data Workbench > Queries に移動します。
3. データをエクスポートしたいクエリを選択します。
4. クエリを実行して結果セットを検証します。
5. Export Results を選択します。
6. 既存のインテグレーション認証を選択します。
7. 追加のExport Resultsの詳細を定義します。エクスポートインテグレーションの内容で、インテグレーションパラメータを確認してください。 例えば、Export Results画面が異なる場合や、追加で入力する詳細がない場合があります：
8. Done を選択します。
9. クエリを実行します。
10. 指定した宛先にデータが移動したことを検証します。

HubSpotの統合パラメータ

宛先の選択内容によって、パラメータは異なります。次の表は、すべての可能なパラメータを示しています。

以下のパラメータを編集し、Doneを選択します。

次の表は、HubSpotエクスポートの統合パラメータを説明しています：

クエリの例

新しいコンタクトの作成

select 'test@edm.com' as EMAIL, 'tester' as firstname, 'll' as lastname, '650-000-1234' as phone, 'test' as address,
'a' as city, 'CA' as state, '60599' as zip

コンタクトプロパティの更新

-- firstnameの値を更新
select 'firstname' as name, 'test1@samplecom.com' as email, 'newContactName' as value

新しい企業の作成

select '1234567890' as company_id, 'www.testwebsite.com' as website

企業プロパティの更新

-- nameの値を更新
select '1234567890' as company_id, 'name' as name, 'www.google.com' as website, 'NewCompanyName' as value

コンタクトの作成/更新とリストへの追加

select 'test@edm.com' as EMAIL, 'Jonh' as firstname, 'Doe' as lastname, '650-000-1234' as phone, 'test' as address, 'a' as city, 'CA' as state, '60599' as zip

Audience Studio で Segment をアクティベートする

Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。

1. Audience Studio に移動します。
2. parent segment を選択します。
3. ターゲット segment を開き、右クリックして、Create Activation を選択します。
4. Details パネルで、Activation 名を入力し、前述の Configuration Parameters のセクションに従って activation を設定します。
5. Output Mapping パネルで activation 出力をカスタマイズします。

• Attribute Columns
  • Export All Columns を選択すると、変更を加えずにすべての列をエクスポートできます。
  • + Add Columns を選択して、エクスポート用の特定の列を追加します。Output Column Name には、Source 列名と同じ名前があらかじめ入力されます。Output Column Name を更新できます。+ Add Columns を選択し続けて、activation 出力用の新しい列を追加します。
• String Builder
  • + Add string を選択して、エクスポート用の文字列を作成します。次の値から選択します:
    • String: 任意の値を選択します。テキストを使用してカスタム値を作成します。
    • Timestamp: エクスポートの日時。
    • Segment Id: segment ID 番号。
    • Segment Name: segment 名。
    • Audience Id: parent segment 番号。

6. Schedule を設定します。

• スケジュールを定義する値を選択し、オプションでメール通知を含めます。

7. Create を選択します。

(オプション) Query Export ジョブをスケジュールする

Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。

Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。

2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。

例えば、cron スケジュールが '0 0 1 * 1' の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。

TD Console を使用してジョブをスケジュールする

1. Data Workbench > Queries に移動します

2. 新しいクエリを作成するか、既存のクエリを選択します。

3. Schedule の横にある None を選択します。

4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します:

   ドロップダウン値	説明
   Custom cron...	Custom cron... の詳細を参照してください。
   @daily (midnight)	指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。
   @hourly (:00)	毎時 00 分に実行します。
   None	スケジュールなし。

Custom cron... の詳細

 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- day of week (0 - 6) (Sunday=0)
 |    |    |    +---------- month (1 - 12)
 |    |    +--------------- day of month (1 - 31)
 |    +-------------------- hour (0 - 23)
 +------------------------- min (0 - 59)

次の名前付きエントリを使用できます:

• Day of Week: sun, mon, tue, wed, thu, fri, sat.
• Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec.

各フィールド間には単一のスペースが必要です。各フィールドの値は、次のもので構成できます:

1. (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

クエリの実行

クエリに名前を付けて保存して実行するか、そのままクエリを実行します。クエリが正常に完了すると、クエリ結果は指定されたコンテナの送信先に自動的にインポートされます。

Workflowでのエクスポート結果の設定（オプション）

Treasure Workflow内で、このデータコネクタを使用してデータをエクスポートするよう指定できます。

詳細については、TD Toolbeltを使用したWorkflowでのデータエクスポートを参照してください。