HubSpotは、企業が訪問者を引き付け、リードを変換し、取引を成立させることを支援するインバウンドマーケティングおよび営業プラットフォームです。この連携を使用してHubSpotデータをTDにインポートすることで、データサイロを排除し、すべてのタッチポイントにわたる顧客行動を理解し、顧客とのより関連性の高いタイムリーなインタラクションを作成し、より良いリテンションとロイヤルティを実現します。
この連携では、Contacts、Companies、Contact Lists、Email events、Engagement activities、Deals、その他のデータオブジェクトなど、さまざまなHubSpotオブジェクトがサポートされています。
- Treasure Dataの基礎知識
- HubSpotの基礎知識
セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。
リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります: https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/
データ接続を設定する際、連携にアクセスするための認証情報を提供します。Treasure Dataでは、認証を設定し、ソース情報を指定します。
- Integrations Hub > Catalog に移動します
- HubSpot を検索して選択します
- Create Authentication を選択し、HubSpotアカウントのOAuthを提供します
- Integration Hubにリダイレクトされた後、上記の手順を繰り返します（今回は提供したOAuthが表示されます）。認証の名前を入力し、Done を選択します
- TDコンソールを開きます
- Integrations Hub > Authentications に移動します
- 新しい認証を見つけて New Source を選択します
- 最初のステップ
1 - Connectionで、Data Transfer Name フィールドにソース名を入力し、Next を選択します
以下のパラメータを使用してTreasure Dataに取り込むデータを特定し、Next を選択します。
後方互換性をサポートするため、この連携では以下のデータオブジェクトにAPI V1を使用します：
- Contacts（カスタム属性を含む）
- Companies（カスタム属性を含む）
- Contact Lists
- Email events
- Engagement activities
- Deals（カスタム属性を含む）
API V1では、Contacts、Companies、Email eventsの増分読み込みが可能です
- Start date：HubSpotでデータオブジェクトを取得する開始日
- Number of days to fetch：取得する日数。過去最大30日まで取得できます
API V1の既知の制限事項：
- すべてのカスタム属性がサポートされているわけではありません
- データインポートには10,000レコードの上限があります
API V3
より新しいAPIバージョンであるAPI V3は、より多くのデータオブジェクトをサポートし、10kレコード制限を回避するために使用されます
| フィールド | 説明 | |
|---|---|---|
| Source |
| |
Object Name | インポートするデータオブジェクト名。（サポートされているデータオブジェクトの完全なリストについては、HubSpotを参照してください。）
| |
| Incremental Column | （API v3 Search の場合 - 必須）増分読み込みおよび/またはフィルタリングに使用される列。 | |
| Fetch All Properties | （API v3 Search の場合）チェックを外すと、データオブジェクトのデフォルトプロパティのみがインポートされます。 | |
| Incremental | （API v3 Search の場合）チェックを入れると、前回の実行以降の新しいデータのみがインポートされます。 | |
| Start Date Time End Date Time | (API v3 Searchの場合) 開始時刻から終了時刻までのデータがインポートされます。これらのオプションは初期データロードに便利です。 |
オプションで、高度なデータ設定を変更できます。Nextを選択して次のステップに進みます。
4 Data Previewステップで、Generate Previewを選択して、インポートを実行する前にデータのサンプルを確認します(オプション)。- Nextを選択して続行します。
データ配置については、データを配置するターゲットdatabaseとtableを選択し、インポートを実行する頻度を指定してから、SaveまたはSave & Run Nowを選択します。
- TD Toolbelt: 最新バージョンのTD CLIツールをインストールしてください: TD Toolbelt
- Authentication ID: TD Consoleでこのインテグレーションのauthenticationを作成するには、上記の手順に従ってください。その後、authentication画面のURLの最後の部分でIDを確認できます。
- YML設定ファイル(例:
**load.yml**)を作成し、**td\_authentication\_id**フィールドで作成したauthenticationを参照します。 詳細については、以下のParameter ReferenceおよびExampleを参照してください - 次のコマンドを使用して、入力データをプレビューします(オプション):
$ td connector:preview load.yml - 次のコマンドを使用して、データインポートをトリガーします:
$ td connector:issue load.yml --database db-name --table table-name - 次のコマンドを使用して、実行をスケジュールします:
$ td connector:create daily\_import "10 0 \* \* \*" db-name table-name load.yml
次の表は、CLI経由でHubSpotインポートインテグレーションを設定するためのパラメータについて説明しています。
| Name | Description | Value | Default value | Required |
|---|---|---|---|---|
td_authentication_id | UIで取得したauthentication id | numeric | N/A | Yes |
target | ソース。contacts、engagements、companies、deals、contact_lists、email_events、properties、searchのいずれか。 | String | contacts | |
additional_properties | 追加のCustom Properties。targetがcontacts、companies、またはdealsの場合にのみ適用されます。 | String | N/A | |
object_names | オブジェクトのpropertiesを取得するためのカンマ区切りのオブジェクト名。targetがpropertiesの場合にのみ適用されます。 | String | N/A | targetがpropertiesの場合はYes |
object_name | search API v3を使用する際に取り込むオブジェクト。targetがsearchの場合のみ適用されます | String | N/A | targetがsearchの場合は必須 |
incremental_column | search API v3を使用する際に増分読み込みに使用するカラム。targetがsearchの場合のみ適用されます | String | N/A | |
fetch_all_properties | オブジェクトのすべてのプロパティを取得するかどうかを決定します。チェックを入れると実行にレイテンシが追加される可能性がありますが、より多くの情報が提供されます。targetがsearchの場合のみ適用されます | Boolean | false | |
incremental | 前回実行時以降の新しいデータのみをインポートするかどうか。targetがcontacts、companies、deals、email_events、またはsearchの場合のみ適用されます | Boolean | false | |
from_date | データを取り込む開始日（ISO-8601形式）。incrementalがtrueで、targetがcontacts、engagements、companies、deals、contact_lists、またはemail_eventsの場合のみ適用されます | Datetime | N/A | |
fetch_days | 開始日から何日分のデータを取得するか。incrementalがtrueで、targetがcontacts、engagements、companies、deals、contact_lists、またはemail_eventsの場合のみ適用されます | Number | 1 | |
start_time | データを取り込む開始時刻（ISO-8601形式）。targetがsearchの場合のみ適用されます | Datetime | N/A | |
end_time | データを取り込む終了時刻（ISO-8601形式）。targetがsearchの場合のみ適用されます | Datetime | N/A |
in:
type: hubspot
td_authentication_id: 330392
additional_properties: "prop_1, prop_2, prop_3"
custom_properties_chunk_size: 100
retry_intial_wait_msec : "500" # initial waiting time as 0.5 second
retry_limit : "10"
max_retry_wait_msec : "90000" # maximum 1.5 minute of waiting time for each retry
from_date: 2016-09-01T00:00:00.000Z
fetch_days: 2
out:
mode: append- このインテグレーションの定期実行については、TD Toolbeltを使用したスケジューリングを参照してください
- ワークフローから作成したSourceをトリガーする方法については、TD WorkflowとIntegrationsの使用を参照してください