跳转到主要内容
本指南解释了如何在 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 字段支持多种语言:
  {
    "contents": {
      "en": "English content",
      "fr": "French content"
    },
    "headings": {
      "en": "English heading",
      "fr": "French heading"
    }
  }

支持的语言

语言代码映射到 ISO 639-1 代码 2 位字母格式的 language 用户属性。我们支持以下语言代码。
如果弹窗和 CSV 模板中未包含该语言代码,则不支持该语言。我们建议使用最佳备选语言并向 support@onesignal.com 发送产品请求
LanguageLanguage Code
Englishen
Arabicar
Azerbaijaniaz
Bosnianbs
Catalanca
Chinese (Simplified)zh-Hans
Chinese (Traditional)zh-Hant
Croatianhr
Czechcs
Danishda
Dutchnl
Estonianet
Finnishfi
Frenchfr
Georgianka
Bulgarianbg
Germande
Greekel
Hindihi
Hebrewhe
Hungarianhu
Indonesianid
Italianit
Japaneseja
Koreanko
Latvianlv
Lithuanianlt
Malayms
Norwegiannb
Persianfa
Polishpl
Portuguesept
Punjabipa
Romanianro
Russianru
Serbiansr
Slovaksk
Spanishes
Swedishsv
Thaith
Turkishtr
Ukrainianuk
Vietnamesevi

I