インポートファイルをセットアップ
更新日時 2024年 12月 27日
以下の 製品でご利用いただけます(別途記載されている場合を除きます)。
すべての製品とプラン |
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] または [Yes] に設定して [Yes] または [Checked] HubSpotを表示するか、[False or No] に設定して [No] または [Check in HubSpot] として表示します。 |
テキスト |
検証ルールを設定している場合、インポートする値はそのルールに従っている必要があります。さもないと、その値はインポートされません。 |
ユーザー (所有者) |
インポート中に担当者をレコードまたはアクティビティーに割り当てるには、次のようにします。
|
追加のコンタクト Eメールまたは会社ドメイン
複数のEメールアドレスがあるコンタクトをインポートする場合は、 追加のEメールアドレス 列とそのセカンダリー Eメールを含めます。複数のドメイン名を持つ会社をインポートする場合は、セカンダリードメインを含む[追加のドメイン]列を含めます。1つのセルに複数のEメールまたはドメインを含める場合は、各値をセミコロンで区切ります(例:email@email.com; emailtwo@email.com)。
コンタクトや会社を作成するためにインポートする場合、新しいコンタクトの Eメール または新しい会社の 会社ドメイン名を、別の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」では契約社員です。彼を両方の会社に関連付けるには、各会社に Eメール (または レコード ID) と 会社ドメイン (または レコード ID) の列を持つ Luke Danes の 2 つの行を含める必要があります。
注:固有の識別情報( 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」というペアラベルを持つことになります。
親/子の関連付け
インポートによって親子会社 関連付けを作成するには、 子会社のインポートについて詳細をご確認ください。
カスタム関連付けラベル(「プロフェッショナル 」および 「エンタープライズ 」のみ)
関連付けラベルをインポートするには、 関連付けラベル 列を含めてください。インポートする前に、HubSpotで 関連付けラベルを作成する 必要があります。
- 会社の関連付けをプライマリーに設定するには、その行のAssociation label列に、値Primary。
- 2つのレコードの関係を表すラベルを複数設定するには、1つのセルにセミコロンで区切って複数の関連付けラベル値を含めることができます(例:マネージャー; 請求先コンタクト)。
- 複数ファイルのインポートで関連付けラベルをインポートする場合、関連付けラベル列と、同じファイル内に関連付けするオブジェクト間の固有ID を含める必要があります。
- ペアのラベルをインポートする場合:
- クロスオブジェクト関連付けの場合は、 関連付けラベル 列に いずれかのラベル のみを含めます。ラベルは、インポート処理中に正しいオブジェクトに割り当てられます。
- 同じオブジェクト関連付けの場合、 関連付けられた[固有ID] 列内のレコードには、インポート処理で 追加されたラベル、またはファイルのラベル列に含まれているラベルが割り当てられます。行内のペアの一方のレコードは、もう一方のラベルを受け取ります。
サンプルファイル
インポートプロセスの開始時に、選択したオブジェクトとアクティビティーに必要なプロパティーを含む サンプルファイルを生成 できます。追加のプロパティーを含む他の例を確認する場合は、 サンプルファイルに関するこの記事を参照してください。