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
Controlla il file CSV campione facendo clic sul pulsante Download a sample file nel Manage Content Variants finestra. Per ulteriori informazioni, consulta questa sezione.
- title, messageBody, sound, badge, deeplinkURI, category, iosMediaAttachmentURL, androidMediaAttachmentURL: contenuto del payload push regolare. 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: flag per il 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: locale è il campo per le varianti di lingua, ad esempio "en_us" per l’inglese americano e "fr_fr" per il francese.
- lingua: nome della lingua associata alla lingua. 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.
Ordine delle colonne. 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 il file viene generato in formato testo normale, separa ogni colonna con ",".
Variante non corrispondente. Se utilizzi i tipi di pubblico per blocchi di contenuto e target con lingue specifiche, devi elencare ogni lingua 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 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: