Generación de un archivo CSV para notificaciones push multilingües 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 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 de CSV haciendo clic en Download a sample file en el Manage Content Variants ventana. Para obtener más información, consulte esta sección.
- title, messageBody, sound, badge, deeplinkURI, category, iosMediaAttachmentURL, androidMediaAttachmentURL: contenido de carga útil push normal. Debe proporcionar esta información de manera similar a como se hace al crear envíos push.
- Campos personalizados: utilice el formato JSON para los campos personalizados, por ejemplo.
{"key1":"value1","key2":"value2"}
. Consulte el archivo de muestra anterior para ver un ejemplo de campos personalizados. - isContentAvailable: indicador para 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 para 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.
- locale: configuración regional es el campo para las variantes de idioma, por ejemplo, "en_us" para inglés estadounidense 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 para el 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 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 importa. El orden de las columnas del archivo cargado debe seguir el mismo formato que el archivo de muestra.
Citar contenido de columna. 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!"
La codificación UTF-8 es necesaria para caracteres internacionales.
Si genera el archivo mediante texto sin formato, separe cada columna con ",".
La variante no coincide. Si utiliza bloques de contenido y audiencias de destino con idiomas específicos, debe enumerar todos los idiomas de destino en el archivo CSV o se producirá un error al realizar el envío.
Inserción del campo de personalización en el archivo CSV personalization-field-csv
Si desea utilizar campos de personalización, debe incluir lo siguiente 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 siguiente imagen). 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 locale-language-names
Se admiten los siguientes idiomas: