匯入檔案格式

在將資料匯入 HubSpot 之前，請確認您的檔案符合所需的格式及技術限制。部分限制會因訂閱方案而異。請了解哪些檔案類型受到支援、如何結構化及格式化屬性值，以及在特定期間內可匯入的列數與檔案數量。

匯入前，請參閱「匯入入門」文章。

技術需求與限制

• 為 .csv、.xlsx 或 .xls 檔案。
• 僅包含一個工作表。
• 包含標題列，且每欄標題須對應 HubSpot 中的某個屬性。欄標題的排列順序不影響匯入作業。您可在匯入前確認是否已有預設屬性與 標題相符 ，或建立自訂屬性。進一步了解屬性要求。

• 列數少於 1,000 列。
• 若檔案包含外語字元，請使用 UTF-8 編碼。
• 若您正在匯入 Excel 檔案：
  • 資料量須符合 Excel工作表及工作簿的最大限制。
  • 在匯入日期與時間選擇器屬性時，請確保儲存格格式為「數字」。

根據您的HubSpot 訂閱方案，匯入工具還適用其他技術限制。這些限制包括匯入檔案的大小與列數限制，以及每日可匯入的檔案數量與列數上限。

• 若您使用 HubSpot 的免費工具，您可以：
  • 匯入大小不超過 20MB 的檔案。
  • 每日最多可執行 50 次匯入。
  • 每日最多匯入 500,000 行。若檔案行數超過 500,000 行，將需數天時間才能完成。
  • 最多可同時啟動 3 次匯入作業。其中最多 2 次匯入作業的資料行數可超過 10,000 行。若同時啟動 4 次或更多匯入作業，系統將自動排入佇列。 

• 若您的帳戶擁有Smart CRM或Starter、Professional、Enterprise訂閱方案，您可：
  • 匯入大小不超過 512 MB 的檔案。
  • 每日最多可完成 500 次匯入。
  • 每日最多可匯入 10,000,000 行，每檔檔案上限為 1,048,576 行。若透過匯入 API 進行匯入，每日最多可匯入 80,000,000 行。
  • 同時啟動最多 3 個匯入作業。其中最多 2 個匯入作業的資料量可超過 10,000 行。若您同時啟動 4 個或更多匯入作業，系統將將其排入佇列。

這些限制適用於滾動的 24 小時期間，且不會在特定時間重置。進一步了解您的HubSpot 訂閱及其限制。

格式化屬性值

對於匯入檔案的每一列，您可以為屬性欄位新增值。值的格式取決於屬性欄位類型及匯入的目的。

根據屬性欄位類型格式化值

根據屬性欄位類型，有特定的格式化要求：

額外的聯絡人電子郵件或公司網域

若您匯入的聯絡人擁有多個電子郵件地址，請新增「額外電子郵件地址」欄位並填入其次要電子郵件。若您匯入的公司擁有多個網域名稱，請新增「額外網域 」欄位並 填入其次要網域。若要在單一儲存格中包含多個電子郵件或網域，請以分號分隔各值（例如：email@email.com;emailtwo@email.com）。

若您是為了建立聯絡人或公司而進行匯入，請勿將新聯絡人的「電子郵件

或新公司的「公司網域名稱」設定為 其他記錄中已存在的附加電子郵件或網域。

空白儲存格

交易協作者

產品期限與計費頻率

若匯入「期限」屬性值，您可在「期限」欄位中將值格式化為月數（例如10代表 10 個月）、PXM 格式（其中 X 代表月數，例如P6M 代表 6 個月）或PXY 格式（其中 X 代表年數，例如P1Y 代表 1 年）。

若匯入「計費頻率」屬性值，且產品採用週期性定價類型時，請使用monthly、annually 或quarterly。若產品為一次性定價，則將該儲存格留空。

包含必填屬性

根據您匯入的物件或活動類型，以下屬性為建立記錄的必填項目，且必須作為欄位標題包含在您的檔案中。 若您正在更新記錄，必須包含唯一識別碼（例如：記錄 ID、電子郵件、公司網域名稱）。

雖然並非強制要求，但您可以為每個物件匯入額外的屬性，包括自訂屬性和預設屬性。請參閱聯絡人、公司、商機、服務單、通話、電子郵件、會議、筆記及任務的預設屬性。您亦可在屬性設定中檢視所有屬性及其值。

• 聯絡人：至少包含「名字」、「姓氏」或「電子郵件」其中一項。
• 公司：至少包含 「名稱」或「公司網域名稱」其中一項。

請注意： 公司網域名稱屬性僅接受頂級網域（例如 .com、.edu）為止的值。若值後面附有字串（例如 .edu/home），在匯入時將自動移除。 

• 交易：若您正在建立新交易，則需包含「交易名稱」、「銷售管道」及「交易階段」。銷售管道與交易階段必須與您帳戶中的現有選項相符，且交易階段必須是該銷售管道中的有效階段。
• 工單：若 您正在建立新工單，請填寫「工單名稱」、「銷售管道」及「工單狀態」。
• 預約：預約開始時間。預約開始時間應格式化為日期時間屬性。
• 課程：課程名稱。
• 房源：名稱。
• 服務：名稱、銷售管道及銷售管道階段。
• 產品：若 您正在更新產品，請提供記錄 ID或SKU。
  • 若您正在更新單一貨幣帳戶中的產品，請提供單價與 名稱。
  • 若您正在更新使用多種貨幣的帳戶中的產品，請提供價格 [貨幣縮寫]（例如：價格 USD）及 名稱。

• 訂單：名稱、銷售管道及銷售管道階段。
• 購物車：名稱。

• 明細項目： 名稱、數量、價格，以及相關交易之記錄 ID 或交易名稱。 若 您同時將明細項目與產品關聯，請包含該 產品的產品 ID， 此 ID 將在匯入過程中被映射為明細項目的屬性。

請注意：當您將明細項目與交易一併匯入時，匯入程序不會更新交易的金額。若要更新相關交易的金額，您可以手動編輯明細項目，或在 HubSpot 中將明細項目與交易建立關聯。

• 通話： 通話備註。在匯入新通話時，也建議包含 活動日期。
• 電子郵件： 電子郵件正文和 電子郵件方向。
• 會議：會議描述、會議開始時間及會議結束時間。在匯入新會議時，也建議包含 活動日期。開始時間、結束時間及活動日期值應格式化為日期時間屬性。
• 備註：備註內容。
• 任務：任務標題和截止日期。 截止日期 應格式化為日期時間屬性。

請注意：雖然並非強制要求，但在匯入新活動時，建議包含「活動日期」以指定活動發生的日期和時間。若未包含此屬性，系統將自動將「活動日期」值設為匯入時的日期和時間。

更新現有記錄

或

避免重複

的要件

為更新現有記錄並避免重複記錄，您的檔案必須為每個物件包含一個唯一識別碼屬性。對於所有物件，您可以 匯出現有 記錄並使用「 記錄 ID 」 作為唯一識別碼，或使用需要唯一值的自訂屬性。 對於聯絡人，您也可以使用電子郵件。對於公司，您也可以使用公司網域名稱。

若您要匯入多個物件且包含「記錄 ID」，建議區分檔案欄位標題，以便將 ID 與正確的物件配對（例如：一個欄位名為「記錄 ID - 聯絡人」，另一個欄位名為「記錄 ID - 公司」）。

關聯記錄的條件

在單一檔案中匯入關聯關係

在單一檔案中，您可以每行關聯兩個或更多記錄。請在同一行中包含關聯記錄和/或活動的資訊，並為每個物件包含一個唯一識別碼。若要將一個記錄與多個活動或另一個物件的記錄關聯，請針對您要關聯的每個記錄，在多行中包含該記錄的唯一識別碼。

例如，Luke Danes 是 Luke's Diner 的經理，但同時也是 The Dragonfly Inn 的承包商。若要將他與這兩家公司關聯，您需要為 Luke Danes 建立兩行資料，並分別為每家公司包含「電子郵件」（或「記錄 ID」）及「公司網域名稱」（或「記錄 ID」）欄位。

請注意：若未 包含唯一識別碼（例如電子郵件、公司網域名稱、記錄ID），匯入程序將建立重複記錄，而非將各記錄關聯至同一筆記錄。

若您要匯入相同物件的關聯，則有額外要求。

透過兩個檔案匯入關聯

若要關聯兩個檔案中不同物件的記錄，請使用共同欄位來連結各檔案中的記錄。您可以參考範例檔案，以獲取更多關於匯入和關聯記錄的協助。

同一物件關聯

您可以匯入一個檔案，以批次方式關聯同一物件的記錄。在匯入過程中，您需要勾選核取方塊以包含同一物件關聯。

設定檔案時，請在同一行中包含關聯記錄的資訊，並為每個記錄提供唯一識別碼。以下額外要求專用於同一物件匯入：

• 在匯入前，記錄對中至少必須有一筆記錄已存在於 HubSpot 中。例如，您可以匯入新的聯絡人並將其與現有聯絡人建立關聯，但無法透過匯入來建立並關聯兩筆新的聯絡人。
• 在關聯現有聯絡人/公司時，您只能使用主要電子郵件/公司網域作為唯一識別碼。次要電子郵件或網域不被支援。
• 若要將多個記錄與單一記錄建立關聯，請在同一儲存格中以分號分隔各記錄的唯一識別碼值（例如：luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com）。

在下面的範例檔案中，Rory 和 Jackson 是新聯絡人，透過其電子郵件值作為唯一識別碼，並以專屬標籤與現有聯絡人建立關聯。Sookie 則是現有聯絡人，將與兩個具有相同標籤的現有聯絡人建立關聯。在第一行中，關聯標籤屬於一對標籤組合，這表示一旦匯入完成，被關聯的記錄將擁有「Parent」標籤，而 Rory則會擁有配對的「Child」標籤。

父/子關聯

若要透過匯入建立子公司與母公司的關聯，請進一步了解匯入子公司相關資訊。

自訂關聯標籤

若要匯入關聯標籤，請包含「 關聯標籤」欄位。此欄位僅在您希望添加標籤來描述關聯時才需新增。若無需為關聯標記標籤，則此欄位非必要。

• 您必須在匯入前於 HubSpot 中建立關聯標籤。
• 若要將公司關聯設定為主關聯，請在該列的「關聯標籤」欄位中輸入值「Primary」。

• 若要設定多個標籤來描述兩筆記錄之間的關係，您可以在一個儲存格中輸入多個關聯標籤值，並以分號分隔（例如：經理; 帳單聯絡人）。

• 若您透過 多檔案匯入方式匯入關聯標籤，請務必在同一檔案中包含「關聯標籤」欄位，以及您要建立關聯之物件的唯一識別碼。
• 若您正在匯入成對標籤：
  • 對於跨物件關聯，請僅在「關聯標籤」欄位中包含其中一個標籤。系統將在匯入過程中將標籤指派給正確的物件。
  • 對於同一物件的關聯，"關聯 [唯一識別碼]" 欄位 中的記錄將接收在匯入過程中新增的標籤，或檔案中標籤欄位所包含的標籤。該列中的另一筆記錄則會接收該對標籤中的另一項。

範例檔案

在匯入流程開始時，您可以針對選定的物件和活動，產生包含所需屬性的範例檔案。若要檢視更多包含額外屬性的範例，請參閱這篇文章及其範例檔案。

後續步驟

現在您的匯入檔案已準備就緒，請依照相應的匯入指示操作：

• 僅匯入聯絡人。
• 匯入單一物件的記錄。
• 匯入多個物件並使用進階設定。