Generazione di un file CSV per notifiche push multilingue
Il caricamento di un file CSV per generare contenuto per la distribuzione è una funzione utilizzata per supportare le notifiche push in più lingue. Il formato del file CSV deve rispettare alcune linee guida per il corretto caricamento del file e, di conseguenza, per creare una consegna. Le sezioni seguenti descrivono il formato del file e le relative considerazioni.
Formato file
Il push multilingue richiede 14 colonne nel file CSV:
title
messageBody
sound
data
deeplinkURI
category
iosMediaAttachmentURL
androidMediaAttachmentURL
isContentAvailable
isMablesContent
customFields
locale
language
silentPush
Controllate l'esempio CSV facendo clic su Download a sample file nella finestra Manage Content Variants. Per ulteriori informazioni, consultare la sezione a1/>.
title, messageBody, sound, badge, deeplinkURI, category, iosMediaAttachmentURL, androidMediaAttachmentURL: contenuto normale del payload push. Devi fornire queste informazioni in modo simile a quando crei consegne push.
Campi personalizzati: utilizza il formato JSON per i campi personalizzati, ad esempio {"key1":"value1","key2":"value2"}. Per un esempio di campi personalizzati, fare riferimento al file di esempio precedente.
isContentAvailable: flag per la verifica Contenuto disponibile, il valore 1 indica true, il valore 0 indica false. Il valore predefinito è 0. Se lasciate vuota questa colonna, il valore sarà considerato 0.
isMablesContent: flag per Contenuto variabile, il valore 1 indica true, il valore 0 indica false. Il valore predefinito è 0. Se lasciate vuota questa colonna, il valore sarà considerato 0.
locale: locale è il campo per le varianti di lingua, ad esempio "en_us" per US-English e "fr_fr" per France-French.
lingua: nome della lingua associata alle impostazioni internazionali. Ad esempio, se l'impostazione internazionale è "en_us", il nome della lingua deve essere "Inglese-Stati Uniti".
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 un push silenzioso, il valore deve essere 1. Il valore predefinito è 0. Se lasciate vuota questa colonna, il valore sarà considerato 0.
Vincoli e Linee guida per la creazione di file CSV
Il nome di ogni colonna è fisso.
Dovete includere il nome di ciascuna colonna nel file CSV, se non utilizzate colonne per il contenuto, lasciatelo vuoto.
Le colonne "locale" 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 della colonna Preventivo. Poiché si tratta di un file CSV (che sta per valori separati da virgole), qualsiasi contenuto di colonna che includa la virgola (,) deve essere citato. Per esempio, "Ciao, Tom!"
La codifica UTF-8 è necessaria per i caratteri internazionali.
Se generate il file in testo normale, separate ogni colonna per ",".
Variante non corrispondente. Se utilizzate audience di blocchi di contenuto e target con lingue specifiche, dovete elencare tutte le lingue di destinazione nel file CSV oppure ricevete un errore durante l'invio della consegna.
Inserimento di un campo di personalizzazione nel file CSV
Se desiderate utilizzare i campi di personalizzazione, dovete includere nel file il tag .
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".
Nell'estensione sono presenti due attributi obbligatori:
Una è 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à
