インポートファイルを設定する

HubSpotが最初のCRMであっても、別のシステムから移行している場合でも、レコードを作成してデータベースを更新するにはインポートが役立ちます。インポートファイルは、ビジネス関係やプロセスを整理するために使用されるデータのスプレッドシートです。インポートを開始する前に、インポートファイルに関連するHubSpotの用語と要件を確認してください。

注：レコードに関連付けられたエンゲージメント（Eメール、コール、タスク、またはミーティング）を、ファイル経由でHubSpotにインポートすることはできません。APIを使用したエンゲージメントの追加の詳細をご確認ください。

用語集

• CRMオブジェクト：コンタクト、会社、取引、チケットなど、ビジネスの関係またはプロセスのタイプ。インポートする場合、オブジェクトはHubSpotにインポートするデータセットのタイプです。

• レコード：オブジェクトの個別のインスタンス（例：「Tom Smith」はコンタクトレコードです）。1つのオブジェクトのインポートファイルでは、ファイルの各行が1つのオブジェクトレコードを表します。複数のオブジェクトを1つのファイルでインポートする場合、各行は互いに関連付けられたレコードを表します。

• プロパティー：レコードに関する情報を格納するために作成されたフィールド。インポートでは、プロパティーはファイルの列ヘッダーと一致します。

  
  ファイルの例

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

• 一意なID：HubSpotが各レコードを種類のいずれかに認識するために使用するプロパティー値。インポートでは、2つの異なるレコードを関連付けるため（例：「Tom Smith」をインポートしてこの人の会社「Smith Inc.」と関連付ける）、または重複するレコードの作成を避けるため（例：「Tom Smith」のレコードを2件）、一意のIDが必要です。HubSpotにインポートするときに使用される一意のIDには、次のものがあります。
  • Eメール：コンタクトのEメールアドレス。これは、インポート経由でコンタクトをインポートして別のオブジェクトに関連付ける際に必須です。コンタクトEメールアドレスがない場合は、［コンタクトID］を使用して既存のコンタクトレコードの更新と関連付けを行います。

• 会社のドメイン名：会社のウェブサイトドメイン（例：example.com）。これは、インポート経由で会社を別のオブジェクトに関連付ける際に必須です。会社のドメイン名がない場合は、［会社ID］を使用して既存の会社レコードを更新して関連付けます。
• ［オブジェクト］ID：HubSpotが各レコードに指定した一意のプロパティー値。HubSpotから既存のレコードをエクスポートすると、各レコードは［［オブジェクト］ID］を持つようになります。これは、既存の取引やチケットをインポートして別のオブジェクトタイプに関連付ける場合に必要ですが、Eメールや会社ドメイン名がない場合にコンタクトと会社の一意なIDとして使用することもできます。

• 列をマップ：ファイル内の列ヘッダーとHubSoptプロパティーを照合するよう指示される、インポート処理のステップ。

例としては、コンタクトと会社を1つのファイルにインポートして関連付ける場合があります。インポートして関連付けている「オブジェクト」はコンタクトと会社です。各行は「コンタクトレコード」、およびそれに関連付けられる「会社レコード」を表します。各列ヘッダーは、インポート中にマッピングされる「プロパティー」を表します。以下に示すファイルには、「コンタクトのプロパティー」（名、姓、Eメールアドレス、電話番号、お気に入りの食べ物）および「会社のプロパティー」（名前、会社のドメイン名）が含まれています。HubSpotの2つの一意のレコード（コンタクトの「Eメールアドレス」および会社の「会社のドメイン名」）にリンクする各オブジェクトにも「一意なID」があります。インポート処理中に、HubSpotプロパティーに「列をマップ」（［名］列を［名］HubSpotプロパティーにマッピング）します。

ファイルの例

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

インポート要件

ファイル要件

• .csv、.xlsx、または.xlsファイル。
• 1シートのみ。
• 250,000行未満、1,000列未満。
• 150MBより小さい。
• ヘッダー行が含まれていて、その各列ヘッダーがHubSpotのプロパティーに対応する。インポートする前に、ヘッダーに一致する既定のプロパティーがすでに存在するか、カスタムプロパティーを作成するかを確認できます。HubSpotのコンタクト、会社、取引、チケットの既定のプロパティーの詳細を参照してください。
• 英語以外の文字が含まれる場合は、UTF-8でエンコードされている。

プロパティーの要件

• インポートするオブジェクトによっては、ファイルに次の列が含まれている必要があります。
  • コンタクト：名、または姓、またはEメール（一意なID）

• • 会社：名前または会社のドメイン名（一意なID）。
  • 取引：取引名、パイプライン、および取引ステージ。
  • チケット：チケット名、パイプライン、およびチケットステータス。
  • 製品：名前および単価。
  • コメント：アクティビティーの日付およびコメント本文。
• 日付を含むプロパティーの場合、日付値の形式は次のいずれかでなければなりません。
  • mm/dd/yyyy（例：10/28/2020）
  • dd/mm/yyyy（例：28/10/2020）
  • yyyy/mm/dd（例：2020/10/28）
• インポートの際にコンタクト、会社、取引、またはチケットに担当者を割り当てるには、［オブジェクト］の担当者ヘッダーを含めて、その列の各行に該当するユーザーのEメールアドレスを追加します。インポートによってレコードに割り当てられたユーザーは、新しいレコードが割り当てられたという通知を受け取りません。

• 既存のレコードを更新してレコードの重複を回避するには、各オブジェクトに一意なIDプロパティーを含める必要があります。コンタクトと会社の場合、これはEメールと会社のドメイン名です。すべてのオブジェクトについて、既存のレコードをエクスポートし、一意なIDとして［オブジェクト］IDを使用することができます。ファイルに［［オブジェクト］ID］をインポートする場合は、エクスポートファイルに示されているとおりの正確な列ヘッダーを含める必要があります（例えば、CONTACT IDではなくContact ID）。

注：HubSpotにセカンダリーEメールアドレスがリストされている既存のコンタクトの場合、そのコンタクトの一意のIDとして、セカンダリーEメールを使用できます。セカンダリーEメールを使用する場合、ファイルに［コンタクトID］列を含めないと、セカンダリーEメールがEメールを置き換えることはありません。ただし、ファイルにセカンダリーEメールとコンタクトIDの両方を列として含めると、 セカンダリーEメールがプライマリーEメールを 置き換えます。 

• プロパティーのフィールドタイプによっては、特定の書式設定要件があります。プロパティーのフィールドタイプとチェックボックスプロパティーのインポートの詳細を参照してください。
• 製品をインポートする場合（ProfessionalおよびEnterpriseのみ）：
  • ［期間］プロパティー値をインポートする場合は、［期間］列の値を「PXM」（Xは月数（例：P6Mは6か月の期間））、または「PXY」（Xは年数（例：P1Yは1年の期間））として書式設定します。
  • ［請求頻度］プロパティー値をインポートするには、製品の価格タイプが定期の場合は月次、毎年、四半期ごとを使用します。製品の価格が1回限りの場合は、セルを空白のままにします。

インポートファイルのサンプル

以下のファイルには、各オブジェクトタイプの必須列ヘッダーと、使用可能な追加のヘッダーが含まれています。独自の列ヘッダーを追加して、組織のHubSpotデータベースを維持するために重要な追加のプロパティーを更新または作成できます。

1つのオブジェクト

• コンタクト サンプル スプレッドシート：XLSXまたはCSV
• 会社サンプルスプレッドシート：XLSXまたはCSV
• 取引サンプルスプレッドシート：XLSXまたはCSV
• チケット サンプル スプレッドシート：XLSXまたはCSV
• 製品サンプルスプレッドシート：XLSXまたはCSV

注：製品は1つのオブジェクトインポートでのみインポートでき、インポート経由で別のオブジェクトに関連付けることはできません。製品を取引または見積もりに手動で関連付ける方法の詳細をご確認ください。

複数オブジェクトと関連付け

オブジェクトのインポートと関連付けは、1つのファイル内に一緒に、または各ファイルが1つのオブジェクトを表す2つの別個のファイルで行えます。

1つのファイルで複数のオブジェクトをインポート

1つのファイルで複数のオブジェクトをインポートして関連付けるには、ファイル内の同じ行に関連付けるレコードを含めます。これらのサンプルファイルは一般的な使用例ですが、列ヘッダーを別のオブジェクトのプロパティーに置換することで、オブジェクトを組み合わせて使用できます。

• コンタクトと会社のサンプルスプレッドシート：XLSXまたはCSV
• コンタクトとチケットのサンプルスプレッドシート：XLSXまたはCSV
• 会社と取引のサンプルスプレッドシート：XLSXまたはCSV
• 会社とコメントのサンプルスプレッドシート：XLSXまたはCSV
• 会社、取引、コメントのサンプルスプレッドシート：XLSXまたはCSV

2つのファイルで複数のオブジェクトをインポート

2つのファイルでインポートして関連付ける場合、各ファイルはオブジェクトを表します。ファイルに関連付けるレコードを特定するには、両方に共通する列を含めます。1つのファイルでは、この列の各行に一意の値が必要です。他のファイルでは、それらの値を使用して、各行を関連付けるレコードを指定します。

例えば、一般的な使用例は、コンタクトと会社をインポートして関連付けることです。次のサンプルファイルで、会社名は共通の列です。

• 会社サンプルスプレッドシート：XLSXまたはCSV

• コンタクト サンプル スプレッドシート：XLSXまたはCSV

会社ファイルでは、［会社名］列の各行に一意の値があります。コンタクトファイルの各行では、［会社名］列の値が、コンタクトが関連付けられる会社と一致します。

これらのファイルを使用してコンタクトと会社をインポートできます。または、共通の列を含めていれば、他のオブジェクトを組み合わせて使用できます。ファイルの準備ができたら、1つのオブジェクトをインポートする方法または複数のオブジェクトをHubSpotにインポートするおよび関連付ける方法をご確認ください。