格式化匯入檔案

在將資料匯入 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 年）。

若

要匯入

「計費頻率」屬性值，當產品採用「定期計費」類型時，請使用「每月」、「每年」或「每季」

；

若產品採用「一次性計費」，則將儲存格留空。

包含必填屬性

根據您要匯入的物件或活動類型，以下屬性為建立記錄的必填項目，且必須作為欄位標題包含在您的檔案中。 若要更新記錄，必須包含唯一識別碼（例如：記錄 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 仍會將跨行相同物件的資料視為單一記錄處理。若各行之間的物件資料有所不同，則會建立或更新獨立的記錄。此行為不適用於 「僅建立新 [記錄]」或「僅更新現有 [記錄]」的匯入操作。 

例如，若兩行資料包含與名為「Q4 Deal」的交易相關聯的不同聯絡人，且所有匯入的交易資料完全相同，HubSpot 將建立一個「Q4 Deal」並將其與這兩位聯絡人相關聯。若兩行資料中的交易屬性有所不同，HubSpot 將建立兩個獨立的交易。 

由於兩行中的交易資料完全相同，因此匯入操作會建立一個與這兩位聯絡人皆相關聯的交易。

若您要匯入相同

物件

的關聯關係，則有額外的要求。

透過兩個檔案匯入關聯關係

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

相同物件關聯

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

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

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

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

父/子關聯

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

自訂關聯標籤

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

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

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

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

範例檔案

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

後續步驟

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

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