產生多語言推送通知的 CSV 檔案 generating-csv-multilingual-push
上傳CSV檔案來產生傳送內容是一項用於支援多語言推播通知的功能。 CSV檔案的格式必須符合某些准則才能成功上傳檔案，進而建立傳送。 以下各節將說明檔案格式及其考量事項。
檔案格式 file-format
多語言推送在CSV檔案中需要14欄：
- 標題
- messageBody
- 聲音
- adge
- deeplinkURI
- 類別
- iosMediaAttachmentURL
- androidMediaAttachmentURL
- isContentAvailable
- isMutableContent
- customField
- 地區設定
- 語言
- 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
支援下列語言：