多言語プッシュ通知用の CSV ファイルの生成 generating-csv-multilingual-push
配信用のコンテンツを生成するための CSV ファイルのアップロードは、多言語のプッシュ通知をサポートするために使用される機能です。 CSV ファイルの形式は、ファイルのアップロードが正常に完了し、結果として配信を作成できるように、特定のガイドラインに従う必要があります。 次の節では、ファイル形式とその考慮事項について説明します。
ファイル形式 file-format
多言語プッシュには CSV ファイルで 14 列が必要です。
- タイトル
- messageBody
- 音
- adge
- deeplinkURI
- カテゴリー
- iosMediaAttachmentURL
- androidMediaAttachmentURL
- isContentAvailable
- isMutableContent
- customFields
- locale
- language
- silentPush
CSV サンプルを確認するには、 Download a sample file (内) Manage Content Variants ウィンドウ 詳しくは、 セクション.
- 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 は言語のバリアントのフィールドです。例えば、US-English の場合は「en_us」、フランス — フランス語の場合は「fr_fr」です。
- 言語:ロケールに関連付けられている言語の名前。 例えば、ロケールが「en_us」の場合、言語の名前は「English-United States」にする必要があります。
- silentPush:プッシュ通知タイプ用のフラグ。 通常のプッシュ通知の場合、値は 0 にする必要があります。 サイレントプッシュの場合、値は 1 にする必要があります。 デフォルト値は 0 です。 この列を空白にした場合、値は 0 と見なされます。
csv ファイル作成の制約とガイドライン constraints-guideline-csv
各列の名前は固定されています.
CSV ファイルに各列の名前を含める必要があります。コンテンツに列を使用しない場合は、空白のままにします。
「locale」列と「language」列は必須で、値は各行で一意です。
この列の値を空白にすると、ファイルのアップロードに失敗します。
列の順序は重要です. アップロードされたファイル内の列の順序は、サンプルファイルと同じ形式に従う必要があります。
見積もり列の内容. これは CSV (コンマ区切り値)ファイルなので、コンマ (,) を含む列コンテンツはすべて引用符で囲む必要があります。 例えば、「こんにちは、トム!」と入力します。
国際文字には 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".
「名」フィールドは、次のように表されます。
<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) (以下の画像を参照)。 この場合、パスは
code language-none /context/profile/firstName. data-nl-expr="/context/profile/firstName".
ロケールと言語名 locale-language-names
次の言語がサポートされています。