Generación de un archivo CSV para notificaciones push multilingües :headding-anchor:generating-csv-multilingual-push
La carga de un archivo CSV para generar contenido para su envío es una función que se utiliza para admitir notificaciones push multilingües. El formato del archivo CSV debe cumplir ciertas directrices para que la carga del archivo se realice correctamente y, por lo tanto, para poder crear una entrega. En las siguientes secciones se describe el formato de archivo y sus consideraciones.
Formato de archivo :headding-anchor:file-format
La funcionalidad push multilingüe requiere 14 columnas en el archivo CSV:
- título
- messageBody
- sano
- adge
- deeplinkURI
- categoría
- iosMediaAttachmentURL
- androidMediaAttachmentURL
- isContentAvailable
- isMutableContent
- customFields
- locale
- idioma
- quietPush
Compruebe el ejemplo CSV haciendo clic en Download a sample file en la ventana Manage Content Variants. Para obtener más información, consulte esta sección.
- title, messageBody, sound, badge, deeplinkURI, category, iosMediaAttachmentURL, androidMediaAttachmentURL: contenido de carga push normal. Debe proporcionar esta información de manera similar a como se hace al crear envíos push.
- Campos personalizados: use el formato JSON para los campos personalizados, p. ej.
{"key1":"value1","key2":"value2"}
. Consulte el archivo de muestra anterior para ver un ejemplo de campos personalizados. - isContentAvailable: indicador de la comprobación de Contenido disponible, el valor 1 implica verdadero, el valor 0 implica falso. El valor predeterminado es 0. Si deja esta columna en blanco, el valor se considerará 0.
- isMutableContent: indicador de contenido mutable, el valor 1 implica verdadero, el valor 0 implica falso. El valor predeterminado es 0. Si deja esta columna en blanco, el valor se considerará 0.
- configuración regional: la configuración regional es el campo para las variantes de idioma, por ejemplo, "en_us" para inglés de EE. UU. y "fr_fr" para francés.
- idioma: nombre del idioma asociado con la configuración regional. Por ejemplo, si la configuración regional es "en_us", el nombre del idioma debe ser "Inglés-Estados Unidos".
- quietPush: indicador del tipo de notificación push. Si es una notificación push regular, el valor debe ser 0. Si se trata de una inserción silenciosa, el valor debe ser 1. El valor predeterminado es 0. Si deja esta columna en blanco, el valor se considerará 0.
Restricciones y directrices para la creación de archivos .csv :headding-anchor:constraints-guideline-csv
El nombre de cada columna es fijo.
Debe incluir el nombre de cada columna en el archivo CSV. Si no utiliza ninguna columna para el contenido, déjelo en blanco.
Las columnas "locale" e "language" son obligatorias y el valor es único para cada fila.
Un valor en blanco para esta columna provocará un error en la carga del archivo.
El orden de las columnas es importante. El orden de las columnas del archivo cargado debe seguir el mismo formato que el archivo de muestra.
Contenido de columna de cotización. Dado que se trata de un archivo CSV (significa Valores separados por comas), cualquier contenido de columna que incluya una coma (,) debe citarse. Por ejemplo: "¡Hola, Tom!"
Se requiere la codificación UTF-8 para los caracteres internacionales.
Si genera el archivo mediante texto sin formato, separe cada columna con ",".
Variante No Coincidente. Si usa bloques de contenido y audiencias de destino con idiomas específicos, debe enumerar todos los idiomas de destino en el archivo CSV o recibirá un error al realizar el envío.
Inserción del campo de personalización en el archivo CSV :headding-anchor:personalization-field-csv
Si desea utilizar campos de personalización, debe incluir la etiqueta en el archivo.
Para insertar el campo de personalización "firstName" en messageBody, el mensaje debe:
"Hello <span class="nl-dce-field nl-dce-done" data-nl-expr="/context/profile/firstName">First name</span>, this is message".
El campo "firstName" se representa mediante:
<span class="nl-dce-field nl-dce-done" data-nl-expr="/context/profile/firstName">First name</span>
En el intervalo hay dos atributos obligatorios:
-
Una es la clase que es estática. Independientemente del campo de personalización que planee utilizar, siempre será class="nl-dce-field nl-dce-done".
-
Otro es data-nl-expr, que es la ruta del campo de personalización. Por ejemplo, si inserta el campo de personalización "firstName" desde la interfaz de usuario, la ruta de navegación será Context (context) > Profile (profile) > First name (firstName) (como se muestra en la imagen siguiente). En este caso, la ruta es
code language-none /context/profile/firstName. data-nl-expr="/context/profile/firstName".
Configuración regional y nombres de idioma :headding-anchor:locale-language-names
Se admiten los siguientes idiomas: