メインコンテンツにスキップ
お客さまへの大切なお知らせ:膨大なサポート情報を少しでも早くお客さまにお届けするため、本コンテンツの日本語版は人間の翻訳者を介さない自動翻訳で提供されております。正確な最新情報については本コンテンツの英語版をご覧ください。

インポートファイルの設定

更新日時 2024年 3月 1日

以下の 製品でご利用いただけます(別途記載されている場合を除きます)。

すべての製品とプラン

初めてのCRMとしてHubSpotを使用する場合も、別のシステムからの移行の場合も、インポート処理(取り込み)はレコードとアクティビティーの作成とデータベースの更新に役立ちます。インポートファイルは、ビジネスにおける関係性やプロセスの整理に使用するデータのスプレッドシートです。

ファイルの設定方法については、以下の動画をご覧ください。 

 

のインポートを開始する前に、インポートファイルに関連する HubSpot の規約と要件を確認してください。

用語集

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

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

  • アクティビティー:コンタクトに送信されたEメールや、チケットレコードに記録されたメモなど、レコードに関連付けることができるエンゲージメント。アクティビティーには、コール、Eメール、ミーティング、メモ、タスクがあります。新規Eメールを作成したり、インポートによって既存の通話を更新することはできますが、既存のEメール、ミーティング、メモ、タスクを更新することはできません。コールとタスクは単体でインポートできますが、Eメール、ミーティング、メモはインポートしてCRMオブジェクトに関連付ける必要があります。
  • プロパティー:レコードとアクティビティーに関する情報を格納するために作成されるフィールド。インポートの際には、プロパティーがファイルの列ヘッダーと結び付けられます。

    contact-import-example-1ファイルの例

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

  • 固有(一意の)ID:HubSpot上で各レコードを個別のデータとして認識するために使用されるプロパティー値。インポートでは、重複するレコードの作成を避けるため(例:「Tom Smith」のレコードを2件)、および異なるレコードを関連付けるため(例:「Tom Smith」をインポートしてこの人の会社「Smith Inc.」と関連付ける)に、固有IDが必要です。インポート時に使用できる固有IDを次に示します。
    • Eメール:コンタクトのEメールアドレス。コンタクトのインポート時に重複を避けたりコンタクトを別のオブジェクトと関連付けたりするには、これが必要です。送信元Eメールアドレスがない場合は、レコードID、既存のコンタクトレコードを更新・関連付けしてください。
    • 会社のドメイン名:会社のウェブサイトドメイン(例:example.com)。会社のインポート時に重複を避けたり会社を別のオブジェクトと関連付けたりするには、これが必要です。会社ドメイン名を持っていない場合は、レコードIDを使用して、既存の会社レコードを更新し、関連付けを行います。
    • レコードID: HubSpotが各レコードに与える固有のプロパティー値。HubSpotから既存のレコードをエクスポートすると、各レコードにはレコードIDが付きます。この列は、既存の取引、チケット、またはカスタムオブジェクトをインポートして別のオブジェクトに関連付ける場合に必須です。また、Eメールや会社ドメイン名がない場合に、個々のコンタクトおよび会社の固有の識別情報(ID)としても使用できます。
    • 固有の値を必要とするカスタムプロパティー([コンタクト]、[会社]、[取引]、[チケット]、およびカスタムオブジェクトのみ): 固有の値を必要とするプロパティーを作成した場合、そのプロパティーをインポートファイルで固有IDとして使用できます。
  • 関連付けラベル(「Professional」と「Enterprise」のみ):レコード間の関係を指定する値です。関連付けラベルを作成したら、レコードと関連付けしてインポートすることができる。
  • 列のマッピング:インポート処理の手順で、ファイル内の列ヘッダーとHubSpotプロパティーのひも付け操作を求められます。

例えば、コンタクトおよび会社を1つのファイルにインポートして関連付ける必要があるとします。インポートして関連付けるオブジェクトはコンタクトおよび会社です。各行はコンタクトレコードと、それに関連付けられている会社レコードを表します。各列ヘッダーは、インポート中にマッピングされるプロパティーを表します。以下に示すファイルには、コンタクトのプロパティー(「名」、「姓」、「Eメールアドレス」、「電話番号」、「お気に入りの食べ物」)および会社のプロパティー(「名前」、「会社のドメイン名」)が含まれています。HubSpot上で重複しない2つのレコード(コンタクトの「Eメールアドレス」、会社の「会社のドメイン名」)に結び付けられる各オブジェクトにも、固有のIDがあります。インポート処理中に、HubSpotプロパティーへの列のマッピング([名]列と「名」HubSpotプロパティーなど)を行います。

import-contacts-and-companies-example-1ファイルの例

import-mapping-examples列をプロパティーにマッピング

ファイルの要件と技術的な制限

HubSpotにインポートされる全てのファイルは、次の事項を満たしている必要があります。

インポートツールには、HubSpotサブスクリプションに応じて、さらに技術的な制限があります。この制限には、インポートファイルのサイズと行数の制限、および1日にインポート可能なファイル数と行数の制限が含まれます。

  • HubSpotの無料のツールを使用している場合は、以下の操作が可能です。
    • 最大20MBのファイルをインポートする。
    • 1日に最大50件のインポートを完了する。
    • 1日に最大500,000行をインポートする。500,000行を超えるファイルをインポートする場合は、完了までに数日かかります。
  • アカウントに「Starter」、「Professional」、「Enterprise」のいずれかのサブスクリプションが含まれている場合は、以下の操作が可能です。
    • 最大512MBのファイルをインポートする。
    • 1日に最大500件のインポートを完了する。
    • 1日に最大10,000,000行をインポートする。1ファイルあたりの行数の上限は1,048,576です。インポートAPIを介してインポートしている場合は、1日に最大80,000,000行をインポートできます。

これらの制限は24時間に対して恒常的に適用され、特定の時点でリセットされることはありません。HubSpotのサブスクリプションとその制限事項について、詳細を確認してください。

プロパティーの要件

プロパティー値の形式設定

プロパティー フィールドタイプや、セルに含まれるデータによっては、その他の特定のフォーマット要件があります:
  • Additional emails or domains : 複数のEメールアドレスを持つコンタクトをインポートする場合は、「追加のEメールアドレス」列にセカンダリーEメールアドレスを含めてください。複数のドメイン名を持つ会社をインポートする場合は、セカンダリードメインを含む[追加のドメイン]列を含めます。1つのセルに複数のEメールまたはドメインを含める場合は、各値をセミコロンで区切ります(例:email@email.com; emailtwo@email.com)。コンタクトまたは会社を作成するためにインポートする場合は、新しいコンタクトの「Eメール」または新しい会社の「会社のドメイン名」を、別のレコードで既に使用されている追加のEメール/ドメインに設定することはできません
  • 空白セル:インポートツールはスプレッドシートの空白セルを無視するので、新しいプロパティーデータをインポートする際は、プロパティーの値がないレコードのセルを空白のままにしておきます。HubSpot内で既存のレコードのプロパティーに値がすでにある場合、既存のプロパティー値は空白セルによってクリアされません。既存のプロパティー値を一括してクリアするには、手動で値を編集するか、プロパティー値をクリアワークフローアクションを使用します。
  • チェックボックスプロパティー : についてもっと知る チェックボックスプロパティーへのインポート .
  • カスタム番号、テキスト、または日付プロパティー : 検証ルールを設定した場合、インポートされる値はそのルールに従わなければインポートされません。
  • 日付プロパティー:日付を含むプロパティーの場合、このプロパティーの値の形式を設定するには、次の手順に従います。
    • 月の表記は数字、3文字、またはフルネーム(10、OCT、Oct、OCTOBER、October)、年の表記は2桁または4桁(2023、23)、区切り文字はスラッシュ、ハイフン、またはピリオド(10/28/2023、10-28-2023、10.28.2023)にできます。
    • 有効な日付の書式は、日月年(例:2023/10/28)、月日年(例:10-28-23)、年月日(例:2023.OCT.28)です。 
    • 日付/時刻プロパティーの場合、時刻を含めるにはタイムスタンプをhh:mm(28/10/2020 14:30)という形式で追加します。デフォルトでは、インポートツールは24時間制を採用しています。12時間制を指定する場合は、タイムスタンプにAMまたはPMを追加します(10/28/2020 2:30PM)。タイムスタンプを含めない場合、時刻は既定で真夜中に設定されます。

注:HubSpotの既定の日付プロパティー(例:[クローズ日])をインポートする場合、値はミリ秒単位のUNIXタイムスタンプ形式でなければなりません。Excelファイルをインポートしている場合は、日付/時刻プロパティーのセルは数値の書式でなければなりません。タイムスタンプの値を形式設定する方法、および日付をUNIX形式に変換する方法をご覧ください。

  • パーセンテージ:パーセンテージとしてフォーマットされた数値プロパティーをインポートする場合、%記号または小数で値をフォーマットすることができます。例えば、25%をインポートするには、「25%」または「.25」のいずれかをセルに含める必要があります。
  • 電話番号:「電話番号」および「携帯電話番号」コンタクトプロパティーについて、インポートした電話番号を国コードに基づいて自動的に書式設定する場合は、+[国コード][電話番号]の形式で書式設定します。内線番号がある場合は、ext[内線番号]を追加します。例えば、アメリカ合衆国の国コードを含む電話番号は、+11234567890 ext123のようになります。
  • 価格:価格を含むプロパティーには、HubSpotで利用可能な通貨のいずれかを使用する必要があります。使用可能な通貨とその通貨コードのリストは、アカウントの既定値設定の「通貨」タブで確認できます。
  • 製品プロパティー:
    • 「期間」プロパティー値をインポートする場合は、[期間]列の値を月数(例えば、10か月を表す「10」)、PXM(Xは月数。例えば、6か月を表す「P6M」)、またはPXY(Xは年数。例えば、1年を表す「P1Y」)として書式設定できます。
    • 「請求頻度」プロパティー値をインポートする場合は、製品の価格タイプが定期の場合は[月次]、[年次]、[四半期ごと]を使用します。製品の価格が1回限りの場合は、セルを空白のままにします。
  • 担当者プロパティー:インポート中にレコードまたはアクティビティーに担当者を割り当てるには、次の手順に従います。

必須プロパティー

インポートするオブジェクトやアクティビティーによっては、以下のプロパティーが必須です。これらのプロパティーをファイルの列ヘッダーとして含める必要があります。

  • コンタクト:「名」、「姓」、「Eメール」、(または既存のコンタクトの場合)「レコードID」のうち少なくとも1つ。
  • 会社:「名前」、「会社のドメイン名」、(または既存の会社の場合)「レコードID」のうち少なくとも1つ。
  • 取引:新しい取引を作成する場合は「取引名」、「パイプライン」、および「取引ステージ」。既存の取引の場合は、「レコードID」。
  • チケット:新しいチケットを作成する場合は「チケット名」、「パイプライン」、および「チケットステータス」。既存チケットの場合は「レコードID」。
  • 製品:「単価」、「名前」、(または既存の製品の場合)「レコードID」
  • 商品項目:「名前」、「数量」、「価格」、および関連付けられた取引の「レコードID」または「取引名」。さらに商品項目を製品に関連付ける場合は、製品の「製品ID」を含めてください。これはインポート時に商品項目プロパティーにマッピングされます。

注:取引のある商品項目をインポートする場合、取引金額は更新されません。関連付け:取引金額を更新するには、商品項目を手動で編集するか、HubSpotで商品項目を取引に関連付けます。


  • コール:「通話メモ」。新しいコールをインポートする際には、アクティビティーの日付を含めることも推奨される。
  • Eメール:「Eメールの本文」と「Eメールの方向」。
  • ミーティング:「ミーティングの説明」、「ミーティングの開始時刻」、「ミーティングの終了時刻」。新しいミーティングをインポートする際には、アクティビティーの日付を含めることもお勧めします。開始時刻、終了時刻、アクティビティー日の値は、日付/時刻プロパティーとして書式設定する必要があります。
  • メモ:「メモの本文」。
  • タスク:「タスクのタイトル」と「期日」。期日は日付/時刻プロパティーとして形式設定する必要があります。

注:必須ではありませんが、アクティビティーが発生した日時を指定するために、新しいアクティビティーをインポートする際に、アクティビティーの日付を含めることをお勧めします。このプロパティーを含めない場合、[アクティビティー日]の値は、インポートの日時に自動的に設定されます。

任意指定のプロパティー

追加のプロパティーは必須ではありませんが、データを一括で追加または更新するためにHubSpotにインポートできます。インポートできる追加のプロパティーを以下に示します。

  • HubSpotの既定のコンタクト、会社、取引、チケットのプロパティー(編集不可能な一部の自動設定プロパティーを除く)。コンタクト会社取引チケットプロパティーの既定設定の詳細については、こちらをご覧ください。
  • いずれかのカスタムプロパティーコンタクト、会社、取引、チケット、カスタムオブジェクト用に作成したもの。
  • HubSpotの既定のコール、Eメール、ミーティング、メモ、タスクプロパティー。デフォルトのアクティビティープロパティーについてはこちらをご覧ください。

関連付けと重複の削除の要件

インポート時に重複レコードの回避とレコードの関連付けを行うための要件を以下に示します。同じオブジェクトの関連付けをインポートする場合は、以下のセクションをご覧ください。

  • 1つのファイルで複数のオブジェクトをインポートして関連付けるには、関連するレコードまたはアクティビティーの情報を同じ行に含めます。2つのファイルでは、共通する列を使用して各ファイル内のレコードを接続します。レコードのインポートと関連付けについては、サンプルファイルを参照してください。
  • 既存のレコードの更新、レコードの関連付け、重複レコードの回避を行うには、各オブジェクトの固有の識別情報(ID)プロパティーを含める必要があります。全てのオブジェクトに対して、既存のレコードをエクスポートして、レコード IDを固有IDとして使用するか、カスタムプロパティーを使用して、重複にならない値を必要とするコンタクトには、 Eメールも使えます。会社については、「会社のドメイン名」も使用できます。
    • 複数のオブジェクトをインポートする際に「レコードID」を含める場合は、IDが正しいオブジェクトと一致するようにファイルの列ヘッダーを区別することをお勧めします(例えば、「レコードID - コンタクト」という列と「レコードID - 会社」という別の列を設定します)。
    • コンタクトを重複削除するためにカスタム固有の値プロパティーを使用している場合、「Eメール」プロパティーは依然として固有の値を必要とします。
    • 会社を重複削除するためにカスタム固有の値プロパティーを使用している場合、 「会社ドメイン名」プロパティーは固有の値を必要としません。つまり、重複する会社のドメインをインポートできるようになります。複数の会社が同じドメインで設定されないようにするには、インポートする前に重複するドメインをファイルから削除するか、[会社のドメイン名]を一意のIDとして使用する必要があります。
    • HubSpotに送信元Eメールアドレスを登録している既存のコンタクトの固有IDとして、セカンダリーメールを使用できます。セカンダリーEメールを使用し、ファイルに「レコードID」列を含めなかった場合、プライマリーEメールはセカンダリーEメールに置き換えられません。しかし、ファイルにセカンダリーEメールと「レコードID」の両方を列として含めた場合は、プライマリーEメールがセカンダリーEメールに置き換えられます。

注:一意の関連付け(例:Eメール、会社ドメイン名 , レコードID)を含めない場合、インポートはそれぞれを同じレコードに関連付けるのではなく、重複したレコードを作成します。

flex-associations-import-example

    • 2つのレコードの関係を表すラベルを複数設定するには、1つのセルにセミコロンで区切って複数の関連付けラベル値を含めることができます(例:マネージャー; 請求先コンタクト)。
    • 複数ファイルのインポートで関連付けラベルをインポートする場合、関連付けラベル列と、同じファイル内に関連付けするオブジェクト間の固有ID を含める必要があります。
    • クロスオブジェクト関連付けのペアラベルをインポートする場合は[関連付けラベル]列にラベルの1つを含めるだけです。ラベルは、インポート処理中に正しいオブジェクトに割り当てられます。

同じオブジェクトの関連付けのインポート

1つのファイルをインポートして、同じオブジェクトのレコードを一括で関連付けることができます。ファイルを設定するとき、同じオブジェクトのインポートには以下の固有の要件があります。

以下のサンプルファイルで、RoryとJacksonは、「Eメール」の値を固有IDとして使用し、一意のラベルで既存のコンタクトに関連付けられている新規のコンタクトです。Sookieは、同じラベルを持つ2つの既存のコンタクトに関連付けられた既存のコンタクトです。最初の行で、関連付けラベルはラベルペアの一部です。つまり、インポートが完了すると、関連付けられるレコードには「Parent」というラベルが付けられ、Roryは「Child」というペアラベルを持つことになります。

associate-contacts-file

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

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

1つのオブジェクトまたはアクティビティー

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

ファイルの準備ができたら、1種類のオブジェクトまたはアクティビティーをHubSpotにインポートする方法をご紹介します。

注:製品は、1つのオブジェクトのインポートでのみインポートできます。既存の商品を商品項目に関連付けたり、手作業で商品を取引や見積もりに関連付けることができます

同じオブジェクトの関連付けを持つ1つのオブジェクト

以下のサンプルファイルには、新しいレコードを作成して同じオブジェクトの既存のレコードに関連付けるための必須フィールドが含まれています。

  • コンタクト間:CSV
  • 会社間:CSV
  • 取引間:CSV
  • チケット間:CSV

関連付けを伴う複数オブジェクト

複数のオブジェクト、またはオブジェクトとアクティビティーを1つのファイルにまとめて、または2つのファイルに分けて、各ファイルが1つのオブジェクト/アクティビティーを表すように、インポートおよび関連付けを行うことができます。

1つのファイル内にある複数のオブジェクトをインポート

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

  • コンタクトまたは会社のサンプルスプレッドシート:XLSXまたはCSV
  • 関連付けラベルを含むコンタクトと会社のサンプルスプレッドシート:XLXSまたはCSV
  • コンタクトとチケットのサンプルスプレッドシート:XLSXまたはCSV
  • 会社と取引のサンプルスプレッドシート:XLSXまたはCSV
  • 会社とメモのサンプルスプレッドシート:XLSXまたはCSV
  • 会社、取引、メモのサンプルスプレッドシート:XLSXまたはCSV
  • 取引と新規の商品項目のサンプルスプレッドシート(関連付けられた製品を含む):XLSXまたはCSV1つのファイルでインポートする場合、1つの取引についてインポートできる商品項目は1つだけです。
  • コールとコンタクトのサンプルスプレッドシート:CSV
  • メモとチケットのサンプルスプレッドシート:CSV
  • タスクと既存の取引のサンプルスプレッドシート:CSV
  • Eメールと既存コンタクトのサンプルスプレッドシート:CSV

ファイルの準備ができたら、複数のオブジェクトやアクティビティーを HubSpotにインポートして関連付けする方法を学びましょう。

2つのファイル内にある複数のオブジェクトをインポート

2つのファイルをインポートして関連付けを行う場合は、各ファイルがオブジェクトまたはアクティビティーを表します。2つのファイルのインポートでインポートできるのは、2つのオブジェクト、または1つのオブジェクトと1つのアクティビティーのみです。3つ以上のオブジェクト/アクティビティーをインポートする場合は、1つのファイルでインポートできます。

複数のファイル間で関連付けるレコードを特定するには、両方に共通する列を含めます。一方のファイルには、この列の各行に重複しない固有の値が含まれている必要があります。この値をもう一方のファイルで、各行に関連付けるレコードを示すために使用します。例えば、一般的な使用例は、コンタクトおよび会社をインポートして関連付けることです。次のサンプルファイルでは、「Company Name(会社名)」が共通の列になっています。

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

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

会社ファイルの「Company name」(会社名)列の各行には、重複のない固有の値があります。コンタクトファイルの各行では、「Company name」列の値が、コンタクトの関連付け先となる会社と一致しています。このようなファイルをコンタクトおよび会社のインポートに使用できます。つまり、共通の列があれば、他のオブジェクトを自由に組み合わせることができます。

その他の例には以下のようなものがあります。

  • 2つのファイルに関連付けラベルがある取引と会社:これらのサンプルファイルでは、「会社名」が「会社」オブジェクトの固有のキーです。
    • 取引のサンプルスプレッドシート:XLSXまたはCSV
    • 会社のサンプルスプレッドシート:XLSXまたはCSV
  • 2つのファイルの取引と新規の商品項目:これらのサンプルファイルでは、「取引名」が「取引」オブジェクトの固有のキーです。2つのファイルでインポートする場合は、1つの取引について複数の商品項目をインポートできます。
    • 取引のサンプルスプレッドシート:XLSXまたはCSV
    • 商品項目のサンプルスプレッドシート(関連付けられた製品を含む):XLSXまたはCSV
  • Eメールは共通列で、コンタクトの一意キーである。
    • コールのサンプルスプレッドシート:CSV
    • コンタクトのサンプルスプレッドシート:CSV

ファイルの準備ができたら、複数のオブジェクトやアクティビティーを HubSpotにインポートして関連付けする方法を学びましょう。

この記事はお役に立ちましたか?
こちらのフォームではドキュメントに関するご意見をご提供ください。HubSpotがご提供しているヘルプはこちらでご確認ください。