Generera en CSV-fil för flerspråkiga push-meddelanden generating-csv-multilingual-push
Att överföra en CSV-fil för att generera innehåll för leverans är en funktion som stöder flerspråkiga push-meddelanden. Formatet på CSV-filen måste följa vissa riktlinjer för att filöverföringen ska lyckas och därmed kunna skapa en leverans. I följande avsnitt beskrivs filformatet och övervägandena om detta.
Filformat file-format
Flerspråkig push kräver 14 kolumner i CSV-filen:
- title
- messageBody
- ljud
- skugga
- deeplinkURI
- kategori
- iosMediaAttachmentURL
- androidMediaAttachmentURL
- isContentAvailable
- isMutableContent
- customFields
- locale
- språk
- silentPush
Kontrollera CSV-exemplet genom att klicka på Download a sample file i fönstret Manage Content Variants. Mer information finns i det här avsnittet.
- title, messageBody, sound, badge, deeplinkURI, category, iosMediaAttachmentURL, androidMediaAttachmentURL: reguljärt push-nyttolastinnehåll. Du måste ange den här informationen på liknande sätt som när du skapar push-leveranser.
- Anpassade fält: använd JSON-format för anpassade fält, t.ex.
{"key1":"value1","key2":"value2"}
. I exempelfilen ovan finns ett exempel på anpassade fält. - isContentAvailable: flagga för kontrollen Tillgängligt innehåll, värde 1 betyder true, värde 0 betyder false. Standardvärdet är 0. Om du lämnar den här kolumnen tom räknas värdet som 0.
- isMutableContent: flagga för Mutable Content, value 1 betyder true, value 0 betyder false. Standardvärdet är 0. Om du lämnar den här kolumnen tom räknas värdet som 0.
- locale: locale är fältet för språkvarianter, t.ex. "en_us" för amerikansk-engelska och "fr_fr" för franska-franska.
- språk: namnet på det språk som är associerat med språkinställningen. Om språkinställningen till exempel är "en_us" ska namnet på språket vara " English-United States".
- silentPush: flagga för push-meddelandetypen. Om det är ett vanligt push-meddelande ska värdet vara 0. Om det är en tyst överföring ska värdet vara 1. Standardvärdet är 0. Om du lämnar den här kolumnen tom räknas värdet som 0.
Begränsningar och riktlinjer för att skapa CSV-filer constraints-guideline-csv
Namnet på varje kolumn är fast.
Du bör inkludera namnet på varje kolumn i CSV-filen, om du inte använder några kolumner för innehållet, lämna det tomt.
Kolumnerna "locale" och"language" är obligatoriska och värdet är unikt för varje rad.
Om du anger ett tomt värde för den här kolumnen misslyckas filöverföringen.
Kolumnordningen har betydelse. Kolumnernas ordning i den överförda filen måste följa samma format som exempelfilen.
Offertkolumninnehåll. Eftersom det här är en CSV-fil (står för Comma-Separated Values) måste allt kolumninnehåll som innehåller kommatecken (,) anges. Till exempel"Hej, Tom!"
UTF-8-kodning krävs för internationella tecken.
Om du genererar filen med oformaterad text avgränsar du varje kolumn med ",".
Variantfel. Om du använder innehållsblock och målgrupper med specifika språk måste du visa alla målspråk i CSV-filen, annars uppstår fel när leveransen skickas.
Infogning av anpassningsfält i CSV-filen personalization-field-csv
Om du vill använda anpassningsfält bör du inkludera taggen i filen.
Om du vill infoga anpassningsfältet"firstName" i messageBody måste meddelandet vara:
"Hello <span class="nl-dce-field nl-dce-done" data-nl-expr="/context/profile/firstName">First name</span>, this is message".
"firstName"-fältet representeras av:
<span class="nl-dce-field nl-dce-done" data-nl-expr="/context/profile/firstName">First name</span>
I intervallet finns två obligatoriska attribut:
-
En är en klass som är statisk. Oberoende av vilket anpassningsfält du tänker använda så kommer det alltid att vara class="nl-dce-field nl-dce-made".
-
Ett annat är data-nl-expr, som är sökvägen till personaliseringsfältet. Om du till exempel infogar anpassningsfältet"firstName" från användargränssnittet, kommer navigeringssökvägen att vara Context (context) > Profile (profile) > First name (firstName) (vilket visas i bilden nedan). I det här fallet blir sökvägen
code language-none /context/profile/firstName. data-nl-expr="/context/profile/firstName".
Språk- och språkinställningar locale-language-names
Följande språk stöds: