Skip to main content
本指南解释了如何在 OneSignal 中设置用户的语言,并跨推送通知、电子邮件和应用内消息以用户首选语言发送消息。

设置用户语言

当使用网页或移动 SDK 首次创建用户时,OneSignal 会自动从设备的语言设置 language 属性。 您也可以使用 ISO 639-1 2 位字母语言代码通过以下方式手动设置或更新用户的语言:
  1. SDK 的 setLanguage 方法。
  2. 创建用户更新用户 API 中的 language 字段。
  3. CSV 导入器 中的 language 列。
参见 支持的语言 以获取有效语言代码列表。

发送不同语言的消息

使用下面的选项卡按消息渠道查看本地化选项。

仪表板发送

消息 > 推送 > 新消息模板 中,点击 添加语言。从以下选项中选择:

选项 1:复选框

选择您支持的语言。任何未选择的语言将回退到任意/英语。

使用复选框选择语言。

选项 2:导入语言内容

使用提供的模板为每种语言格式化消息。

从电子表格复制和粘贴数据的模态框。

将内容复制并粘贴回”添加语言”字段。

带有示例数据的模态框。

预览内容以双重检查,插入内容,编辑器中将出现填充了指定内容的新选项卡。

内容预览。

选项 3:动态内容

使用 动态内容,这涉及创建和上传包含您支持的语言的 CSV 文件。

故障排除

  • 需要英语:包含 en 行作为默认值。
  • 使用正确的标题language_codetitlesubtitlemessage
  • 逗号分隔值:确保正确的 CSV 格式。
  • 不支持的语言:如果未在 UI 或模板中列出,则不支持该语言。请使用最佳备选方案并联系 support@onesignal.com
仪表板编辑器使用标准 HTML 字段。特殊字符如 % 可能在 RTL 语言中引起显示问题。在这些字符后添加 RLM 标记 以修复格式问题。

API 发送

contentsheadings 字段支持多种语言:

支持的语言

语言代码映射到 ISO 639-1 代码 2 位字母格式的 language 用户属性。我们支持以下语言代码。
如果弹窗和 CSV 模板中未包含该语言代码,则不支持该语言。我们建议使用最佳备选语言并向 support@onesignal.com 发送产品请求