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