Generazione di un file CSV per notifiche push multilingue

Il caricamento di un file CSV per generare contenuto per la consegna è una funzione utilizzata per supportare le notifiche push multilingue. Il formato del file CSV deve rispettare alcune linee guida per il corretto caricamento del file e, di conseguenza, deve essere in grado di 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:

  1. title
  2. messageBody
  3. suono
  4. età
  5. deeplinkURI
  6. categoria
  7. iosMediaAttachmentURL
  8. androidMediaAttachmentURL
  9. isContentAvailable
  10. isMablesContent
  11. customFields
  12. locale
  13. language
  14. silenziosoPush

Controlla il campione CSV facendo clic su Download a sample file nella finestra Manage Content Variants. Per ulteriori informazioni, consulta questa sezione.

  • title, messageBody, sound, badge, deeplinkURI, categoria, 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, fai riferimento al file di esempio precedente.
  • isContentAvailable: Flag per il controllo Contenuto disponibile, il valore 1 implica true, il valore 0 indica false. Il valore predefinito è 0. Se lasci questa colonna vuota, il valore sarà considerato 0.
  • isMablesContent: Flag per Contenuto variabile, il valore 1 implica true, il valore 0 implica false. Il valore predefinito è 0. Se lasci questa colonna vuota, 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".
  • silenziosoPush: 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 lasci questa colonna vuota, il valore sarà considerato 0.

Vincoli e linee guida per la creazione di file csv

Il nome di ogni colonna è fisso.
Inserisci il nome di ogni colonna nel file CSV se non utilizzi alcuna colonna per il contenuto, lascialo vuoto.

Le colonne "locale" e "lingua" sono obbligatorie e il valore è univoco per ogni riga.
Un valore vuoto per questa colonna causerà un errore di 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 del preventivo. Dato che si tratta di un file CSV (che sta per Valori separati da virgole), qualsiasi contenuto di colonna che include la virgola (,) deve essere citato. Per esempio, "Ciao, Tom!"

La codifica UTF-8 è necessaria per i caratteri internazionali.

Se generi il file in testo normale, separa ogni colonna per ",".

Variante non corrispondente. Se utilizzi blocchi di contenuto e tipi di pubblico per il targeting con lingue specifiche, devi elencare tutte le lingue di destinazione nel file CSV; in caso contrario si verifica un errore durante l’invio della consegna.

Inserimento di un campo di personalizzazione nel file 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’intervallo 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à

    /context/profile/firstName. data-nl-expr="/context/profile/firstName".
    

Impostazioni internazionali e nomi della lingua

Sono supportate le seguenti lingue:

locale language
af_za Afrikaans - Sudafrica
sq_al Albanese - Albania
ar_dz Arabo - Algeria
ar_bh Arabo - Bahrein
ar_iq Arabo - Iraq
ar_il Arabo - Israele
ar_jo Arabo - Giordania
ar_kw Arabo - Kuwait
ar_lb Arabo - Libano
ar_ma Arabo - Marocco
ar_om Arabo - Oman
ar_qa Arabo - Qatar
ar_sa Arabo - Arabia Saudita
ar_sy Arabo - Siria
ar_tn Arabo - Tunisia
ar_ae Arabo - Emirati Arabi Uniti
ar_ye Arabo - Yemen
hy_am Armeno - Armenia
az_az Azeri - Azerbaigian
be_by Bielorussia - Bielorussia
bs_ba Bosniaco - Bosnia
bg_bg Bulgaria - Bulgaria
ca_es Catalano - Spagna
zh_cn Cinese (semplificato) - Cina
zh_sg Cinese (semplificato) - Singapore
zh_hk Cinese (tradizionale) - Hong Kong RAS della Cina
zh_tw Cinese (tradizionale) - Taiwan regione
hr_hr Croato - Croazia
cs_cz Ceco - Ceca
da_dk Danese - Danimarca
nl_be Olandese - Belgio
nl_nl Olandese - Paesi Bassi
en_au Inglese - Australia
en_bz Inglese - Belize
en_ca Inglese - Canada
en_in Inglese - India
en_ie Inglese - Irlanda
en_jm Inglese - Giamaica
en_nz Inglese - Nuova Zelanda
en_ph Inglese - Filippine
en_za Inglese - Sudafrica
en_tt Inglese - Trinidad e Tobago
en_gb Inglese - Regno Unito
en_us Inglese - Stati Uniti
en_zw Inglese - Zimbabwe
et_ee Estone - Estonia
fi_fi Finlandese - Finlandia
fr_be Francese - Belgio
fr_ca Francese - Canada
fr_fr Francese - Francia
fr_lu Francese - Lussemburgo
fr_ch Francese - Svizzera
de_at Tedesco - Austria
de_de Tedesco - Germania
de_lu Tedesco - Lussemburgo
de_ch Tedesco - Svizzera
el_cy Greco - Cipro
el_gr Greco - Grecia
gu_in Gujarati - India
he_il Ebraico - Israele
hi_in Hindi - India
hu_hu Ungherese - Ungheria
is_is Islandese - Islanda
id_id Indonesiano - Indonesia
it_it Italiano - Italia
it_ch Italiano - Svizzera
ja_jp Giapponese - Giappone
kn_in Kannada - India
kk_kz Kazako - Kazakistan
ko_kr Coreano - Corea del Sud
lv_lv Lettone - Lettonia
lt_lt Lituano - Lituania
mk_mk Macedone - Macedonia
ms_my Malese - Malesia
mr_in Marathi - India
no_no Norvegese - Norvegia
pl_pl Polacco - Polonia
pt_br Portoghese - Brasile
pt_pt Portoghese - Portogallo
pa_in Punjabi - India
ro_md Rumeno - Moldova
ro_ro Rumeno - Romania
ru_kz Russo - Kazakistan
ru_ru Russo - Russia
ru_ua Russo - Ucraina
a_in Sanscrito - India
sr_ba Serbo - Bosnia
sr_rs Serbo - Serbia
sk_sk Slovacco - Slovacchia
sl_si Sloveno - Slovenia
es_ar Spagnolo - Argentina
es_bo Spagnolo - Bolivia
es_cl Spagnolo - Cile
es_co Spagnolo - Colombia
es_cr Spagnolo - Costa Rica
es_do Spagnolo - Repubblica Dominicana
es_ec Spagnolo - Ecuador
es_sv Spagnolo - El Salvador
es_gt Spagnolo - Guatemala
es_hn Spagnolo - Honduras
es_mx Spagnolo - Messico
es_ni Spagnolo - Nicaragua
es_pa Spagnolo - Panama
es_py Spagnolo - Paraguay
es_pe Spagnolo - Perù
es_pr Spagnolo - Porto Rico
es_es Spagnolo - Spagna
es_uy Spagnolo - Uruguay
es_ve Spagnolo - Venezuela
sw_ke Swahili - Kenya
sv_fi Svedese - Finlandia
sv_se Svedese - Svezia
ta_in Tamil - India
tt_ru Tartaro - Russo
te_in Telugu - India
th_th Thai - Thailandia
tr_cy Turco - Cipro
tr_tr Turco - Turchia
uk_ua Ucraino - Ucraina
ur_in Urdu - India
ur_pk Urdu - Pakistan
vi_vn Vietnamita - Vietnam

In questa pagina