为多语言推送通知生成 CSV 文件

上传CSV文件以生成内容以进行投放是一项用于支持多语言推送通知的功能。 CSV文件的格式需要遵循特定准则才能成功上传文件，从而能够创建投放。 以下各节介绍文件格式及其注意事项。

文件格式

多语言推送在CSV文件中需要14列：

1. title
2. messagebody
3. 声音
4. adge
5. deeplinkURI
6. 类别
7. iOS媒体附件URL
8. androidMediaAttachmentURL
9. isContentAvailable
10. isMutableContent
11. customField
12. 区域设置
13. 语言
14. silentPush

通过单击 Download a sample file 在 Manage Content Variants 窗口。 有关更多信息，请参阅此 部分.

• title， messageBody，声音，徽章， deeplinkURI，类别， iosMediaAttachmentURL， androidMediaAttachmentURL：常规推送有效负荷内容。 您需要在创建推送投放时以类似的方式提供此信息。
• 自定义字段：对自定义字段使用JSON格式，例如 {"key1":"value1","key2":"value2"}. 有关自定义字段的示例，请参阅上面的示例文件。
• isContentAvailable：标记表示内容可用检查，值1表示真，值0表示假。 默认值为0。 如果将此列留空，则将该值视为0。
• isMutableContent：标记可变内容，值1表示true，值0表示false。 默认值为0。 如果将此列留空，则将该值视为0。
• 区域设置：区域设置是语言变体的字段，例如，“en_us”表示美国英语，“fr_fr”表示法语 — 法语。
• 语言：与区域设置关联的语言的名称。 例如，如果locale为“en_us”，则语言名称应为“English-United States”。
• silentPush：表示推送通知类型的标记。 如果是常规推送通知，则值应为0。 如果是静默推送，则值应为1。 默认值为0。 如果将此列留空，则将该值视为0。

创建csv文件的约束和准则

每列的名称都是固定的.
您应在CSV文件中包括每列的名称，如果不对内容使用任何列，则将其留空。

“locale”和“language”列是必填的，并且每行的值都是唯一的。
此列的空值将导致文件上传失败。

列的顺序很重要. 上传文件中列的顺序需要遵循与示例文件相同的格式。

引用列内容. 由于这是一个CSV（表示逗号分隔值）文件，因此必须引用包含逗号(，)的任何列内容。 例如，“你好，汤姆！”

国际字符需要UTF-8编码。

如果以纯文本生成文件，请用“，”分隔各列。

变量不匹配。 如果您使用内容块并以特定语言定位受众，则需要在CSV文件中列出每种目标语言，否则在发送投放时将收到错误。

在csv文件中插入个性化字段

如果要使用个性化字段，您应包括 标记之前。

要在messageBody中插入“firstName”个性化字段，消息需要是：

 "Hello <span class="nl-dce-field nl-dce-done"  data-nl-expr="/context/profile/firstName">First name</span>, this is message".

“firstName”字段由以下内容表示：

 <span class="nl-dce-field nl-dce-done" data-nl-expr="/context/profile/firstName">First name</span>

在范围中，有两个必需属性：

• 一个是静态类。 无论您计划使用哪个个性化字段，它都始终为class="nl-dce-field nl-dce-done"。

• 另一种是data-nl-expr，它是个性化字段的路径。 例如，如果您从UI插入“firstName”个性化字段，则导航路径将为 Context (context) > Profile (profile) > First name (firstName) （如下图所示）。 在这种情况下，路径将为

  /context/profile/firstName. data-nl-expr="/context/profile/firstName".
  

区域设置和语言名称

支持以下语言：