导入和导出翻译

您无需使用 AI Translate 生成翻译，而是可以从翻译服务商、电子表格或其他 Pushwoosh 预设中导入您自己的翻译。

打开 内容 → 推送预设，打开预设，然后在 推送预设编辑器 的语言选择器旁边使用 导入 或 导出。

• 导出： 将每种语言的当前标题、副标题和消息下载为 CSV 文件，以便在其他地方翻译或在另一个预设中重复使用。
• 导入： 上传 CSV 或 JSON 文件以将翻译应用于此预设。

注意

导入和导出仅涵盖标题、副标题和消息文本。它们不会移动图像、按钮、链接或其他预设设置。

导出当前内容

点击 导出，将预设中当前所有语言（包括默认语言）的标题、副标题和消息下载为 CSV 文件。下载的文件名类似于 welcome-series-translations.csv（预设名称的 slug 化形式，后跟 -translations.csv）。

文件内容如下：

language	title	subtitle	message
default	欢迎使用我们的应用！		感谢您的安装。
es	¡Bienvenido a nuestra app!		Gracias por instalar.
de	Willkommen in unserer App!		Danke fürs Installieren.

将翻译导入预设

准备文件

编辑从 导出 功能获取的 CSV 文件，或构建一个匹配相同布局的文件。导入功能也接受 .json 文件。

• language： 必需的标题列。每个代码的写法应与 语言选择器 中显示的方式相同，例如繁体中文为 zh-Hant。字母大小写不敏感（ES 和 es 均可）。如果导入预览列出了 Pushwoosh 无法识别的代码，请在文件中修复并重新导入。在该代码有效之前，该语言不会发送给任何人。
• title、subtitle 和 message： 可选。列可以按任意顺序排列。您省略的列将被视为每一行都为空白，与您保留的列中的空单元格相同。接下来的每一行代表一种语言。

注意

subtitle 仅在 iOS 上显示，与您在编辑器中 添加副标题 时相同。

使用 JSON 文件代替 CSV

如果您的供应商或团队已经发送了 .json 文件，导入功能也接受该文件。如果您使用从 导出 功能获取的 CSV 文件，则不需要 JSON。

• 与 CSV 相同的字段： title、subtitle 和 message，按语言代码分组：

  {
    "default": { "title": "Welcome to our app!", "message": "Thanks for installing." },
    "es": { "title": "¡Bienvenido a nuestra app!", "message": "Gracias por instalar." }
  }

• 与 Presets API 用于 localizedTitle、localizedSubtitle 和 localizedContent 的结构相同（这些字段对应 CSV 列的 title、subtitle 和 message）。如果您已经通过 API 导出预设，这将非常有用：

  {
    "localizedTitle": { "default": "Welcome to our app!", "es": "¡Bienvenido a nuestra app!" },
    "localizedContent": { "default": "Thanks for installing.", "es": "Gracias por instalar." }
  }

注意

要通过脚本一次性更新多个预设，请让您的开发团队使用 Presets API 的 UpdatePartial 调用。对于控制面板中的单个预设，请在此页面上使用 导入 功能。它接受相同的 localizedTitle、localizedSubtitle 和 localizedContent 映射。

导入文件

1. 点击语言选择器旁边的 导入。
2. 选择一个 .csv 或 .json 文件。预览将显示将应用多少种语言，其中有多少是此预设的新语言，以及有多少被跳过。
3. 仅当您希望文件替换现有翻译时，才勾选 覆盖已有文本的语言。若要填充空白语言并添加新语言而不更改您已编写的文本，请保持不勾选。

4. 点击 导入。

导入后，将语言选择器切换到文件中的一种语言，并确认标题和消息看起来正确。

注意

当一行中的任何内容都不会改变任何东西时，该语言将被跳过：

• 该行中的每个字段都为空，或
• 预设中该行要填充的每个字段都已有文本，并且 覆盖已有文本的语言 选项未开启。

文件中尚不存在于预设中的语言会自动添加。即使勾选了 覆盖，空单元格或字段也永远不会清除现有文本。它只会被跳过，而不会被写为空白。

如果 Pushwoosh 无法读取文件

您将看到以下消息之一，而不是预览：

消息	发生情况
文件为空。	文件没有内容。
文件不是有效的 JSON。	一个 .json 文件（或以 { 开头的文件）无法被解析为 JSON，或者其顶层不是一个对象。
CSV 文件没有 “language” 列。	CSV 文件的标题行缺少 language 列。
文件没有翻译。	每一行或每个 JSON 条目都缺少语言代码。