多言語プッシュ通知用の CSV ファイルの生成 generating-csv-multilingual-push
配信用のコンテンツを生成するためのCSV ファイルのアップロードは、多言語プッシュ通知をサポートするために使用される機能です。 CSV ファイルの形式は、ファイルのアップロードを成功させ、結果として配信を作成できるようにするために、特定のガイドラインに準拠する必要があります。 次の節では、ファイル形式とその考慮事項について説明します。
ファイル形式 file-format
多言語プッシュには、CSV ファイルに14列が必要です。
- タイトル
- messageBody
- サウンド
- adge
- deeplinkURI
- カテゴリー
- iosMediaAttachmentURL
- androidMediaAttachmentURL
- isContentAvailable
- isMutableContent
- customFields
- ロケール
- 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: localeは言語バリアントのフィールドです。例えば、US-Englishでは「en_us」、France-Frenchでは「fr_fr」です。
- 言語: ロケールに関連付けられている言語の名前。 例えば、ロケールが「en_us」の場合、言語の名前は「English-United States」になります。
- silentPush: プッシュ通知タイプのフラグ。 通常のプッシュ通知の場合、値は0にする必要があります。 サイレントプッシュの場合、値は1になります。 デフォルト値は0です。 この列を空白のままにすると、値は0とみなされます。
csv ファイルの作成に関する制約とガイドライン constraints-guideline-csv
各列の名前は固定されています。
CSV ファイルに各列の名前を含める必要があります。コンテンツに列を使用しない場合は、空白のままにします。
「ロケール」列と「言語」列は必須であり、値は各行で一意です。
この列の値が空白の場合、ファイルのアップロードに失敗します。
列の順序。 アップロードしたファイルの列の順序は、サンプルファイルと同じ形式にする必要があります。
見積列の内容。 これは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".
「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"になります。
-
もうひとつは、パーソナライゼーションフィールドのパスである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
次の言語がサポートされています。