如何使用 CSV 批量导入术语表

您必须拥有付费 Klaviyo 帐户并启用智能翻译才能使用此功能。 # 导入现有的词汇表

Klaviyo 的智能翻译功能使用 词汇表 来控制特定术语的翻译方式 – 品牌名称、产品名称、口号或技术术语，需要在每个活动中进行一致的翻译。如果您已经在另一个翻译系统（DeepL、Lokalise、Phrase、内部电子表格）中维护术语表，您可以将其作为 CSV 直接导入 Klaviyo，而无需手动重新创建每个条目。

何时使用 CSV 导入

当您想要执行以下操作时，CSV 导入非常有用：

• 将现有词汇表从 DeepL、Lokalise、Phrase 或 memoQ 等 TMS（翻译管理系统）导入 Klaviyo。 – 一次添加一大批术语（数十或数百），而不是在用户界面中逐一输入。 – 将共享电子表格中维护的术语表迁移到 Klaviyo 中的单一事实来源。对于少数术语，在术语表面板中手动将它们逐一添加通常会更快。导入是单向的。您将术语上传到 Klaviyo，但目前没有 CSV 导出。如果需要备份，请保留源文件的副本。

准备您的 CSV 文件

文件格式

• 编码： UTF-8
• 文件类型： .csv
• 分隔符： 逗号 (,)
• 标题行： 必需（见下文）

示例文件

必填列

每行必须包含四列：

• 源术语 — 源语言中的术语
• 目标术语 — 该术语应该如何翻译
• source locale — 源语言的 BCP-47 区域设置标签
• target locale — 目标语言的 BCP-47 区域设置标签

所有四个标头必须出现在文件的第一行中。列顺序并不重要。

区域设置代码 (BCP-47)

区域设置代码遵循 BCP-47 标准。最常见的形式是两个字母的语言代码，可选地后跟一个区域：

• en — 英语
• en-US — 英语（美国）
• en-GB — 英语（英国）
• fr — 法语
• fr-CA — 法语（加拿大）
• de — 德语
• ja — 日语
• pt-BR — 葡萄牙语（巴西）

使用与您在 Klaviyo 中配置的区域设置相匹配的最具体的标记。

一个文件中的多个语言对

单个 CSV 可以包含许多语言对的条目。每行都是独立处理的，因此您可以自由混合对：

如果您维护一个支持多个语言环境翻译的主词汇表，这将非常有用。

术语表术语是对称的

每个术语表条目都定义了术语之间的双向等效项。如果您导入：

克拉维约将：

• 翻译英语 → 法语时，将“hello”翻译为“bonjour”。 – 翻译法语 → 英语时，将“bonjour”翻译为“hello”。这意味着你不能定义非对称映射，例如：

这两行都将“bonjour”映射到不同的英语术语，这是一个冲突。每个区域设置对术语组合仅允许一个映射。导入器将跳过冲突行并报告错误（请参阅导入错误疑难解答）。如果您需要根据上下文对“bonjour”进行不同的英语翻译，那么词汇表术语并不是正确的工具——它们适用于每次都以相同方式翻译的术语。

导入模式

导入时，选择以下两种模式之一：

• 添加 — 保留现有术语表条目。添加 CSV 中的新条目。与现有条目冲突的行将被跳过。 – 全部替换 — 您当前的整个词汇表将被删除并替换为 CSV 的内容。 全部替换 删除整个当前词汇表。仅当您确信 CSV 是新的事实来源时，才使用全部替换。无法撤消。

导入文件

1. 转到帐户→设置→翻译→词汇表。
2. 单击导入 CSV。

3. 在对话框中，选择添加 或全部替换。

4. 单击文件区域并选择“.csv”文件（或将文件拖动到该区域）。
5. 单击下一步。 Klaviyo 验证了文件，但不保存任何内容。您将看到预览屏幕。
6. 查看预览：

• 总行数 — 文件中有多少行。 – 有效条目 — 将导入多少条目。 – 跳过的行 — 由于验证问题而删除了多少行。

7. 如果出现任何警告，您仍然可以继续，或者先返回并修复文件。
8. 单击导入保存更改。

如果文件有问题，您将看到导入失败屏幕，而不是预览。

解决导入错误

当导入失败时，Klaviyo 会显示一条或多条错误消息，解释出现的问题。有些错误适用于整个文件；其他的则指向特定的行。

文件级错误

这些完全停止导入。修复它们并重试。 “上传的文件为空。”

含义： 该文件不包含任何内容。 要做什么： 确保文件不是 0 字节并且至少有一行加上标题。 “缺少必需的标头。”

含义： 标题行不包含所有四个必需列。 做什么： 检查第一行是否包含“源术语”、“目标术语”、“源语言环境”和“目标语言环境”。标头顺序并不重要；拼写确实如此。 “没有有效的术语表条目。”

含义： 验证后，无法导入任何行。 做什么： 打开文件并检查数据行是否符合预期格式。 “编码错误。”

含义： 文件不是 UTF-8 编码的

该怎么做： 使用 UTF-8 编码从电子表格工具重新保存文件。在 Excel 中，使用另存为 → CSV UTF-8。 “术语超出了最大长度。”

含义： 一个或多个术语太长。 该怎么做： 术语表术语应该是短语。缩短或分割很长的条目。

行级错误

这些标记特定行。文件的其余部分仍然可以导入 – 错误的行将被跳过。 “第 N 行：意外的列数”

含义： 该行的逗号分隔值太少或太多。 该怎么做： 检查 CSV 中的行 — 术语内的多余逗号需要用引号引起来（“你好，世界”）。 “N行：空项值”

含义： 源术语或目标术语单元格为空。 该怎么做： 填写缺少的术语，或删除该行。 “N 行：空区域设置代码”

含义： 源或目标区域设置单元格为空白。 该怎么做： 填写缺少的区域设置（例如“en”、“fr-CA”）。 “N 行：无法识别的区域设置代码”

含义： 区域设置字符串不是有效的 BCP-47 标记。 该怎么做： 使用标准区域设置代码，如“en”、“fr”、“de”、“pt-BR”。请参阅区域设置代码。 “N 行：检测到重复的区域设置列”

含义： 同一区域设置在单个条目上下文中出现多次。 该怎么做： 每行都需要不同的源和目标语言环境 – 您无法翻译“en → en”。 “N 行：同一术语和区域设置的翻译冲突”

含义： 该行尝试将相同的源术语映射到与文件中的另一行不同的目标。 该怎么做： 确定哪个翻译是正确的并删除重复的翻译。 “N 行：术语与现有条目冲突”

含义： 该行尝试定义与词汇表中已有术语相矛盾的翻译（仅限添加模式）。 要做什么： 更新 UI 中的现有条目，或者如果新文件正确，则使用全部替换模式。 “N 行：为了安全起见，删除了前导公式字符”

含义： 以“=”、“+”、“-”或“@”开头的术语，电子表格应用程序会将其解释为公式。 该怎么做： 这是警告，而不是失败。导入该术语时会删除前导字符。如果您需要该字符，请将术语用引号引起来。

一般验证错误

如果您看到“发生验证错误。请检查您的文件并重试。” 导入器遇到无法分类的问题。仔细检查文件是否符合预期格式，如果错误仍然存​​在，请联系支持人员。