概要
HubSpotからデータを転送する設定のDocsです。
制約
HubSpotの内部的なプロパティーが取得対象となった場合
任意の取得対象を選択した際に、HubSpotの内部的なプロパティーが取得対象となることがあります。（例：hoge_a2a17e6eプロパティー）
このような名前の末尾にハッシュ値を含むプロパティーに関して、お客様がHubSpotで管理していないプロパティーである場合は、転送対象のカラムに含める必要がありません。
したがって、転送設定STEP2のカラム定義に、上記のようなプロパティー（カラム）が含まれた場合は、カラム定義から該当のカラムを削除してください。
カスタムプロパティー利用時の補足事項
- 転送元HubSpotでは、HubSpot側にあるメタデータを一部取得し、内部的にカラム名およびデータ型を定義しています。
- HubSpot側でカスタムプロパティーが作成されている場合、カスタムプロパティーの内部名とTROCCO側で定義したカラム名が重複することがあります。
- 取得対象としてオブジェクトを選択した際に、HubSpot側で以下の内部名を持つカスタムプロパティーが作成されている場合は、カスタムプロパティー側のデータが取得されます。
idcreated_atupdated_at
設定項目
STEP1 基本設定
| 項目名 | 必須 | デフォルト値 | 内容 |
|---|---|---|---|
| HubSpot接続情報 | Yes | - | あらかじめ登録してあるHubSpotの接続情報から、今回の転送設定に必要な権限を持つものを選択します。 |
| 取得対象 | Yes | オブジェクト | データの取得対象を以下より選択します。
|
オブジェクトを選択した場合
| 項目名 | 必須 | デフォルト値 | 内容 |
|---|---|---|---|
| オブジェクトタイプ | Yes | - | 取得するオブジェクトを選択します。選択可能なオブジェクト一覧
|
| 転送方法 | Yes | 全件転送 | 全件転送・差分転送のいずれかを選択します。 差分転送について、詳しくは差分転送機能を参照ください。 |
転送元HubSpotの差分転送
転送元HubSpotで差分転送を選択した場合、前回転送時から更新されたレコードが転送されます。
したがって、転送先で追記 (APPEND)方式で転送すると、レコードの重複が発生することがあります。ご注意ください。
アソシエーションを選択した場合
| 項目名 | 必須 | デフォルト値 | 内容 |
|---|---|---|---|
| オブジェクト | Yes | --- | 取得するオブジェクトを選択します。選択可能なオブジェクト一覧
|
| アソシエーションオブジェクト | Yes | - | 選択したオブジェクトに紐づくアソシエーションオブジェクトを選択します。 アソシエーションオブジェクトは、オブジェクト1件に対し最大100件取得されます。 選択可能なアソシエーションオブジェクト一覧
|
エンゲージメントのアソシエーションを選択した場合
| 項目名 | 必須 | デフォルト値 | 内容 |
|---|---|---|---|
| アソシエーションオブジェクト | Yes | - | エンゲージメントに紐づくアソシエーションオブジェクトを選択します。 アソシエーションオブジェクトは、エンゲージメント1件に対し最大100件取得されます。 選択可能なアソシエーションオブジェクト一覧
|
Eメールイベントを選択した場合
| 項目名 | 必須 | デフォルト値 | 内容 |
|---|---|---|---|
| イベントタイプ | Yes | - | 取得するイベントタイプを選択します。選択可能なイベントタイプ一覧
それぞれのイベントタイプについて、詳しくはHubSpot公式ドキュメント - Email Events API Overviewの Event typesを参照ください。 |
| データ取得期間 | No | - | 取得したいデータの開始日時・終了日時を入力できます。 |
パイプラインまたはパイプラインステージを選択した場合
| 項目名 | 必須 | デフォルト値 | 内容 |
|---|---|---|---|
| オブジェクトタイプ | Yes | - | 取得するパイプラインのオブジェクトタイプを選択します。選択可能なオブジェクトタイプ一覧
|