インポートファイルをセットアップ
更新日時 2025年 2月 14日
以下の 製品でご利用いただけます(別途記載されている場合を除きます)。
|
HubSpotにデータをインポートする前に、次の制限と要件を確認してください。サンプルファイルにアクセスするか、サンプルファイルを生成して、作業を開始することもできます。
インポートツールについて詳しくは、こちらの記事をご覧ください。ファイルの準備ができたら、インポート方法を確認してください。
技術的な要件と制限
HubSpotにインポートされる全てのファイルは、次の事項を満たしている必要があります。- .csv、.xlsx、または.xlsファイル。
- 1シートのみが含まれている。
- ヘッダー行が含まれていて、その各列ヘッダーがHubSpot内の特定のプロパティーに対応する。列のヘッダーを任意の順序で整理することができます。それによってインポートが影響を受けることはありません。インポートする前に、デフォルトプロパティーが既に存在するかどうかを確認することができます。あなたのヘッダーにマッチするように、カスタムプロパティーを作成することができます。インポートする前に、 カスタムプロパティーを作成することができます。プロパティーの要件の詳細を確認してください。
- 含まれる列は1,000未満である。
- 英語以外の文字が含まれる場合は、UTF-8でエンコードされている。
- Excelファイルをインポートする場合:
- Excelのワークシートとブックの最大制限を超えないデータが含まれている。
- 日付と時刻入力のプロパティーをインポートするときに数値形式のセルが含まれている。
インポートツールには、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のサブスクリプションとその制限事項について、詳細を確認してください。
値の書式設定
インポートファイルの各行に、プロパティー列の値を追加できます。値の書式設定は、プロパティー フィールド タイプとインポートの目標によって異なります。
プロパティー フィールド タイプに基づいて値の書式を設定する
プロパティーのフィールドタイプに応じて、特定の書式要件があります。
フィールドタイプ | 要件 |
日付入力 日時入力 |
月の表記は数字、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)形式で追加でき、CSVファイルまたはテキスト数値形式のセルを含むExcelファイルではUNIXタイムスタンプ(ミリ秒単位)として追加できます。タイムスタンプを含めない場合、時刻はデフォルトで真夜中に設定されます。 |
所要時間 |
「通話時間」プロパティーなど、期間を含むプロパティーの場合、値はミリ秒単位のUNIXタイムスタンプとしてフォーマットする必要があります。タイムスタンプの値を形式設定する方法、および日付をUNIX形式に変換する方法をご覧ください。 |
列挙 |
インポートファイルの値は、ラベルまたはプロパティーの定義 済みオプションの内部値に一致する必要があります。 HubSpotのデフォルトの列挙プロパティー(例: ライフサイクルステージ , インダストリー )の場合、値は内部値または英語のラベルと一致する必要があります。 |
ファイル |
既存のファイルをファイルプロパティーに追加するには、値として「ファイルID」を含めます。ファイルのIDは、ファイルの詳細の「全般」セクションで確認できます。 |
複数のチェックボックス |
複数の値をインポートするには、各値の間にスペースなしでセミコロンを追加します(値1;値2)。これらのプロパティーオプションは、インポート前に作成される必要があります。 値を追加するには、最初の値の前にセミコロンを追加します(;値3;値4)。これにより、既存のプロパティーの値を上書きすることなく、値が追加されます。 |
数値 |
作成された数値プロパティーのタイプに基づいて値の書式を設定します。
|
1つのチェックボックス |
1つのチェックボックスフィールド用の列を作成し、各行の値を[True]または[はい]に設定して、HubSpotで[はい]またはチェック済みとして表示されるようにするか、[False]または[いいえ]に設定して、HubSpotで[いいえ]または未チェックで表示されるようにします。 |
用語のプロパティー |
商品項目プロパティーの「語句」は、PnYnMnDまたはPnWのISO-8601期間形式で追加する必要があります。例えば、年間契約の場合はP12MまたはP24Mです。空白にすると、既定の期間が設定されます。 |
テキスト |
検証ルールを設定している場合、インポートする値はそのルールに従っている必要があります。さもないと、その値はインポートされません。 |
ユーザー(所有者) |
インポート中にレコードまたはアクティビティーに担当者を割り当てるには、次の手順に従います。
|
追加のコンタクトEメールまたは会社ドメイン
複数のEメールアドレスがあるコンタクトをインポートする場合は、 追加のEメールアドレス 列とそのセカンダリー Eメールを含めます。複数のドメイン名を持つ会社をインポートする場合は、セカンダリードメインを含む[追加のドメイン]列を含めます。1つのセルに複数のEメールまたはドメインを含める場合は、各値をセミコロンで区切ります(例:email@email.com; emailtwo@email.com)。
コンタクトまたは会社を作成するためにインポートする場合は、新しいコンタクトの「Eメール」または新しい会社の「会社のドメイン名」を、別のレコードですでに使用されている追加のEメール/ドメインに設定することはできません。
空白セル
インポートツールはスプレッドシートの空白セルを無視するので、新しいプロパティーデータをインポートするときは、プロパティーの値がないレコードのセルを空白のままにしておきます。HubSpot内で既存のレコードのプロパティーに値がすでにある場合、既存のプロパティー値は空白セルによってクリアされません。既存のプロパティー値を一括でクリアするには、 手動で値を編集する か 、 プロパティー値をクリア ワークフローアクション を使用します 。コラボレーション取引担当者
インポートによって取引に協力者を追加する場合、[コラボレーション取引担当者]ヘッダーを含めます。各セルには、セミコロンで区切って2人以上のユーザーを含める必要があります(例:user1@example.com;user2@example.com)。製品の期間と請求頻度
「期間」プロパティー値をインポートする場合は、[期間]列の値を月数(例えば、10か月を表す「10」)、PXM(Xは月数。例えば、6か月を表す「P6M」)、またはPXY(Xは年数。例えば、1年を表す「P1Y」)として書式設定できます。
「請求頻度」プロパティー値をインポートする場合は、製品の価格タイプが定期の場合は[月次]、[年次]、[四半期ごと]を使用します。製品の価格が1回限りの場合は、セルを空白のままにします。
必須プロパティー
インポートするオブジェクトまたはアクティビティーに応じて、レコードを作成するには次のプロパティーが必要です。また、これらのプロパティーをファイルに列ヘッダーとして含める必要があります。レコードを更新する場合は、固有のID(レコードID、Eメール、会社のドメイン名など)を含める必要があります。
必須ではありませんが、オブジェクトごとにカスタムプロパティーや既定のプロパティーなど、追加のプロパティーをインポートできます。コンタクト、会社、 取引、チケット、コール、Eメール、ミーティング、メモ、タスクの既定のプロパティーを参照してください。プロパティー設定で全てのプロパティーとその値を表示することもできます。
- コンタクト:「名」、「姓」、または「Eメール」のうち少なくとも1つ。
- 会社:「名前」または「会社のドメイン名」のうち少なくとも1つ。
- 取引:新しい取引を作成する場合は「取引名」、「パイプライン」、および「取引ステージ」。
- チケット:新しいチケットを作成する場合は「チケット名」、「パイプライン」、および「チケットステータス」。
- 予定:「予定の開始」。予定の開始は、日時プロパティーとして書式設定する必要があります。
- コース:「コース名」。
- リスト:「名前」。
- サービス:「名前」、「パイプライン」、および「パイプラインステージ」。
- 製品:製品を作成する場合は、「単価」と「名前」。
- 注文:「名前」、「パイプライン」、および「パイプラインステージ」。
- 商品項目:「名前」、「数量」、「価格」、および関連付けられた取引の「レコードID」または「取引名」。さらに商品項目を製品に関連付ける場合は、製品の「製品ID」を含めてください。これはインポート時に商品項目プロパティーにマッピングされます。
注:取引のある商品項目をインポートする場合、取引金額は更新されません。関連付けられた取引金額を更新するには、 手動で商品項目を編集するか、商品項目をHubSpotの取引に関連付けます。
- コール:「通話メモ」。新しいコールをインポートする際には、アクティビティーの日付を含めることも推奨される。
- Eメール:「Eメールの本文」と「Eメールの方向」。
- ミーティング:「ミーティングの説明」、「ミーティングの開始時刻」、「ミーティングの終了時刻」。新しいミーティングをインポートする際には、アクティビティーの日付を含めることもお勧めします。開始時刻、終了時刻、アクティビティー日の値は、日付/時刻プロパティーとして書式設定する必要があります。
- メモ:「メモの本文」。
- タスク:「タスクのタイトル」と「期日」。期日は日付/時刻プロパティーとして形式設定する必要があります。
注:必須ではありませんが、アクティビティーが発生した日時を指定するために、新しいアクティビティーをインポートする際に、アクティビティーの日付を含めることをお勧めします。このプロパティーを含めない場合、[アクティビティー日]の値は、インポートの日時に自動的に設定されます。
既存のレコードを更新するか、重複を回避するための要件
既存のレコードを更新してレコードの重複を回避するには、ファイルに各オブジェクトに固有のIDプロパティーを含める必要があります。全てのオブジェクトについて、既存のレコードをエクスポートし、 そのレコード IDを固有のIDとして使用するか、固有の値を必要とするカスタムプロパティーを使用することができます。 コンタクトには、Eメールを使用することもできます。会社については、「会社のドメイン名」も使用できます。
複数のオブジェクトをインポートする際に「レコードID」を含める場合は、IDが正しいオブジェクトと一致するようにファイルの列ヘッダーを区別することをお勧めします(例えば、「レコードID - コンタクト」という列と「レコードID - 会社」という別の列を設定します)。
注:ファイルに「Eメール」または「会社のドメイン名」が含まれている場合は、以下の動作が適用されます。
- コンタクトを重複削除するためにカスタム固有の値プロパティーを使用している場合、「Eメール」プロパティーは依然として固有の値を必要とします。
- 会社を重複削除するためにカスタム固有の値プロパティーを使用している場合、 「会社ドメイン名」プロパティーは固有の値を必要としません。つまり、重複する会社のドメインをインポートできるようになります。複数の会社が同じドメインで設定されないようにするには、インポートする前に重複するドメインをファイルから削除するか、[会社のドメイン名]を固有のIDとして使用する必要があります。
- HubSpotに送信元Eメールアドレスを登録している既存のコンタクトの固有IDとして、セカンダリーメールを使用できます。セカンダリーEメールを使用し、ファイルに「レコードID」列を含めなかった場合、プライマリーEメールはセカンダリーEメールに置き換えられません。しかし、ファイルにセカンダリーEメールと「レコードID」の両方を列として含めた場合は、プライマリーEメールがセカンダリーEメールに置き換えられます。
レコードを関連付けるための要件
1つのファイルでの関連付けのインポート
1つのファイルでは、1行につき2つ以上のレコードを関連付けることができます。関連付けられたレコードやアクティビティーに関する情報を同じ行に含め、各オブジェクトの固有IDを含めます。1つのレコードを別のオブジェクトの複数のアクティビティーまたはレコードと関連付けるには、そのレコードの固有のIDを、関連付けたい各レコードに対応する複数の行に含めます。
例えばLuke Danes氏は「Luke's Diner」では店長ですが、「The Dragonfly Inn」では契約社員です。同氏を両方の会社に関連付けるには、Luke Danesに対応する2つの行を含めて、会社ごとに「Eメール」(または「レコードID」)列と「会社のドメイン名」(または「レコードID」)列を使用する必要があります。
注:固有のID(例:「Eメール」、「会社のドメイン名」、「レコードID」)を含めない場合、インポートによってそれぞれが同じレコードに関連付けられるのではなく、重複レコードが作成されます。
同じオブジェクト関連付けをインポートする場合、追加の要件があります。
2つのファイル内の関連付けをインポート
2つのファイル内の2つのオブジェクトのレコードを関連付けるには、共通の列を使用して各ファイル内のレコードを接続します。レコードのインポートと関連付けの詳細については、サンプルファイルを参照できます。
同じオブジェクトの関連付け
1つのファイルをインポートして、同じオブジェクトのレコードを一括で関連付けることができます。インポート処理中、同じオブジェクト間の関連付けを含めるチェックボックスを選択する必要があります。
ファイルを設定するときは、関連するレコードに関する情報を同じ行に含め、各レコードの固有IDを含めます。以下の追加要件は、同一オブジェクトのインポートに固有の要件です。
- インポートする前に、レコードペアのレコードの少なくとも1つがすでにHubSpotに存在する必要があります。例えば、新しいコンタクトをインポートして既存のコンタクトに関連付けることはできますが、インポートで2つの新しいコンタクトを作成して関連付けることはできません。
- 既存のコンタクト/会社を関連付ける際に固有のIDとして使用できるのは、プライマリーEメールアドレス/会社ドメインのみです。セカンダリーEメールアドレスやドメインはサポートされていません。
- 1つのレコードに複数のレコードを関連付けする場合は、同じセル内でレコードの固有ID値をセミコロンで区切ります(例:luke@lukesdiner.com; rory@yale.edu; sookie@dragonfly.com)。
以下のサンプルファイルで、RoryとJacksonは、「Eメール」の値を固有IDとして使用し、固有のラベルで既存のコンタクトに関連付けられている新規のコンタクトです。Sookieは、同じラベルを持つ2つの既存のコンタクトに関連付けられた既存のコンタクトです。最初の行で、関連付けラベルはラベルペアの一部です。つまり、インポートが完了すると、関連付けられるレコードには「Parent」というラベルが付けられ、Roryは「Child」というペアラベルを持つことになります。

親と子の関連付け
インポートによって親子会社 関連付けを作成するには、 子会社のインポートについて詳細をご確認ください。
カスタム関連付けラベル(「Professional」および「Enterprise」のみ)
関連付けラベルをインポートするには、 関連付けラベル 列を含めてください。この列は、関連付けを説明するラベルを追加する場合にのみ追加する必要があります。関連付けにラベルを付ける必要がない場合、列は必要ありません。
- インポートする前に、HubSpotで 関連付けラベルを作成する 必要があります。
- 会社の関連付けをプライマリーに設定するには、その行のAssociation label列に、値Primary。
- 2つのレコードの関係を表すラベルを複数設定するには、1つのセルにセミコロンで区切って複数の関連付けラベル値を含めることができます(例:マネージャー; 請求先コンタクト)。
- 複数ファイルのインポートで関連付けラベルをインポートする場合、関連付けラベル列と、同じファイル内に関連付けするオブジェクト間の固有ID を含める必要があります。
- ペアのラベルをインポートする場合:
- クロスオブジェクト関連付けの場合は、「関連付けラベル」列にいずれかのラベルのみを含めます。ラベルは、インポート処理中に正しいオブジェクトに割り当てられます。
- 同じオブジェクト関連付けの場合、 関連付けられた[固有ID] 列内のレコードには、インポート処理で 追加されたラベル、またはファイルのラベル列に含まれているラベルが割り当てられます。行内のペアの一方のレコードは、もう一方のラベルを受け取ります。
サンプルファイル
インポートプロセスの開始時に、選択したオブジェクトとアクティビティーに必要なプロパティーを含むサンプルファイルを生成できます。追加のプロパティーを含む他の例を確認する場合は、サンプルファイルに関するこの記事を参照してください。