多言語プッシュ通知用の CSV ファイルの生成 generating-csv-multilingual-push
配信用のコンテンツを生成するための CSV ファイルのアップロードは、多言語プッシュ通知のサポートに使用される機能です。 CSV ファイルの形式では、ファイルのアップロードが成功し、その結果、配信を作成できるように、一定のガイドラインに従う必要があります。 次のセクションでは、ファイル形式とその考慮事項について説明します。
ファイル形式 file-format
多言語プッシュには、CSV ファイルの 14 列が必要です。
- タイトル
- messageBody
- サウンド
- adge
- deeplinkURI
- カテゴリー
- iosMediaAttachmentURL
- androidMediaAttachmentURL
- isContentAvailable
- isMutableContent
- customFields
- locale
- language
- silentPush
Manage Content Variants ウィンドウで Download a sample file をクリックして、CSV サンプルを確認します。 詳しくは、この 節を参照してください。
- title、messageBody、sound、badge、deeplinkURI、category、iosMediaAttachmentURL、androidMediaAttachmentURL：通常のプッシュペイロードコンテンツ。 この情報は、プッシュ配信を作成する場合と同様の方法で提供する必要があります。
- カスタムフィールド：カスタムフィールドには JSON 形式を使用します（例：
{"key1":"value1","key2":"value2"}）。 カスタムフィールドの例については、上記のサンプルファイルを参照してください。 - isContentAvailable：コンテンツ利用可能チェックのフラグ。値 1 は true、値 0 は false を意味します。 デフォルト値は 0 です。 この列を空白のままにすると、値は 0 と見なされます。
- isMutableContent：可変コンテンツのフラグ。値 1 は true、値 0 は false を意味します。 デフォルト値は 0 です。 この列を空白のままにすると、値は 0 と見なされます。
- locale：ロケールは言語のバリアントのフィールドです。例えば、米国 – 英語の場合は「en_us」、フランス – フランス語の場合は「fr_fr」です。
- language: ロケールに関連付けられている言語の名前。 例えば、ロケールが「en_us」の場合、言語の名前は「英語 – 米国」にする必要があります。
- silentPush：プッシュ通知タイプのフラグ。 通常のプッシュ通知の場合、値は 0 になります。 サイレントプッシュの場合、値は 1 にする必要があります。 デフォルト値は 0 です。 この列を空白のままにすると、値は 0 と見なされます。
CSV ファイルの作成に関する制約とガイドライン constraints-guideline-csv
各列の名前は固定されています。
コンテンツに列を使用しない場合は、CSV ファイルの各列の名前を空白のままにします。
locale」列と「language」列は必須で、値は各行で一意です。
この列に空の値を指定すると、ファイルのアップロードに失敗します。
列の順序が重要。 アップロードするファイルの列の順序は、サンプルファイルと同じ形式に従う必要があります。
列の内容を引用. これは CSV （Comma-Separated Values の略）ファイルなので、コンマ（,）を含むすべての列コンテンツを引用する必要があります。 例えば、「こんにちは、トム！」と入力します。
国際文字の場合は UTF-8 エンコーディングが必要です。
プレーンテキストでファイルを生成する場合は、各列を「,」で区切ります。
バリアントが一致しません。 コンテンツブロックとターゲットオーディエンスを特定の言語で使用する場合は、CSV ファイルのすべてのターゲット言語をリストする必要があります。リストしない場合、配信の送信時にエラーが発生します。
パーソナライゼーションフィールドの CSV ファイルへの挿入 personalization-field-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>
スパンには、次の 2 つの必須属性があります。
-
一つは静的なクラスです。 どのパーソナライゼーションフィールドを使用する予定であっても、常に class="nl-dce-field nl-dce-done"になります。
-
もう 1 つは、data-nl-expr で、これはパーソナライゼーションフィールドのパスです。 例えば、「firstName」パーソナライゼーションフィールドを UI から挿入する場合、ナビゲーションパスは Context (context)/Profile (profile)/First name (firstName) になります（下図を参照）。 この場合、パスは次のようになります
code language-none /context/profile/firstName. data-nl-expr="/context/profile/firstName".
ロケールと言語名 locale-language-names
次の言語がサポートされています。