データ同期のフィールドマッピングを理解する
更新日時 2024年 11月 8日
以下の 製品でご利用いただけます(別途記載されている場合を除きます)。
すべての製品とプラン |
全てのデータ同期アプリには、HubSpotとサードパーティーアプリ間のデータの同期を保つためのフィールドマッピングのセットがあります。アプリで利用可能なデフォルトマッピングを確認するには、アプリのマーケットプレイス一覧ページを参照してください。
Operations Hubの有償サブスクリプションをお持ちの場合、データ同期フィールドのマッピングを作成およびカスタマイズすることができます。
HubSpotのプロパティーがサードパーティーのアプリのフィールドに同期する方法、またはその逆は以下のとおりです。
HubSpotプロパティー | ⇔ | サード パーティー アプリのフィールド |
テキスト | ⇔ | テキスト |
数値 | ⇔ | 数値 |
日付入力 | ⇔ | 日付入力 |
日時 | ⇔ | 日時 |
日付入力 | ⇔ | 日時 |
日時 | ⇔ | 日付入力 |
1つのチェックボックス | ⇔ | ブール値 |
ラジオボタン | ⇔ | ラジオボタン |
ドロップダウン選択 | ⇔ | 選択リスト |
さらに、サードパーティーアプリの以下のフィールドは、HubSpotの任意のテキストフィールドに一方的にマッピングすることができます。
- 数値
- 日付入力
- 日時
- 1つのチェックボックス
- ほとんどのアプリでは、これはオーナーフィールドにも当てはまります。
以下のHubSpotプロパティー( )は、テキストとして、サードパーティーアプリのテキストフィールドに一方通行でマッピングできます(サードパーティーアプリの異なるフィールドタイプに双方向でマッピングできるものもあります)。
- 数値
- 日付入力
- 日時
- 1つのチェックボックス
- 複数のチェックボックス
- 計算(数値)
- スコア(数値)
注:全てのドロップダウン選択プロパティーがHubSpotとサードパーティーアプリの間で双方向に同期できるわけではありません。この場合、ドロップダウンの選択プロパティーは、サードパーティーアプリのテキストフィールドにテキストとして一方的にマッピングされるだけです。
一部のサードパーティーアプリでは、以下の理由によりHubSpotがフィールドを変更できない場合があります。
- サードパーティーアプリからのAPI制限。
- サードパーティーアプリの読み取り専用フィールド。
この場合、これらのフィールドはHubSpotからサードパーティーアプリに一方的にマッピングされます。
デフォルトのデータ同期のフィールドマッピングを見直す
プロパティーの種類によっては、追加のルールや考慮事項があります。以下に、いくつかのデフォルトフィールドマッピングの具体的な要件を確認します。
名前のプロパティー
HubSpotでは、名と姓に別々のコンタクトプロパティーが用意されています。サードパーティーアプリにコンタクト名のプロパティーが1つしかない場合、データ同期ではフルネームの最初の単語が HubSpotの「名」とみなされ、最初のスペース以降が「姓」プロパティーに同期されます。
サードパーティーアプリ | HubSpot |
氏名:John Jacob Jingleheimer Schmidt | 名John 「姓」:ジェイコブ・ジングルハイマー・シュミット |
注:「名」と「姓」の両プロパティーのフィールドマッピングをオンにしないと、コンタクトの名前がHubSpotとサードパーティーアプリの間で正しく同期されませんのでご注意ください。
所有者プロパティー
オブジェクトのレコード担当者は、メールアドレス()プロパティーを使用して同期されます。メールアドレスがない場合、HubSpotはこれらの所有者に名前フィールドを使用します。データ同期を行うには、HubSpotとサードパーティーアプリの両方でレコード担当者をユーザーとしてセットアップする必要があります。ユーザーが一方のアプリに存在し、他方のアプリに存在しない場合、データは同期されません。
有料会員になるとOperations HubサードパーティーアプリのOwnerフィールドをHubSpotのカスタムユーザープロパティーにマッピングすることができます。
ドロップダウン選択プロパティー
HubSpotとサードパーティーアプリの間で最初に同期が作成されると、HubSpotはその時点でドロップダウンのプロパティーのすべての値やオプションを同期します。HubSpotは、新しいオプションが追加されても、ドロップダウンのプロパティーを自動的に更新しません。ドロップダウンのプロパティーを更新するには、HubSpotとサードパーティーアプリ間の同期を保存して再度開始する必要があります。
HubSpotとサードパーティーアプリの間で最初に同期を実行すると、HubSpotはその時点でドロップダウン/複数チェックボックスのプロパティーの全ての値とオプションを同期します。新しいオプションが追加されても、HubSpotはプロパティーを自動的に更新しません。ドロップダウン/複数チェックボックスのプロパティーを更新するには、HubSpotとサードパーティーアプリ間の同期を保存し、再度開始する必要があります。
住所、国名、地域名プロパティー
HubSpotでは、「番地」プロパティーは1行のテキストプロパティーとして、Country/Regionプロパティーはドロップダウン選択プロパティーとして構成されています。他のアプリがこれらのプロパティーのフォーマットを受け入れる方法との不一致により、アドレスプロパティーはサードパーティーアプリから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)の場合、サードパーティーアプリのフィールドにも同じラベルを反映させる必要があります。