跳到内容

设置导入文件

上次更新时间: 二月 13, 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 的形式添加(28/10/2020 14:30) ,也可以在 CSV 文件或带有文本数字格式单元格的 Excel 文件中以毫秒的形式添加UNIX 时间戳。如果不包含时间戳,时间默认设置为午夜。

持续时间

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

枚举

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

文件

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

多个复选框

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

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

数值

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

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

单复选框

为单个复选框字段创建一列,并将每行的值设置为True 或Yes,以便在 HubSpot 中显示为 "是 "或 "选中";或FalseNo ,以便在 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 的经理,但却是 The Dragonfly Inn 的承包商。如果要将他与这两家公司关联起来,就需要在 Luke Danes 的两行中分别包含电子邮件(或记录 ID)和公司域名(或记录 ID)列。

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

如果要导入相同对象关联,还需要满足其他要求

导入两个文件中的关联

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

相同对象关联

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

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

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

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

父/子关联

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

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

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

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

文件示例

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

这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助