更新日時 2022年 9月 14日
HubSpotデータ同期を使用すると、HubSpotと他のアプリとの間で一方向または双方向の同期を作成して、すべての顧客データを1つのプラットフォームに統合できます。
データ同期を使用するアプリの詳細を参照してください。
連携の要件
- HubSpotアカウント上でスーパー管理者の権限、またはアプリマーケットプレイス権限を付与されている必要があります。
連携アプリを接続する
-
HubSpotアカウントにて、メインのナビゲーションバーに表示される［マーケットプレイスアイコン ］をクリックし、［アプリマーケットプレイス］を選択します。
- 検索バーにアプリ名を入力し、検索結果をクリックします。
- 右上の［アプリをインストール］をクリックします。
- ダイアログボックスで[次へ]をクリックし、アプリアカウントにログインします。
- アクセス許可を求める画面が表示されるので、内容を確認して［許可］をクリックします。その後、HubSpot設定のアプリページにリダイレクトされます。
同じサードパーティーアプリの複数のインスタンスをHubSpotに接続することが可能です。たとえば、2つのMicrosoft Dynamicsアカウントを管理している場合、両方のアカウントのデータを1つのHubSpotアカウントで接続および同期できます。追加アカウントを接続するには、次の手順に従います。
- HubSpotアカウントにて、メインのナビゲーションバーに表示される［マーケットプレイスアイコン ］をクリックします。［管理］の下に表示される［接続されたアプリ］を選択します。
- アプリの名前をクリックします。
- [操作] > [アカウントの管理]をクリックします。
- 右側のパネルで、[別のアカウントを接続]をクリックします。
- アプリをHubSpotに接続する手順を進めます。
データ同期を有効にする
アプリを接続した後、連携する2つのアプリ間でデータの同期を開始するには、アプリの設定を構成して同期をオンにする必要があります。
- HubSpotアカウントにて、メインのナビゲーションバーに表示される［マーケットプレイスアイコン ］をクリックします。［管理］の下に表示される［接続されたアプリ］を選択します。
- アプリをクリックします。
- ［同期をセットアップ］をクリックします。
- [同期するオブジェクトの選択]ページで、同期するオブジェクトを選択し、[次へ]をクリックします。他のアプリとのコンタクトおよびリードの同期の詳細を参照してください。
同期方向を設定する
[構成]画面で、同期方向を選択し、サードパーティ製アプリの項目をHubSpotプロパティにマッピングします。
[同期方向の選択]セクションで、データをHubSpotからサードパーティのアプリに同期する方法を決定します。次の3つのオプションがあります。
- アプリ間のデータ同期:すべての新しいオブジェクト情報と更新されたオブジェクト情報は、2つのアプリ間で同期されます。両方のプラットフォームに既に存在するレコードのプロパティがマージされます。
- データは、サードパーティアプリからHubSpotにのみ同期されます。
- データはHubSpotからサードパーティのアプリにのみ同期されます
[データの競合を解決する]セクションで、ドロップダウンメニューをクリックし、データの不一致がある場合に他のアプリを上書きする既定のアプリを選択します。既定のアプリにフィールド値がない場合、他のアプリのデータは変更されません。この設定は、[同期方向の選択]セクションで選択した同期方向を上書きしません。
フィールドマッピングをカスタマイズする(Operations Hubのみ)
[項目のマップ]セクションで、既定のプロパティマッピングを確認し、HubSpotを使用してサードパーティのアプリからプロパティのカスタムマッピングを設定します。フィールドのマッピングを設定する際には、これらの制限に注意してください。
- マッピングできるのは、プロパティーごとに1回のみです。
- いくつかのプロパティタイプは同期できません（ドロップダウンセレクト、ラジオセレクト、チェックボックスプロパティなど）。
- 複数の値を持つプロパティーはカスタムマッピングで同期できません。これには、各値に「在宅", "勤務」と「その他」を区別するラベルが付いているプロパティが含まれます（メール、電話番号、住所など）。
- 読み取り専用プロパティを同期している場合、どのフィールドに読み取り専用としてフラグが設定されているかに応じて、同期はデフォルトで一方向同期になります。
- サードパーティのアプリのAPIにより、HubSpotがプロパティを読み取ることができない場合があります。この原因は、アプリのAPIによって返されるデータ型に一貫性がないことにあります。
HubSpotのプロパティーとサード パーティー アプリのフィールド間での同期方法については、以下をご覧ください。
| HubSpotプロパティー | サード パーティー アプリのフィールド | |
| テキスト | ⇔ | テキスト |
| 数値 | ⇔ | 数値 |
| 日付入力 | ⇔ | 日付入力 |
| 日時 | ⇔ | 日時 |
| 日付入力 | ⇔ | 日時 |
| 日時 | ⇔ | 日付入力 |
| 1つのチェックボックス | ⇔ | ブール型 |
さらに、サード パーティー アプリの以下のフィールドは、任意のHubSpotのテキストフィールドに一方向でマッピングできます。
- 数値
- 日付入力
- 日時
- 1つのチェックボックス
- これはほとんどのアプリで、ドロップダウン選択フィールド、ラジオ選択フィールド、担当者フィールドにも当てはまります。
次のHubSpotフィールドは、サードパーティのアプリのテキストフィールドにテキストとしてマッピングすることができます。
- 数値
- 日付入力
- 日時
- 1つのチェックボックス
- 複数のチェックボックス
- ドロップダウン選択
- ラジオボタン
- 計算（数値）
- スコア（数値）
- [マッピング を追加]をクリックします。
- ドロップダウンメニューを使用して、マッピングするサードパーティのアプリとHubSpotプロパティを選択します。
- ［更新］をクリックします。
- カスタムマッピングをオフにするには、スイッチをクリックしてオフにします。
同期ルールを設定する
[制限]画面で、HubSpotからサードパーティのアプリにオブジェクトレコードを同期する方法を設定します。
既定では、HubSpotは有効なEメールアドレスがあるコンタクトのみを同期します。これをオフにするには、[重複の変更を減らす]セクションで、[メールアドレスを持つ同期連絡先のみ]チェックボックスをオフにします。
最初の同期中に、HubSpotは両方のデータベースを比較します。一致が検出されると、既存のレコードが更新されます。データ同期では、最初にコンタクトのEメールアドレスを照合し、続いて会社のEメールアドレス、名前、ドメインを比較して、コンタクトレコードの一致を検出します。
会社レコードの場合、データ同期では、会社名またはドメイン名に基づいて各アプリの会社レコードが照合されます。一部のアプリにはドメインフィールドがないため、一部のコネクターでは名前のみをメインの識別子として使用できます。
注意:アプリに会社名とドメインフィールドの両方がある場合、同じ会社名でも別のドメインがある場合、HubSpotは2つのレコードと一致します。逆も同様です。
[同期を記録する制限]セクションで、HubSpotからサードパーティのアプリに同期するレコードを制限する条件を選択します。逆も同様です。
レコードを関連付ける
HubSpotは、接続した元のアプリとの同期中に、可能な限りレコード間の同じ関連付けを維持しようとします（会社とコンタクトとの関連付け、取引と会社との関連付けなど）。
他のアプリから同期しているコンタクトに関連付けられているレコードを表示するには、次の手順に従います。
- オブジェクトの同期のいずれかにある[操作]ドロップダウンメニューをクリックし、[同期設定の編集]を選択します。
- ［ Configure ］をクリックします。
- [フィールドのマップ]セクションで、[すべてのマッピング]ドロップダウンメニューをクリックし、[関連付けマッピング]を選択します。
- サードパーティーアプリから同期しているレコードと、そのオブジェクトへの関連付けが表示されます。
関連レコードは、同じオブジェクトに対して同期が実行されている場合にのみ作成されます。例えば、コンタクトの同期のみで会社の同期がない場合、関連付けられた会社は同期されなくなります。
レコードに複数の会社アソシエーションがある場合は、プライマリ会社のみが同期されます。
ルールを確認して同期を開始する
[確認]画面で、設定したルールを確認し、[保存して同期]をクリックします。その後、初回の同期の処理が開始されます。
初回の同期が完了すると、変更後10分以内にレコードが同期されます。
同期の健全性について
同期の健全性は、HubSpotとサードパーティーアプリの間で現在同期されているすべてのレコード、同期から除外されているレコード、同期に失敗しているレコードをリストアップする診断ツール一式です。
- HubSpotアカウントにて、ナビゲーションバーに表示される［マーケットプレイスアイコン ］をクリックします。
- アプリをクリックします。
- 2つのアプリの間の同期状況を確認できます。これは、特定の時点での同期の処理内容を示します。状況には次のものがあります。
- 有効な同期がありません：同期が開始されていないか、現在一時停止しています。
-
- スキャンされた連絡先/会社の数:同期は、HubSpotと他のアプリの両方で連絡先と会社のレコードをスキャンしています。
- 進行中:すべてのインデックス付きレコードは、同期ルールとフィールドマッピングに従って更新されます。これにかかる時間は、初期同期か継続的同期か、更新して同期を維持する必要があるレコードの数、および他のアプリのAPIの速度によって異なります。
-
- 有効で同期待機中：すべてのレコードが最新です。同期では、更新、変更、新規作成されたコンタクト/会社を対象として、HubSpotとそれに対応するアプリがアクティブに監視されています。HubSpotでの変更は瞬時に同期されますが、他のアプリからの同期には最大で5分かかります。
-
- 連絡先/会社の同期がキューに入っています: HubSpotはHubSpotと他のアプリの間で同期できません。この状態を解消するために何らかのアクションを実行する必要はありません。3つの理由が考えられます。
-
-
- 別のオブジェクトを同期する必要がある。1つのオブジェクトの同期が完了しないと、次のオブジェクトを同期できません（例：会社とコンタクトの両方を同期する場合）。
- 同期アプリのレート制限に達した。制限の調整が完了すると、自動的に同期が続行されます。
- 複数の理由により、このアクションが現在、内部作業キューに入っており、間もなく自動的に同期される予定である。
-
- HubSpotのレコードに加えられた変更は自動的に同期され、HubSpotは5分ごとに他のアプリの変更をポーリングします。HubSpotと他のアプリ間の同期を手動でトリガーするには、[今すぐ同期]をクリックします。そうでない場合は、5分ごとに変更がHubSpotに同期されます。
- 各ステータスの連絡先数とエラーの詳細を右パネルで表示するには、[同期中]、[失敗]、および[除外済み]列の連絡先数をクリックします。
- 同期中：HubSpotと他のアプリの間で現在同期されているすべてのレコードが一覧表示されます。これらのレコードは、設定で選択されている同期フィルターに一致する限り、同期された状態が維持されます。
- 失敗: HubSpotと他のアプリの間で同期されていないすべてのレコードが一覧表示されます。
- 除外:同期内で設定されたフィルタと一致しないすべてのレコード、または電子メールアドレスがないレコードを一覧表示します。
- 右側のスライドインパネルで、特定の取引先責任者レコードを表示します。
データ同期を無効にする
データの同期を無効にすることで、アプリとHubSpotの間でレコードを同期しないようにできます。- HubSpotアカウントにて、メインのナビゲーションバーに表示される［マーケットプレイスアイコン ］をクリックします。［管理］の下に表示される［接続されたアプリ］を選択します。
- アプリをクリックします。
- [操作]ドロップダウンメニューをクリックし、[同期をオフにする]を選択します。
- ポップアップボックスで、［同期を無効化］をクリックします。
同期を無効にしたら、［同期設定を編集］をクリックして再度有効にするか、または同期を削除することができます。
