Generazione di un file CSV per notifiche push multilingue generating-csv-multilingual-push
Il caricamento di un file CSV per generare contenuti da distribuire è una funzione utilizzata per supportare le notifiche push multilingue. Il formato del file CSV deve rispettare determinate linee guida affinché il caricamento dei file abbia esito positivo e possa quindi creare una consegna. Le sezioni seguenti descrivono il formato del file e le relative considerazioni.
Formato file file-format
Il push multilingue richiede 14 colonne nel file CSV:
- titolo
- messageBody
- suono
- adge
- deeplinkURI
- categoria
- iosMediaAttachmentURL
- androidMediaAttachmentURL
- isContentAvailable
- isMutableContent
- customFields
- lingua
- lingua
- silentPush
Controllare il file CSV di esempio facendo clic su Download a sample file nella finestra Manage Content Variants. Per ulteriori informazioni, consulta questa sezione.
- title, messageBody, sound, badge, deeplinkURI, category, iosMediaAttachmentURL, androidMediaAttachmentURL: contenuto normale del payload push. Devi fornire queste informazioni in modo simile a quando crei le consegne push.
- Campi personalizzati: utilizza il formato JSON per i campi personalizzati, ad esempio
{"key1":"value1","key2":"value2"}. Per un esempio di campi personalizzati, fai riferimento al file di esempio riportato sopra. - isContentAvailable: contrassegno per controllo contenuto disponibile, il valore 1 indica vero, il valore 0 indica falso. Il valore predefinito è 0. Se si lascia vuota questa colonna, il valore verrà considerato 0.
- isMutableContent: flag per contenuto variabile; il valore 1 indica vero; il valore 0 indica falso. Il valore predefinito è 0. Se si lascia vuota questa colonna, il valore verrà considerato 0.
- lingua: lingua è il campo per le varianti di lingua. Esempio: "en_us" per inglese US e "fr_fr" per francese.
- lingua: nome della lingua associata alle impostazioni locali. Ad esempio, se locale è "en_us", il nome della lingua deve essere "English-United States".
- silentPush: flag per il tipo di notifica push. Se si tratta di una notifica push regolare, il valore deve essere 0. Se si tratta di una richiesta push silenziosa, il valore deve essere 1. Il valore predefinito è 0. Se si lascia vuota questa colonna, il valore verrà considerato 0.
Vincoli e linee guida per la creazione del file CSV constraints-guideline-csv
Il nome di ogni colonna è fisso.
Devi includere il nome di ogni colonna nel file CSV; se non utilizzi alcuna colonna per il contenuto, lascialo vuoto.
le colonne "lingua" e "lingua" sono obbligatorie e il valore è univoco per ogni riga.
Un valore vuoto per questa colonna causerà un errore nel caricamento del file.
L'ordine delle colonne è importante. L’ordine delle colonne nel file caricato deve seguire lo stesso formato del file di esempio.
Contenuto colonna preventivo. Poiché si tratta di un file CSV (acronimo di Comma-Separated Values, Valori separati da virgole), deve essere inserito un apice per qualsiasi contenuto di colonna che includa la virgola (,). Per esempio, "Ciao, Tom!"
La codifica UTF-8 è necessaria per i caratteri internazionali.
Se si genera il file in formato testo normale, separare ogni colonna con ",".
Variante non corrispondente. Se utilizzi il blocco di contenuto e rivolgiti a tipi di pubblico specifici con lingue specifiche, devi elencare tutte le lingue di destinazione nel file CSV, altrimenti riceverai un errore durante l'invio della consegna.
Inserimento di un campo di personalizzazione nel file csv personalization-field-csv
Se desideri utilizzare i campi di personalizzazione, devi includere il tag nel file.
Per inserire il campo di personalizzazione "firstName" in messageBody, il messaggio deve essere:
"Hello <span class="nl-dce-field nl-dce-done" data-nl-expr="/context/profile/firstName">First name</span>, this is message".
Il campo "firstName" è rappresentato da:
<span class="nl-dce-field nl-dce-done" data-nl-expr="/context/profile/firstName">First name</span>
Nell’estensione sono presenti due attributi obbligatori:
-
Uno è la classe, che è statica. Indipendentemente dal campo di personalizzazione che intendi utilizzare, sarà sempre class="nl-dce-field nl-dce-done".
-
Un altro è data-nl-expr, che è il percorso del campo di personalizzazione. Ad esempio, se inserisci il campo di personalizzazione "firstName" dall’interfaccia utente, il percorso di navigazione sarà Context (context) > Profile (profile) > First name (firstName) (come illustrato nell’immagine seguente). In questo caso, il percorso sarà
code language-none /context/profile/firstName. data-nl-expr="/context/profile/firstName".
Nomi lingue e impostazioni internazionali locale-language-names
Sono supportate le seguenti lingue: