多言語プッシュ通知用の CSV ファイルの生成

配信用のコンテンツを生成するためにCSVファイルをアップロードする機能は、多言語のプッシュ通知をサポートするために使用される機能です。 ファイルを正常にアップロードでき、配信を作成するには、CSVファイルの形式を特定のガイドラインに従う必要があります。 次の節では、ファイル形式とその考慮事項について説明します。

ファイルのフォーマット

多言語のプッシュには、CSVファイルに14列必要です。

1. タイトル
2. messageBody
3. 音
4. adge
5. deeplinkURI
6. category
7. iosMediaAttachmentURL
8. androidMediaAttachmentURL
9. isContentAvailable
10. isMutableContent
11. customFields
12. locale
13. language
14. silentPush

Manage Content Variants​ウィンドウの​Download a sample file​をクリックして、CSVサンプルを確認します。 詳しくは、を参照してください。

• title, messageBody, sound, badge, deeplinkURI,カテゴリ, iosMediaAttachmentURL, androidMediaAttachmentURL:通常のプッシュペイロードのコンテンツ。この情報は、プッシュ配信を作成する場合と同じ方法で提供する必要があります。
• カスタムフィールド:カスタムフィールドにはJSON形式を使用します。例： {"key1":"value1","key2":"value2"}.カスタムフィールドの例については、上記のサンプルファイルを参照してください。
• isContentAvailable:フラグが「使用可能なコンテンツ」チェックに設定されている場合、値1はtrueを意味し、値0はfalseを意味します。デフォルト値は0です。 この列を空白のままにすると、値は0と見なされます。
• isMutableContent:フラグに「可変コンテンツ」と表示する場合、値1はtrueを意味し、値0はfalseを意味します。デフォルト値は0です。 この列を空白のままにすると、値は0と見なされます。
• locale:localeは、言語バリアントのフィールドです(例：US-Englishの場合は「en_us」、フランス — フランスの場合は「fr_fr」です。
• language:ロケールに関連付けられている言語の名前。例えば、ロケールが「en_us」の場合、言語の名前は「English-United States」にする必要があります。
• silentPush:プッシュ通知タイプのフラグ。通常のプッシュ通知の場合、値は0にする必要があります。 サイレントプッシュの場合、値は1にする必要があります。 デフォルト値は0です。 この列を空白のままにすると、値は0と見なされます。

csvファイル作成の制約とガイドライン

各列の名前は固定されています。CSVファイルに各列の名前を含める必要があります。コンテンツに列を使用しない場合は、空白のままにします。

「locale」列と「language」列は必須で、値は各行で一意です。
この列に空白の値を指定すると、ファイルのアップロードに失敗します。

列の順序は重要です。アップロードされたファイル内の列の順序は、サンプルファイルと同じ形式に従う必要があります。

見積もり列の内容。これはCSV（コンマ区切り値）ファイルなので、コンマ(,)を含む列のコンテンツは引用符で囲む必要があります。 例えば、「Hello, Tom!」と入力します。

国際文字にはUTF-8エンコードが必要です。

プレーンテキストでファイルを生成する場合は、各列を「,」で区切ります。

バリアントの不一致 特定の言語のコンテンツブロックおよびターゲットオーディエンスを使用する場合は、CSVファイルでターゲット言語をすべてリストする必要があります。すべての言語をしないと、配信を送信する際にエラーが発生します。

CSVファイルにパーソナライゼーションフィールドを挿入

パーソナライゼーションフィールドを使用する場合は、ファイルにタグを含める必要があります。

「firstName」パーソナライゼーションフィールドをmessageBodyに挿入するには、次のメッセージが必要です。

 "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>

スパンには、2つの必須属性があります。

• 1つは静的なクラスです。 どのパーソナライゼーションフィールドを使用する場合でも、常にclass="nl-dce-field nl-dce-done"になります。

• もう1つはdata-nl-exprで、これはパーソナライゼーションフィールドのパスです。 例えば、UIから「firstName」パーソナライゼーションフィールドを挿入した場合、ナビゲーションパスは​Context (context) > Profile (profile) > First name (firstName)​になります（下の画像を参照）。 この場合、パスは

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

ロケールと言語名

次の言語がサポートされています。