跳到內容
請注意::這篇文章的翻譯只是為了方便而提供。譯文透過翻譯軟體自動建立,可能沒有經過校對。因此,這篇文章的英文版本應該是包含最新資訊的管理版本。你可以在這裡存取這些內容。

設定導入文件

上次更新時間: 二月 4, 2025

可与下列任何一种订阅一起使用,除非有说明:

所有產品和版本

在将数据导入 HubSpot 之前,请查看以下限制和要求。您还可以访问示例文件生成示例文件,以便开始使用。

要了解有关导入工具的更多信息,请参阅本文。如果文件已准备就绪,请学习如何导入

技术要求和限制

所有导入 HubSpot 的文件必须
  • 是 .csv、.xlsx 或 .xls 文件。
  • 只有一张工作表。
  • 包含一个标题行,其中每一列标题对应 HubSpot 中的一个属性。列标题可以任意顺序排列,不会影响导入。你可以确认是否已经存在 与你的标题相匹配的默认属性 ,或者在导入前创建一个自定义属性。了解有关属性要求的更多信息。

  • 包含少于 1000 列。
  • 如果包含外语字符,则采用 UTF-8 编码。
  • 如果导入的是 Excel 文件:

根据您的 HubSpot 订阅情况,导入工具还有其他技术限制。这些限制包括导入文件的大小和行数限制,以及每天可导入的文件和行数。

  • 如果您使用的是 HubSpot 的免费工具,就可以这样做:
    • 导入最大 20MB 的文件。
    • 每天最多完成 50 次导入。
    • 每天最多导入 500,000 行。如果导入的文件超过 500,000 行,则需要多天才能完成。
  • 如果您的账户已订购入门版专业版企业版,您可以
    • 导入最大 512 MB 的文件。
    • 每天最多完成 500 次导入。
    • 每天最多导入 10,000,000 行,每个文件最多导入 1,048,576 行。如果通过导入 API 进行导入,每天最多可导入 80,000,000 行。

这些限制适用于滚动的 24 小时,不会在一天中的特定时间重置。了解有关HubSpot 订阅及其限制的更多信息

格式化数值

对于导入文件的每一行,您都可以为属性列添加值。值的格式取决于属性字段类型和导入目标。

根据属性字段类型格式化数值

根据属性字段类型的不同,有特定的格式要求:

领域类型 要求

日期选择器

日期和时间选择器

月份可以是数字、三个字母或全称(10、OCT、Oct、OCTOBER、10 月),年份可以是两位数或四位数(2023、23),分隔符可以是斜线、连字符或句号(10/28/2023、10-28-2023、10.28.2023)。

有效的日期格式有年月日(如 28/10/2023)、年月日(如 10-28-23)或年月日(如 2023.OCT.28)。

如果设置了验证规则,则导入值必须遵守规则,否则将无法导入。

日期和时间选择器

时间戳可以在所有文件类型中以 hh:mm 的形式添加(2020 年 10 月 28 日 14:30,也可以在 CSV 文件或带有文本数字格式单元格的 Excel 文件中以毫秒的形式添加UNIX 时间戳。如果不包含时间戳,时间默认设置为午夜。

持续时间

对于包含持续时间的属性(如调用持续时间属性),其值必须格式化为以毫秒为单位的 UNIX 时间戳。进一步了解如何格式化时间戳值以及如何将日期转换为UNIX 格式。

枚举

导入文件中的值必须与属性定义选项的标签或内部值相匹配。对于 HubSpot 默认的枚举属性(如生命周期阶段行业),值必须与内部值或英文标签相匹配。

文件

要在文件属性中添加现有文件,请将文件 ID作为值。您可以在文件详细信息常规部分找到文件 ID。

多个复选框

要导入多个值,请在每个值之间添加一个分号,不要空格(值 1;值 2)。这些属性选项必须在导入前创建。

要添加或追加值,请在第一个值前添加分号(;值 3;值 4)。这将附加值,而不是覆盖现有属性值。

数量

根据创建的数字属性类型格式化数值:

  • 货币:对于包含货币数量或价格的属性,必须使用 HubSpot 接受的货币之一。可接受货币列表及其货币代码可在账户默认设置的"货币"选项卡中找到。对于美元,货币数据应使用小数格式(如 123.45)
  • 百分比:使用 %百分号或小数来格式化数值。例如,要导入 25%,您的单元格应包含25%.25
  • 电话号码:联系人属性中的电话号码手机号码,要根据国家代码导入并自动格式化电话号码,格式为 +[国家代码][号码]。如果有扩展名,请添加 ext[号码]。例如,带有美国国家代码的电话号码格式为 +11234567890 ext123。
如果设置了验证规则,则导入值必须遵守规则,否则将无法导入。

单复选框

为单个复选框字段创建一列,并将每行的值设置为TrueYes,以便在 HubSpot 中显示"是 "或 "选中";或者设置 False No ,以便在 HubSpot 中显示为 "否 "或 " 未选中"。

术语属性

细列项目属性术语 应以 PnYnMnD 或 PnW 的ISO-8601 期间格式添加。例如,年度术语为 P12M 或 P24M。如果留空,将设置默认期限。

文本

如果设置了 验证规则,则导入的值必须遵守规则,否则将无法导入。

用户(所有者)

在导入过程中为记录或活动指定所有者:
  • 对于对象,包含[对象]所有者标题。对于活动,包含分配给活动的标题。
  • 在该列的每一行中添加用户名、电子邮件地址或所有者属性的内部值。如果账户中有多个同名用户,建议使用电子邮件地址或所有者属性的内部值。
通过导入被指定为所有者的用户将不会收到他们被指定新记录/活动的通知。

其他联系电子邮件或公司域名

如果导入的联系人有多个电子邮件地址,请在 "附加电子邮件地址 "栏中添加其二级电子邮件地址。如果导入的公司有多个域名,则应在 "附加域名 "列中 包含其二级域名。要在一个单元格中包含多个电子邮件或域名,请使用分号分隔数值(例如,email@email.com; emailtwo@email.com)

如果您正在导入以创建联系人或公司,则不能将新联系人的电子邮件或新公司的公司域名 设置为另一记录的现有附加电子邮件或域名。

空白单元格

导入工具会忽略电子表格中的空白单元格,因此在导入新的属性数据时,请将没有属性值的记录留空。如果现有记录在 HubSpot 中已有属性值,空白单元格将 不清除现有属性值。要批量清除现有属性值,可以 手动编辑数值 或使用 清除属性值工作流程操作 .

交易合作者

如果您通过导入将合作者添加到交易中,请包含一个 交易合作者标题。每个单元格必须包含两个或多个用户,以分号隔开(如 user1@example.com;user2@example.com)。

产品期限和计费频率

如果导入的是 "期限"属性值,可以将 "期限"列中的值格式化为以月为单位的数字(如10表示 10 个月)、X 表示月数的PXM 格式(如P6M 表示期限为 6 个月)或 X 表示年数的PXY格式(如P1Y 表示期限为 1 年)。

如果导入的是计费频率属性值,如果产品属于经常性价格类型,请使用月度年度季度。如果产品是一次性价格,则单元格留空。

所需属性

根据您导入的对象或活动,以下属性是创建记录所必需的,并且必须作为列标题包含在文件中。如果要更新记录,必须包含唯一标识符(如记录 ID、电子邮件、公司域名)。

虽然不是必需的,但您可以为每个对象导入其他属性,包括自定义和默认属性。请参考联系人公司交易票据通话电子邮件会议备注任务的默认属性。您还可以在属性设置中查看所有属性及其值。

  • 联系人: 名字姓氏 或电子邮件中的至少一个
  • 公司: 名称公司域名中的至少一项
  • 交易:如果您要创建新交易,请输入交易名称、管道交易阶段
  • 票单: 如果要创建新票单,请输入票单名称、管道票单状态
  • 预约约会开始。预约开始时间应格式化为日期-时间属性
  • 课程课程名称
  • 列表名称
  • 服务名称管道管道阶段
  • 产品: 如果要创建产品, 单价 名称
  • 订单名称管道管道阶段
  • 行项目名称数量价格 以及相关交易的记录 ID 交易名称。如果还将产品关联到产品,请包含产品的 产品 ID,产品 ID 将在导入时映射为产品属性。

请注意:导入带有交易的细列项目时,导入不会更新交易金额。要更新关联的交易金额,可以手动编辑细列项目或在 HubSpot 中将细列项目与交易关联起来。


  • 通话: 通话备注。导入新通话时,还建议包含活动日期
  • 电子邮件 电子邮件正文 电子邮件方向
  • 会议会议描述会议开始时间和会议结束时间。导入新会议时,还建议包含活动日期。开始时间、结束时间和活动日期值的格式应为日期时间属性
  • 备注备注正文
  • 任务任务标题到期日期。 应将到期日期格式化为日期-时间属性

请注意:虽然不是必填项,但建议在导入新活动时包含活动日期,以指定活动发生的日期和时间。如果不包含此属性,活动日期值将自动设置为导入的日期和时间。


更新现有记录或避免重复的要求

要更新现有记录并避免重复记录,文件必须包含每个对象的唯一标识符属性。对于所有对象,您可以 导出现有记录 并使用 记录 ID作为唯一标识符,或使用需要唯一值的自定义属性 对于联系人,也可以使用电子邮件。对于公司,也可以使用公司域名

如果要导入多个对象并包含 "记录 ID",建议区分文件列标题,以便将 ID 与正确的对象相匹配(例如,一列称为 "记录 ID - 联系人",另一列称为 "记录 ID - 公司")。

请注意: 如果文件中包含电子邮件公司域名 ,则会出现以下行为:

  • 如果使用自定义唯一值属性重复联系人,则电子邮件属性仍需要唯一值。
  • 如果使用自定义唯一值属性重复导入公司,则公司域名属性需要唯一值。这意味着你可以导入重复的公司域名。如果不希望多个公司使用相同的域名,应在导入前删除文件中的重复域名,或使用公司域名作为唯一标识符。
  • 对于在 HubSpot 中列出了辅助电子邮件地址的现有联系人,可以使用辅助电子邮件作为唯一标识符。如果使用辅助电子邮件,但不 在文件中包含记录 ID列,辅助电子邮件将不会取代主电子邮件。但是,如果在文件中同时包含辅助电子邮件和记录 ID 列,辅助电子邮件就会取代主电子邮件。

关联记录的要求

在一个文件中导入关联

在一个文件中,每行可关联两个或多个记录。在同一行中包含关联记录和/或活动的信息,并为每个对象包含唯一标识符。要将一条记录与另一个对象的多个活动或记录关联起来,请在要关联的每条记录的多行中包含记录的唯一标识符。

例如,Luke Danes 是 Luke's Diner 的经理,但却是 Dragonfly Inn 的承包商。要将他与这两家公司关联起来,需要在 Luke Danes 的两行中分别包含电子邮件(或记录 ID)和公司域名(或记录 ID)列。

请注意: 如果不包含唯一标识符(如电子邮件公司域名记录ID,导入将创建重复记录,而不是将每条记录关联到同一条记录。

如果要导入相同的对象关联,还有其他要求

导入两个文件中的关联

要关联两个文件中两个对象的记录,可使用一个公共列来连接每个文件中的记录。有关导入和关联记录的更多帮助,请参阅示例文件。

相同对象关联

您可以导入一个文件,批量关联同一对象的记录。在导入过程中,您需要选择一个复选框来包含相同对象的关联

设置文件时,请在同一行中包含相关记录的信息,并为每条记录包含一个唯一标识符。以下是针对同一对象导入的附加要求:

  • 导入前,记录对中必须至少有一条记录已经存在于 HubSpot 中。例如,您可以导入一个新联系人并将其与现有联系人关联,但不能导入创建两个新联系人并将其关联。
  • 关联现有联系人/公司时,只能使用 电子邮件/公司域名作为唯一标识符。支持次要电子邮件或域。
  • 如果要将多条记录与一条记录关联起来,请在同一单元格中用分号分隔记录的唯一标识符值(例如,luke@lukesdiner.com; rory@yale.edu; sookie@dragonfly.com)

在下面的示例文件中,Rory 和 Jackson 是新联系人,他们的电子邮件值作为唯一标识符,与现有联系人的唯一标签相关联。Sookie 是一个现有联系人,被关联到两个具有相同标签的现有联系人。在第一行中,关联标签是标签配对的一部分,这意味着一旦导入完成,关联记录将带有 "父母 "标签,而 Rory 将带有配对标签 "子女"。

亲子协会

要通过导入创建子母公司关联,请了解有关导入子母公司的更多信息

自定义关联标签仅限专业版企业版)

导入关联标签,请加入 关联标签。导入前必须在 HubSpot 中创建关联标签

  • 要将公司关联设置为主要关联,请在该行的 "关联 "标签 列中加入 "主要 "值。
  • 要设置多个标签来描述两条记录之间的关系,可以在一个单元格中包含多个关联标签值,并用分号隔开(例如,经理;账单联系人)。
  • 如果在 多文件导入中导入关联标签,则需要在同一文件中包含关联 标签和关联对象的唯一标识符。
  • 如果导入的是配对标签
    • 对于跨对象关联,只需在关联标签列中包含其中一个标签。标签将在导入过程中分配给正确的对象。
    • 对于同一对象关联, 关联[唯一标识符] 列中的记录将收到在导入过程中添加 或包含在文件标签列中的标签。行中的另一条记录将收到成对的另一个标签。

文件示例

在导入过程开始时,您可以为所选对象和活动生成一个包含所需属性的示例文件。如果您想查看更多包含其他属性的示例,请参阅本文的示例文件

這篇文章有幫助嗎?
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助