設定導入文件
上次更新時間: 十二月 3, 2024
在將資料匯入 HubSpot 之前,請先查看以下限制和要求。您也可以存取範例文件或產生範例文件來幫助您入門。
要了解有關導入工具的更多信息,請參閱本文。如果您的文件已準備好,請了解如何匯入.
技術要求和限制
導入 HubSpot 的所有檔案必須:- 是 .csv、.xlsx 或 .xls 檔案。
- 只有一張。
- 包括一個標題行,其中每個列標題對應於 HubSpot 中的一個屬性。列標題可以按任何順序組織,而不影響匯入。您可以在匯入之前確認是否已存在與您的標頭相符的預設屬性或建立自訂屬性。了解有關財產要求的更多資訊。
- 包含少於 1000 列。
- 如果包含外語字符,則採用 UTF-8 編碼。
- 如果您要匯入 Excel 檔案:
- 包含低於 Excel 工作表和工作簿最大限制的資料。
- 匯入日期和時間選擇器屬性時包含數字格式的儲存格。
根據您的 HubSpot 訂閱,導入工具還有其他技術限制。這些限制包括匯入檔案的大小和行限制,以及每天可以匯入的檔案數和行數。
- 如果您使用 HubSpot 的免費工具,可以:
- 導入最大 20MB 的檔案。
- 每天最多完成 50 次導入。
- 每天最多導入 500,000 行。如果匯入包含超過 500,000 行的文件,則需要幾天才能完成。
- 如果您的帳號有Starter 、 Professional或Enterprise訂閱,您可以:
- 導入最大 512 MB 的檔案。
- 每天最多完成 500 個導入。
- 每天最多導入 10,000,000 行,每個檔案最多導入 1,048,576 行。如果您透過匯入 API匯入,則每天最多可以匯入 80,000,000 行。
這些限制適用於24 小時滾動週期,並且不會在一天中的特定時間重置。詳細了解您的HubSpot 訂閱及其限制。
設定值的格式
對於匯入檔案的每一行,您可以新增屬性列的值。值的格式取決於屬性欄位類型和匯入目標。
根據屬性欄位類型格式化值
根據屬性欄位類型,有特定的格式要求:
字段類型 | 要求 |
日期選擇器 日期和時間選擇器 | 月份可以是數字、三個字母或全名(10、OCT、Oct、OCTOBER、October),年份可以是兩位數或四位數字(2023, 23),分隔符可以是正斜線、連字符或句點(2023 年10 月28 日、2023 年10 月28 日、2023 年10 月28 日)。 有效日期格式為日月年(例如,28/10/2023)、月日年(例如,10-28-23)或年月日(例如,2023.OCT.28)。 如果您設定了驗證規則,則匯入的值必須遵循規則,否則將不會被匯入。 |
日期和時間選擇器 | 時間戳記可以在所有文件類型中新增為 hh:mm (28/10/2020 14:30 ) ,也可以在 CSV 檔案或儲存格為文字數位格式的 Excel 檔案中新增為以毫秒為單位的 UNIX 時間戳。如果不包含時間戳,則時間預設為午夜。 |
期間 | 對於包含持續時間的屬性(例如「呼叫持續時間」屬性),您的值必須採用以毫秒為單位的 UNIX 時間戳格式。了解有關如何設定時間戳記值格式以及如何將日期轉換為UNIX 格式的詳細資訊。 |
列舉 | 匯入檔案中的值必須與屬性定義的 options的標籤或內部值相符。 對於 HubSpot 預設枚舉屬性(例如, Lifecycle stage 、 Industry ),值必須與內部值或英文標籤相符。 |
文件 | |
多個複選框 | 若要匯入多個值,請在每個值之間新增分號(不含空格)(值 1;值 2)。這些屬性選項必須在匯入之前建立。 若要新增或追加值,請在第一個值前面加上分號 (;值 3;值 4)。這將附加該值而不是覆蓋現有的屬性值。 |
數位 | 根據建立的數字屬性的類型設定值的格式:
|
單一複選框 | 為單一複選框欄位建立一列,並將每行的值設為True或Yes以在 HubSpot 中顯示為 Yes 或選取或False 或者 否在 HubSpot 中顯示為否或未選取。 |
文字 | 如果您設定了驗證規則,則匯入的值必須遵循規則,否則將不會被匯入。 |
用戶(所有者) | 若要在匯入期間將所有者指派給記錄或活動:
|
其他聯絡電子郵件或公司網域
如果您要匯入具有多個電子郵件地址的聯絡人,請在其輔助電子郵件地址中新增「其他電子郵件地址」欄位。如果您要匯入具有多個網域的公司,請在其輔助網域中新增「其他網域」列。要在儲存格中包含多個電子郵件或網域,請用分號分隔這些值(例如email@email.com ; emailtwo@email.com )。
如果您要進行匯入以建立聯絡人或公司,則無法將新聯絡人的電子郵件或新公司的公司網域設定為作為另一筆記錄的現有附加電子郵件/網域的電子郵件或網域。
空白單元格
匯入工具會忽略電子表格中的空白儲存格,因此在匯入新屬性資料時,請將沒有屬性值的記錄的儲存格留空。如果現有記錄已具有 HubSpot 中的屬性值,則空白儲存格將 不清楚現有房產的價值。若要批量清除現有屬性值,您可以 手動編輯數值 或使用 清除屬性值工作流程操作 .交易合作者
如果您透過匯入將協作者新增至交易中,請包含 交易合作者 標頭。對於每個儲存格,您必須包含兩個或多個用戶,並以分號分隔(例如,user1@example.com;user2@example.com)。產品期限和計費頻率
如果匯入Term屬性值,您可以將Term欄位中的值格式化為以月為單位的數字(例如, 10表示 10 個月),例如PXM ,其中 X 是月數(例如, P6M表示期限為6 個月) ) 或PXY ,其中 X 是年數(例如, P1Y ,期限為 1 年)。
如果匯入「計費頻率」屬性值,請使用「每月」 、 「每年」或「每季」 (如果產品具有經常性價格類型)。如果產品有一次性價格,請將儲存格留空。
所需屬性
根據您要匯入的物件或活動,建立記錄需要以下屬性,並且必須將其作為列標題包含在文件中。如果您要更新記錄,則必須包含唯一識別碼(例如,記錄 ID、電子郵件、公司網域名稱)。
雖然不是必需的,但您可以為每個物件匯入其他屬性,包括自訂屬性和預設屬性。請參閱聯絡人、公司、交易、票證、 通話、 電子郵件、 會議、 註釋和任務的預設屬性。您也可以在屬性設定中查看所有屬性及其值。
- 聯絡人:名字、姓氏或電子郵件中的至少一個。
- 公司:名稱或公司網域中的至少一項。
- 交易:如果您要建立新交易,則交易名稱、管道和交易階段。
- 票證:如果您要建立新票證,則顯示票證名稱、管道和票證狀態。
- 預約:預約開始。約會開始時間的格式應為date-time property 。
- 課程:課程名稱。
- 列表:名稱。
- 服務:名稱、管道和管道階段。
- 產品:如果你正在創造產品, 單價和名稱。
- 行項目:名稱、數量、價格以及關聯交易的記錄 ID或交易名稱。如果您也將訂單項目與產品關聯,請包含產品的產品 ID ,該產品將在匯入過程中對應為訂單項目屬性。
請注意:匯入包含交易的訂單項目時,匯入將不是更新交易金額。若要更新關聯的交易金額,您可以手動編輯訂單項目或將訂單項目與 HubSpot 中的交易關聯。
- 通話記錄:通話記錄。匯入新通話時,也建議包含Activity date 。
- 電子郵件:電子郵件正文和電子郵件方向。
- 會議:會議說明、會議開始時間和會議結束時間。匯入新會議時,也建議包含Activity date 。開始時間、結束時間和活動日期值的格式應為日期時間屬性。
- 註:註釋體。
- 任務:任務標題和截止日期。截止日期應格式化為日期時間屬性。
請注意:雖然不是必需的,但建議在匯入新活動時包含活動日期以指定活動發生的日期和時間。如果不包含此屬性,活動日期值將自動設定為匯入的日期和時間。
更新現有記錄或避免重複的要求
若要更新現有記錄並避免重複記錄,您的文件必須包含每個物件的唯一識別屬性。對於所有對象,您可以匯出現有記錄並使用記錄ID作為唯一標識符,或使用需要唯一值的自訂屬性。 對於聯絡人,您也可以使用電子郵件。對於公司,您也可以使用公司網域。
如果您要匯入多個物件並包含記錄ID,建議區分文件列標題,以便將ID 與正確的物件相符(例如,一列稱為“記錄ID - 聯絡人”,另一列稱為“記錄ID - 公司”)。
請注意:如果您的文件中包含電子郵件或公司域名,則以下行為適用:
- 如果您使用自訂唯一值屬性來刪除重複的聯絡人,則電子郵件屬性仍需要唯一值。
- 如果您使用自訂唯一值屬性來刪除重複的公司,則公司網域名稱屬性將不需要唯一值。這意味著您可以匯入重複的公司網域。如果您不希望多個公司具有相同的網域,則應在匯入之前從檔案中刪除重複的網域,或使用公司網域作為唯一識別碼。
- 您可以使用輔助電子郵件地址作為具有 HubSpot 中列出的輔助電子郵件地址的現有聯絡人的唯一識別碼。如果您使用輔助電子郵件地址,且文件中未包含「記錄ID」列,則輔助電子郵件地址將不會取代主電子郵件地址。但是,如果您在文件中同時包含輔助電子郵件地址和記錄 ID 作為列,則輔助電子郵件地址將取代主電子郵件地址。
關聯記錄的要求
在一個檔案中導入關聯
在一個檔案中,您可以將每一行關聯兩個或多個記錄。在同一行中包含有關關聯記錄和/或活動的信息,並包含每個物件的唯一識別碼。若要將一筆記錄與另一個物件的多個活動或記錄關聯,請在要關聯的每筆記錄的多行中包含該記錄的唯一識別碼。
例如,Luke Danes 是 Luke's Diner 的經理,同時也是 The Dragonfly Inn 的承包商。要將他與兩家公司關聯起來,您需要為 Luke Danes 新增兩行,其中包含每家公司的電子郵件(或記錄 ID )列和公司網域(或記錄 ID )。
請注意:如果您不包含唯一識別碼(例如,電子郵件、公司網域、記錄ID ) ,匯入將建立重複記錄,而不是將每個記錄關聯到相同記錄。
如果您要匯入相同的物件關聯,則還有其他要求。
在兩個文件中導入關聯
若要關聯兩個檔案中兩個物件的記錄,請使用公共列來連接每個檔案中的記錄。您可以參考範例文件以獲得有關導入和關聯記錄的更多協助。
相同物件關聯
您可以匯入一個檔案來批次關聯同一物件的記錄。在匯入過程中,您需要選取一個複選框以包含相同的物件關聯。
設定檔案時,請在同一行中包含有關關聯記錄的信息,並包含每筆記錄的唯一識別碼。以下附加要求特定於相同物件導入:
- 導入前,記錄對中至少有一筆記錄必須已存在於 HubSpot 中。例如,您可以匯入新聯絡人並將其與現有聯絡人關聯,但無法匯入以建立並關聯兩個新聯絡人。
- 關聯現有聯絡人/公司時,您只能使用主電子郵件/公司網域作為您的唯一識別碼。不支援輔助電子郵件或網域。
- 如果您將多個記錄與一筆記錄關聯,請在同一儲存格中以分號分隔記錄的唯一識別碼值(例如, luke@lukesdiner.com ; rory@yale.edu ; soookie@dragonfly.com )。
在下面的範例文件中,Rory 和 Jackson 是新聯絡人,使用其電子郵件值作為唯一標識符,與現有聯絡人的唯一標籤相關聯。 Sookie 是與兩個具有相同標籤的現有聯絡人關聯的現有聯絡人。在第一行中,關聯標籤是標籤對的一部分,這表示一旦匯入完成,關聯記錄將具有標籤Parent ,而Rory 將具有配對標籤Child 。
家長/兒童協會
若要透過導入建立子母公司關聯,請了解有關導入子公司的更多資訊。
自訂關聯標籤(僅限專業版和企業版)
若要匯入關聯標籤,請包含關聯標籤列。您必須在匯入之前在 HubSpot 中建立關聯標籤。
- 若要將公司關聯設為主要關聯,請在該行的「關聯標籤」欄位中包含「主要」值。
- 若要設定多個標籤來描述兩筆記錄之間的關係,您可以在一個儲存格中包含多個關聯標籤值,並以分號分隔(例如,經理;帳單聯絡人)。
- 如果您要在多重文件匯入中匯入關聯標籤,則需要在同一文件中包含關聯標籤列和要關聯的物件的唯一識別碼。
- 如果您要匯入配對標籤:
- 對於跨物件關聯,僅在「關聯標籤」欄位中包含標籤之一。在匯入過程中,標籤將分配給正確的物件。
- 對於相同的物件關聯,記錄在 關聯的[唯一識別碼]列將接收在匯入過程中新增或包含在文件的標籤列中的標籤。該行中的另一個記錄將接收該對中的另一個標籤。
範例文件
在匯入過程開始時,您可以產生一個範例文件,其中包含所選物件和活動所需的屬性。如果您想查看更多具有附加屬性的範例,請參閱本文中的範例文件。