データ同期のフィールドマッピングを理解する
更新日時 2025年 2月 7日
以下の 製品でご利用いただけます(別途記載されている場合を除きます)。
|
全てのデータ同期アプリには、HubSpotとサードパーティーアプリ間のデータの同期を保つためのフィールドマッピングのセットがあります。アプリで利用可能なデフォルトマッピングを確認するには、アプリのマーケットプレイス一覧ページを参照してください。
Operations Hub Starter、Professional、Enterprise のアカウントをお持ちの場合は、データ同期 フィールドマッピングを作成してカスタマイズできます。
HubSpotのプロパティーがサードパーティーのアプリのフィールドに同期する方法、またはその逆は以下のとおりです。
HubSpotプロパティー | ⇔ | サード パーティー アプリのフィールド |
テキスト | ⇔ | テキスト |
数値 | ⇔ | 数値 |
日付入力 | ⇔ | 日付入力 |
日時 | ⇔ | 日時 |
日付入力 | ⇔ | 日時 |
日時 | ⇔ | 日付入力 |
1つのチェックボックス | ⇔ | ブール値 |
ラジオボタン | ⇔ | ラジオボタン |
ドロップダウン選択 | ⇔ | 選択リスト |
さらに、サードパーティーアプリの以下のフィールドは、任意のHubSpotテキストフィールドに一方向でマッピングできます。
- 数値
- 日付入力
- 日時
- 1つのチェックボックス
- ほとんどのアプリでは、これは所有者(owner)フィールドにも当てはまります。
次のHubSpot プロパティータイプは、サードパーティーアプリのテキストフィールドに テキスト として一方向でマッピングできます(一部のタイプは、サードパーティーアプリの別のフィールドタイプに双方向でマッピングされる場合があります)。
- 数値
- 日付入力
- 日時
- 1つのチェックボックス
- 複数のチェックボックス
- 計算(数値)
- スコア(数値)
注: HubSpotとサードパーティーアプリの間で、すべてのドロップダウン選択プロパティーを双方向に同期できるわけではありません。この場合、ドロップダウン選択プロパティーは、サードパーティーアプリのテキストフィールドにテキストとして一方向にマッピングすることしかできません。
一部のサードパーティーアプリでは、以下の理由によりHubSpotがフィールドを変更できない場合があります。
- サードパーティーアプリからのAPI制限。
- サードパーティーアプリの読み取り専用フィールド。
この場合、これらのフィールドはHubSpotからサードパーティーアプリに一方的にマッピングされます。
デフォルトのデータ同期のフィールドマッピングを見直す
プロパティーの種類によっては、追加のルールや考慮事項があります。以下に、いくつかのデフォルトフィールドマッピングの具体的な要件を確認します。
名前のプロパティー
HubSpotでは、名と姓に別々のコンタクトプロパティーが用意されています。サードパーティーアプリにコンタクト名のプロパティーが1つしかない場合、データ同期ではフルネームの最初の単語が HubSpotの「名」とみなされ、最初のスペース以降が「姓」プロパティーに同期されます。
サードパーティーアプリ | HubSpot |
氏名:John Jacob Jingleheimer Schmidt | 名John 「姓」:ジェイコブ・ジングルハイマー・シュミット |
注フィールドマッピング:コンタクトの名前がHubSpotとサードパーティーアプリで正しく同期されるようにするには、名 と姓 の両方のプロパティー を有効にする 必要があります。
所有者プロパティー
オブジェクトのレコード担当者は、メールアドレス()プロパティーを使用して同期されます。Eメールアドレスがない場合、HubSpot はこれらの担当者の[名前 ]フィールドを使用します。データ同期を行うには、HubSpotとサードパーティーアプリの両方でレコード担当者をユーザーとしてセットアップする必要があります。ユーザーが一方のアプリに存在し、他方のアプリに存在しない場合、データは同期されません。
Operations Hub アカウントをお持ちの場合は、サードパーティーアプリの担当者 フィールドを任意のカスタムHubSpotユーザープロパティーにマッピングできます。
ドロップダウン選択プロパティー
HubSpotとサードパーティーアプリの間で最初に同期を実行すると、HubSpotはその時点でドロップダウン/複数チェックボックスのプロパティーの全ての値とオプションを同期します。HubSpot では、新しいオプションが追加されたりフィールドタイプが変更されたりしても、プロパティーは自動更新されません。ドロップダウン/複数チェックボックスのプロパティーを更新するには、HubSpotとサードパーティーアプリ間の同期を保存し、再度開始する必要があります。これにより、HubSpot とサードパーティーアプリの両方の最新の値が同期されます。
住所、国名、地域名プロパティー
HubSpot では、 番地 プロパティーは単行テキストプロパティーとして構造化され、 国/地域 プロパティーはドロップダウン選択プロパティーとして構造化されます。他のアプリがこれらのプロパティーのフォーマットを受け入れる方法との不一致により、アドレスプロパティーはサードパーティーアプリからHubSpotへの一方的なマッピングとして同期される場合があります。
関連付けマッピング
関連付けをオンにすると、HubSpotからサードパーティーアプリにレコードの関連付けが同期され、逆にHubSpotからサードパーティーアプリにレコードの関連付けが同期されます。例えば、コンタクトは、それぞれの会社や取引記録と関連付けされます。関連付けを行わないようにするには、関連付けのマッピングをオフにします。関連付けの編集や削除はできない。関連付けマッピングの設定について詳細をご確認ください。
電話番号
アプリによっては、プロパティーに複数の値を異なるラベルで保存するものがあります。例えば、1つの電話プロパティーに、「Work ", " Home」、「Mobile」の複数のラベルを設定します。これに対し、HubSpotのデフォルトのコンタクトプロパティーは以下の3つです。電話番号」「携帯電話番号」「FAX番号」です。
サードパーティーアプリによってHubSpotにレコードが作成されると、サードパーティーアプリで最初に表示される電話番号がHubSpotの電話番号プロパティーに同期されます。その他の電話番号は、「携帯電話」または「ファックス」と表示されていない限り、同期されません。その場合、それぞれ携帯電話番号とFAX番号のプロパティーに同期されます。
HubSpotと他のアプリに一致する電話番号がある限り、そのレコードの電話番号はHubSpotとサードパーティーアプリ間で同期しているとみなされます。
電話番号が1つも一致しない場合、HubSpotは同期の競合設定ロジックに従います。同期がHubSpotにデフォルトで設定されている場合、サードパーティーアプリの電話番号のリストに電話番号が追加されます。同期の既定がサードパーティーアプリに設定されている場合、HubSpotの電話番号はサードパーティーアプリにリストされている番号で上書きされます。
HubSpotがサードパーティーアプリで新しいレコードを作成すると、デフォルトで「仕事」ラベルが適用されます。
ビジネスユニット
ビジネスユニット追加オプション がある場合は、HubSpot のビジネスユニットプロパティーとサードパーティーアプリのカスタム マルチチェックボックスまたはテキストフィールドとの間に双方向のフィールドマッピングを設定できます。
取引ステージ、チケットステータス、または注文ステータス
取引ステージ、チケットステータス、注文ステータスのプロパティーを同期するには、サードパーティーの対応するフィールドがHubSpotプロパティーのラベルと一致する必要があります。例えば、HubSpotの取引ステージがClosed Won (Sales Pipeline)の場合、サードパーティーアプリのフィールドにも同じラベルを反映させる必要があります。