インポートツールについて

インポートして、コンタクト、会社、取引、サービス、アクティビティーなどのオブジェクトをHubSpotに追加します。スプレッドシートをアップロードし、その列をHubSpotプロパティーにマッピングすることによって、新しいレコードの作成、既存のレコードの更新、およびレコード間の関係の定義を行うことができます。ファイルをアップロードする前に、以下のインポート手順と用語を確認して、データが正しくフォーマットされていることをご確認ください。

HubSpotを初めてご利用で、既存のCRMデータをHubSpotのCRMに移行したい場合は、HubSpotのReplatforming Teamにデータ移行をリクエストできます。

用語集

• CRMオブジェクト:コンタクト、会社、取引、チケットなど、顧客およびビジネスプロセスに関する情報。インポート処理での オブジェクト とは、HubSpotにインポートするデータセットのタイプです。

• レコード:オブジェクトの個々の実データ(例えば「Neal Caffrey」はコンタクトレコードです)。1種類のオブジェクトのインポートファイルでは、ファイル内の各行が1つのオブジェクトレコードを表します。1つのファイル内にある複数のオブジェクトをインポートする場合、各行は互いに関連付けられた複数のレコードを表します。

• アクティビティー：コンタクトに送信されたEメールや、チケットレコードに記録されたメモなど、レコードに関連付けることができるエンゲージメント。インポートツールでサポートされるアクティビティーには、電話、Eメール、ミーティング、メモ、タスクなどがあります。
• プロパティー：レコードとアクティビティーに関する情報を格納するために作成されるフィールド。インポートの際には、プロパティーがファイルの列ヘッダーと結び付けられます。
• マッピング:インポートファイル内の列を、対応するHubSpotプロパティーと照合するプロセス。インポート中には、列がどのようにHubSpotプロパティーにマッピングされているかを確認して確認します。 

次の例では、インポートされるオブジェクトはコンタクトです。各行はコンタクトレコードを表します。各列の情報はコンタクトプロパティー（「名」、「姓」、「Eメールアドレス」）を表します。

サポート対象のオブジェクトとアクティビティー

実行できるインポートのタイプと、それぞれでサポートされるオブジェクトとアクティビティーを以下に示します。

単一オブジェクトまたはアクティビティーのインポート

インポートを行うことで、一度に1つのオブジェクトまたはアクティビティーを作成または更新できます。一つのオブジェクトのインポートでは、次のことができます。

• コンタクト、会社、取引、チケット、アポイントメント、コース、リスト、サービス、コール、製品、プロジェクト、注文、カート、サブスクリプション、 カスタムオブジェクト レコードを作成または更新できます。

• タスクを作成しますが、更新 はしません 。

複数のオブジェクトとアクティビティーのインポート

インポートを行うことにより、複数のオブジェクトやアクティビティーを一度に作成、更新、関連付けることができます。複数のオブジェクトとアクティビティーを1つのファイルにまとめてインポートすることも、2つまたは1つのオブジェクトと1つのアクティビティーを別々のファイルにまとめてインポートすることも可能です。2 つの個別のファイルを使用する場合は、ファイルに共有列が含まれている必要があります。

複数のオブジェクトのインポートでは、次の操作を行うことができます。

• コンタクト、会社、取引、チケット、アポイントメント、コース、リスト、サービス、コール、注文、プロジェクト、カート、 カスタムオブジェクト レコードを作成または更新できます。
• コンタクトと会社、コンタクトと取引、プロジェクトとタスクなどのレコードを関連付けます。
• 商品項目を作成または更新するが、取引に関連付ける 必要がある 。
• Eメール、ミーティング、メモ、タスクの作成はするが、更新 はしない 。Eメール、ミーティング、メモはオブジェクトに関連付ける必要があります。

例:2つのファイルを使用して2つのオブジェクトをインポートする

別のデータベースからHubSpotに取り込む2つのファイルがあり、1つはコンタクトを含み、もう1つは取引を含みます。どちらも[取引名 ]列を共有しており、この列がコンタクトファイル内の関連コンタクトと一致します。インポートの際には、共通の列として「取引名 」を使用し、コンタクトファイルの固有のキーとします。これにより、HubSpotのコンタクトに取引を関連付ける際に、[ 取引名 ]プロパティーの値を列に入力できるようになります。

その他の種類のインポート

インポートページから他のツールのインポートプロセスにアクセスすることもできますが、これらの手順はオブジェクトまたはアクティビティーのインポートとは異なります。

• オプトアウトスプレッドシートのインポート
• カスタムイベントのインポート
• データセットのインポート

インポートファイルのセットアップ

インポートツールにファイルをアップロードする前に、ファイルを適切に設定して、データがアカウントに正しく追加されるようにすることが重要です。次のセクションでは、ファイルを正しく設定するための重要な概念と要件について説明します。

事前作成済みのサンプルファイルについては、 こちらの記事を参照してください。

要件

技術的な制限と一般的な要件については、 インポートファイルをセットアップをご覧ください。

固有ID

固有IDとは、HubSpotが各レコードを個別のデータとして認識するために使用されるプロパティー値です。インポートでは、 レコードを更新し、 重複するレコードの作成を避ける（例：「Tom Smith」に対して2件のレコード）、および相互にレコードを関連付ける（例：「Tom Smith」をインポートして、このコンタクトの会社「Smith Inc.」に関連付ける）ために、固有IDが必要になります。コンタクトと会社については、データ品質を維持するために、インポート時にそれぞれの固有の識別子(Eメール、会社のドメイン名)を使用することをお勧めします。

インポートの際に使用できる固有IDは、以下のとおりです。

• Eメール：コンタクトのEメールアドレス。コンタクトのインポート中にこのシークレットを含めることで、重複の防止、既存レコードの更新、コンタクトと別のオブジェクトとの関連付けを行うことができます。コンタクトのEメールアドレスがない場合は、既存のコンタクトレコードの更新と関連付けに レコードID を使用します。
• 会社のドメイン名：会社のウェブサイトドメイン（例：example.com）。会社のインポート時にこのシークレットを含めることで、重複の防止、既存のレコードの更新、別のオブジェクトへの会社関連付けを行うことができます。会社のドメイン名がない場合は、既存の会社レコードの更新と関連付けに レコードID を使用します。
• レコードID：HubSpotによって各レコードに付与される固有のプロパティー値。レコードIDを表示して使用するには、既存のレコードをエクスポート します。これは、取引、チケット、アポイントメント、コース、リスト、サービス、アクティビティー、およびカスタムオブジェクトのデフォルトの固有IDです。また、Eメールや会社ドメイン名がない場合に、コンタクトおよび会社の固有の識別情報(ID)としても使用できます。インポート中に 「レコードID 」がマッピングされた場合、そのレコードIDは他のマッピングされた固有のIDよりも優先されます。
• 固有の値を必要とするカスタムプロパティー:固有の値を必要とする、ユーザーが作成したカスタムプロパティー。このプロパティーはインポートファイル内で固有のIDとして使用できます。これらのプロパティーは、コンタクト、会社、取引、チケット、アポイントメント、コース、リスト、サービス、およびカスタムオブジェクトで使用できます。

例:レコードID を使用して既存の取引を更新 

パイプライン内の既存の全ての取引について、複数のプロパティーを更新したい。これらの取引をエクスポート して、編集するプロパティーと 「レコードID」のみを含めます。スプレッドシート内で必要な更新を行い、[レコードID ]列はそのままにします。取引のインポート を実行し、プロセスの列をマッピングする部分でレコードID を固有の識別子として使用する。

関連付け

インポートによって レコード同士を関連付け たり、 関連付けラベル を追加してレコード間の関係を指定したりすることもできます。これには、取引からコンタクトへのクロス オブジェクトの 関連付けや、コンタクトからコンタクトへの 同一オブジェクト 間の関連付けが含まれます。 

インポートファイルに関連付けを適切に含める方法の詳細をご確認ください。

例:コンタクトの同じオブジェクトの関連付けをインポートする

コンタクトオブジェクトを使用して、マネージャーと個々のコントリビューター(IC)の関係を追跡している。マネージャーはすでにHubSpotに存在します。両方のコンタクトのプライマリーEメールを別々の列に含めるように1つのインポートファイルを設定します( 例:管理Eメール、 ICメール)。マネージャーのEメールプロパティーの値は、HubSpotにすでにあるものと一致する必要があります。コンタクトのインポートを開始し、同じオブジェクトの関連付けを作成する オプションを選択し 、残りの詳細を設定したら、インポートは完了です。カスタム 関連付けラベル を使用して、関係にラベルを付けることもできます。

マッピングガイド

[ コンタクトのプロパティーに[オブジェクト]の列をマッピング する]ページでは、ヘッダー、ヘッダー言語、およびプロパティー名に基づいて、ファイル内の列が選択したオブジェクトのプロパティーに自動的にマッピングされます。

[マッピングガイド]セクションで展開アイコンをクリックし、以下の項目を確認します。

• プロパティー:オブジェクトの作成や更新に必要なプロパティー。インポートの目標を達成するために必要なプロパティーがファイルに欠けている場合(既存の取引の更新を選択したものの、[レコードID]列を含めていなかった場合など)は、以下のいずれかの方法でインポートファイルを修正する必要があります。
  •  スプレッドシートを修正してインポートを再開してください。
  • [マッピング済み ]列で[ [x]件のエラー ]をクリックして、インポートプロセス中に解決します。マッピング中のエラーの管理について詳細をご確認ください。 
• エラー:1,000行までのエラー数。ファイルがこれよりも大きい場合、エラーがマッピング ガイド カードに表示されない場合があります。

列をプロパティーにマッピングする

インポートツールにファイルをアップロードすると、インポート処理のステップとして、HubSpotプロパティーにファイル内の列ヘッダーを一致するように求められます。マッピングを正しく行うことで、データがHubSpotに追加されたときに、そのデータが正しい場所（正しいオブジェクトとプロパティー）に移動されます。

例えば、コンタクトファイルの場合、列「名」を「名」コンタクトプロパティーにマッピングします。 

複数のオブジェクトを関連付けるファイルの場合、各列に対応するオブジェクトとプロパティーを選択します。

• ファイルの列ヘッダー:インポートファイルからのヘッダーの名前。
• 情報のプレビュー:スプレッドシートの列の最初の3行のプレビュー。
• マッピング済み:HubSpotプロパティーにマッピングされた列のステータスを表示します。[マッピングされたすべてのステータス] ドロップダウンメニューをクリックしてステータスタイプを表示し、順にテーブルを並べ替えます。特定のエラーが検出されると、 exclamation アラート アイコンが表示されます。[[x]件のエラー ]をクリックして、解決方法を確認してください。
• [次の形式としてインポート]:ドロップダウンメニューで、インポートする[オブジェクト]プロパティー(タスクプロパティーなど)を選択するか、列をインポートしないオプションを選択できます。
• HubSpotプロパティー:ドロップダウンメニューで列にマッピングするHubSpotプロパティーを選択します。
• 既存の値を管理:CRMのレコードの既存の値を上書きするチェックボックス。マッピングステータスまたはオブジェクトでマッピングページを絞り込むには、ドロップダウンメニューをクリックし、表示するステータスまたはオブジェクトを選択します。 

インポートエラー

インポート中にエラーが発生した場合は、以下の方法で管理できます。

• インポート中: アカウントに追加される前に、特定のエラーを管理し てデータを修正してください。

• インポート後:インポート後にエラーが発生した場合は、 そのエラーを確認してトラブルシューティング を行い、影響を受けるデータを追加または更新します。

HubSpotでデータを更新するその他の方法

• 会社の自動作成と関連付け :Eメールドメインと企業ドメインが一致するコンタクトおよび会社の場合、コンタクトのEメールドメインに基づいて 、自動的に会社を作成してコンタクトに関連付ける 設定をオンにします。コンタクトに会社のドメインとは異なるEメールドメインがある場合や、他のオブジェクトをインポートする場合は、設定をオフにし、インポートを使用してレコードを関連付ける手順に従ってください。この設定により、誤った会社が作成されるのを防止できます。
• HubSpotデータ同期:別のシステム内にデータがあり、双方向同期を設定する場合は、 HubSpotに接続してデータを同期する方法をご確認ください。