產生多語言推送通知的 CSV 檔案 generating-csv-multilingual-push

上傳CSV檔案來產生傳送內容是一項用於支援多語言推播通知的功能。 CSV檔案的格式必須符合某些准則才能成功上傳檔案,進而建立傳送。 以下各節將說明檔案格式及其考量事項。

檔案格式 file-format

多語言推送在CSV檔案中需要14欄:

  1. 標題
  2. messageBody
  3. 聲音
  4. adge
  5. deeplinkURI
  6. 類別
  7. iosMediaAttachmentURL
  8. androidMediaAttachmentURL
  9. isContentAvailable
  10. isMutableContent
  11. customField
  12. 地區設定
  13. 語言
  14. 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: Mutable Content的旗標,值1表示true,值0表示false。 預設值為0。 如果您將此欄保留為空白,則會將該值視為0。
  • locale: locale是語言變體的欄位,例如「en_us」代表美國英文,「fr_fr」代表法國法文。
  • 語言:與地區設定關聯的語言名稱。 例如,如果locale為"en_us",則語言名稱應為"English-United States"。
  • silentPush:推播通知型別的旗標。 若為一般推播通知,則值應為0。 如果是無訊息推播,值應該為1。 預設值為0。 如果您將此欄保留為空白,則會將該值視為0。

建立csv檔案的限制和准則 constraints-guideline-csv

每個資料行的名稱都是固定的
您應該在CSV檔案中包含每個欄的名稱,如果您未對內容使用任何欄,請將其留空。

"locale"和"language"欄是必填欄位,而且每個列的值都是唯一的。
此欄的空白值將導致檔案上傳失敗。

資料行的順序很重要。 上傳檔案中的欄順序需要遵循與範例檔案相同的格式。

引號資料行內容。 由於這是CSV (代表逗號分隔值)檔案,因此必須引用包含逗號(,)的任何欄內容。 例如,「Hello, Tom!」

國際字元需要​ 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>

在範圍中有兩個必要屬性:

  • 一個是靜態類別。 無論您計畫使用哪個個人化欄位,該欄位一律為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

支援下列語言:

地區設定
語言
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
越南文 — 越南
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff