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

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

ファイル形式

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

  1. タイトル
  2. messageBody
  3. adge
  4. deeplinkURI
  5. カテゴリー
  6. iosMediaAttachmentURL
  7. androidMediaAttachmentURL
  8. isContentAvailable
  9. isMutableContent
  10. customFields
  11. locale
  12. language
  13. 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".
    

ロケールと言語名

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

locale language
af_za アフリカ語 — 南アフリカ
sq_al アルバニア語 — アルバニア
ar_dz アラビア語 — アルジェリア
ar_bh アラビア語 — バーレーン
ar_iq アラビア語 — イラク
ar_il アラビア語 — イスラエル
ar_jo アラビア語 — ヨルダン
ar_kw アラビア語 — クウェート
ar_lb アラビア語 — レバノン
ar_ma アラビア語 — モロッコ
ar_om アラビア語 — オマーン
ar_qa アラビア語 — カタール
ar_sa アラビア語 — サウジアラビア
ar_sy アラビア語 — シリア
ar_tn アラビア語 — チュニジア
ar_ae アラビア語 — アラブ首長国連邦
ar_ye アラビア語 — イエメン
hy_am アルメニア語 — アルメニア
az_az アゼリ語 — アゼルバイジャン
be_by ベラルーシ語 — ベラルーシ
bs_ba ボスニア語 — ボスニア
bg_bg ブルガリア語 — ブルガリア
ca_es カタルーニャ語 — スペイン
zh_cn 中国語(簡体字) — 中国
zh_sg 中国語(簡体字) — シンガポール
zh_hk 中国語(繁体字) — 香港、中国
zh_tw 中国語(繁体字) — 台湾地域
hr_hr クロアチア語 — クロアチア
cs_cz チェコ語 — チェコ
da_dk デンマーク語 — デンマーク
nl_be オランダ語 — ベルギー
nl_nl オランダ語 — オランダ
en_au 英語 — オーストラリア
en_bz 英語 — ベリーズ
en_ca 英語 — カナダ
en_in 英語 — インド
en_ie 英語 — アイルランド
en_jm 英語 — ジャマイカ
en_nz 英語 — ニュージーランド
en_ph 英語 — フィリピン
en_za 英語 — 南アフリカ
en_tt 英語 — トリニダード・トバゴ
en_gb 英語 — 英国
en_us 英語 — 米国
en_zw 英語 — ジンバブエ
et_ee エストニア語 — エストニア
fi_fi フィンランド語 — フィンランド
fr_be フランス語 — ベルギー
fr_ca フランス語 — カナダ
fr_fr フランス語 — フランス
fr_lu フランス語 — ルクセンブルク
fr_ch フランス語 — スイス
de_at ドイツ語 — オーストリア
de_de ドイツ語 — ドイツ
de_lu ドイツ語 — ルクセンブルク
de_ch ドイツ語 — スイス
el_cy ギリシャ語 — キプロス
el_gr ギリシャ語 — ギリシャ
gu_in グジャラーティ — インド
he_il ヘブライ語 — イスラエル
hi_in ヒンディー語 — インド
hu_hu ハンガリー語 — ハンガリー
is_is アイスランド語 — アイスランド
id_id インドネシア語 — インドネシア
it_it イタリア語 — イタリア
it_ch イタリア語 — スイス
ja_jp 日本語 — 日本
kn_in カンナダ語 — インド
kk_kz カザフ語 — カザフスタン
ko_kr 韓国語 — 韓国
lv_lv ラトビア語 — ラトビア
lt_lt リトアニア語 — リトアニア
mk_mk マケドニア語 — マケドニア
ms_my マレー語 — マレーシア
mr_in マラーティ — インド
no_no ノルウェー語 — ノルウェー
pl_pl ポーランド語 — ポーランド
pt_br ポルトガル語 — ブラジル
pt_pt ポルトガル語 — ポルトガル
pa_in パンジャビ — インド
ro_md ルーマニア語 — モルドバ
ro_ro ルーマニア語 — ルーマニア
ru_kz ロシア語 — カザフスタン
ru_ru ロシア語 — ロシア
ru_ua ロシア語 — ウクライナ
a_in サンスクリット語 — インド
sr_ba セルビア語 — ボスニア
sr_rs セルビア語 — セルビア
sk_sk スロバキア — スロバキア
sl_si スロベニア語 — スロベニア
es_ar スペイン語 — アルゼンチン
es_bo スペイン語 — ボリビア
es_cl スペイン語 — チリ
es_co スペイン語 — コロンビア
es_cr スペイン語 — コスタリカ
es_do スペイン語 — ドミニカ共和国
es_ec スペイン語 — エクアドル
es_sv スペイン語 — エルサルバドル
es_gt スペイン語 — グアテマラ
es_hn スペイン語 — ホンジュラス
es_mx スペイン語 — メキシコ
es_ni スペイン語 — ニカラグア
es_pa スペイン語 — パナマ
es_py スペイン語 — パラグアイ
es_pe スペイン語 — ペルー
es_pr スペイン語 — プエルトリコ
es_es スペイン語 — スペイン
es_uy スペイン語 — ウルグアイ
es_ve スペイン語 — ベネズエラ
sw_ke スワヒリ語 — ケニア
sv_fi スウェーデン語 — フィンランド
sv_se スウェーデン語 — スウェーデン
ta_in タミル語 — インド
tt_ru タタール — ロシア語
te_in テルグ語 — インド
th_th タイ語 — タイ
tr_cy トルコ語 — キプロス
tr_tr トルコ語 — トルコ
uk_ua ウクライナ語 — ウクレイン
ur_in ウルドゥ語 — インド
ur_pk ウルドゥ語 — パキスタン
vi_vn ベトナム語 — ベトナム

このページ