設定導入文件
上次更新時間: 二月 4, 2025
在将数据导入 HubSpot 之前,请查看以下限制和要求。您还可以访问示例文件或生成示例文件,以便开始使用。
要了解有关导入工具的更多信息,请参阅本文。如果文件已准备就绪,请学习如何导入。
技术要求和限制
所有导入 HubSpot 的文件必须- 是 .csv、.xlsx 或 .xls 文件。
- 只有一张工作表。
- 包含一个标题行,其中每一列标题对应 HubSpot 中的一个属性。列标题可以任意顺序排列,不会影响导入。你可以确认是否已经存在 与你的标题相匹配的默认属性 ,或者在导入前创建一个自定义属性。了解有关属性要求的更多信息。
- 包含少于 1000 列。
- 如果包含外语字符,则采用 UTF-8 编码。
- 如果导入的是 Excel 文件:
- 包含的数据不超过 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 默认的枚举属性(如生命周期阶段、行业),值必须与内部值或英文标签相匹配。 |
文件 |
|
多个复选框 |
要导入多个值,请在每个值之间添加一个分号,不要空格(值 1;值 2)。这些属性选项必须在导入前创建。 要添加或追加值,请在第一个值前添加分号(;值 3;值 4)。这将附加值,而不是覆盖现有属性值。 |
数量 |
根据创建的数字属性类型格式化数值:
|
单复选框 |
为单个复选框字段创建一列,并将每行的值设置为True或Yes,以便在 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 中创建关联标签。
- 要将公司关联设置为主要关联,请在该行的 "关联 "标签 列中加入 "主要 "值。
- 要设置多个标签来描述两条记录之间的关系,可以在一个单元格中包含多个关联标签值,并用分号隔开(例如,经理;账单联系人)。
- 如果在 多文件导入中导入关联标签,则需要在同一文件中包含关联 标签列和关联对象的唯一标识符。
- 如果导入的是配对标签:
- 对于跨对象关联,只需在关联标签列中包含其中一个标签。标签将在导入过程中分配给正确的对象。
- 对于同一对象关联, 关联[唯一标识符] 列中的记录将收到在导入过程中添加 或包含在文件标签列中的标签。行中的另一条记录将收到成对的另一个标签。
文件示例
在导入过程开始时,您可以为所选对象和活动生成一个包含所需属性的示例文件。如果您想查看更多包含其他属性的示例,请参阅本文的示例文件。