Configuración de un envío multilingüe multilingual-delivery
En la interfaz de usuario web de Campaign, puede configurar las entregas como multilingües, lo que le permite enviar mensajes en función del idioma preferido de un perfil. Cuando no se define ninguna preferencia, el mensaje se envía en el idioma predeterminado.
En un envío multilingüe, la administración de idiomas se basa en variantes. Cada variante representa un idioma. Durante la creación de la entrega, puede añadir varias variantes de idioma para que coincidan con el número de idiomas necesarios en el mensaje. También puede cambiar el idioma predeterminado en cualquier momento después de agregar estas variantes.
Actualmente, la capacidad multilingüe está disponible para correos electrónicos, notificaciones push, mensajes transaccionales y SMS.
Para configurar envíos multilingües, siga estos pasos principales:
Añadir una variante de idioma add-variant
Para crear variantes de idioma, siga estos pasos:
-
En el panel de entregas, haga clic en el icono de lápiz para acceder a la pantalla de edición de contenido de entrega y, a continuación, haga clic en Añadir idioma.
note important IMPORTANT El botón Agregar idioma solo está disponible si la dimensión de destino contiene el esquema Idioma. Para obtener más información sobre esquemas y dimensiones de destino, consulte la documentación detallada. {modal="regular"}
-
En el menú desplegable Agregar idioma, seleccione el idioma que desee agregar y confirme la acción. Para las notificaciones push, también puede cargar un archivo CSV para importar todas las variantes de idioma a la vez.
El primer idioma que agregue se establecerá automáticamente como predeterminado y el contenido existente se convertirá en la versión predeterminada. Cuando se añaden idiomas adicionales, su contenido se copia inicialmente del idioma predeterminado.
{modal="regular"}
note note NOTE Los idiomas disponibles en esta lista dependen de los valores definidos por el atributo Language (valores como: system, user, dbenum, etc.). Obtenga más información acerca de la administración de la enumeración en esta sección. -
Repita esta operación para agregar otros idiomas. El panel Idiomas, a la izquierda, muestra la lista de idiomas que ha elegido, el número de idiomas y el idioma predeterminado.
Por ejemplo, si ha elegido inglés, francés y sueco, puede ver estos 3 idiomas como se muestra a continuación:
{modal="regular"}
Para aprender a administrar las variantes de idioma, consulte esta sección.
Definir el contenido para cada variante define-content
Una vez configurados los idiomas, defina el contenido del envío para cada idioma.
-
En la pantalla de edición de contenido de entrega, seleccione un idioma en el panel Idiomas que hay a la izquierda.
{modal="regular"}
-
Defina el contenido del mensaje para este idioma. Obtenga más información en esta sección.
-
Repita esta operación para cada idioma.
Para obtener una vista previa del envío, haga clic en el botón Simular contenido y seleccione perfiles. Asegúrese de que se muestra el contenido correcto para cada perfil.
Administrar variantes de idioma manage-variant
En el panel izquierdo, se muestra toda la información de la variante de idioma. Para eliminar todos los idiomas, haga clic en el botón Expandir y, a continuación, haga clic en Eliminar todas las variantes.
En la lista de variantes de idioma, puede realizar las siguientes acciones:
- Editar: cambia el idioma mientras se mantiene el contenido asociado.
- Establecer como predeterminado: establezca el idioma como predeterminado. Cuando un perfil no tiene definido ningún idioma, el mensaje se envía en el idioma predeterminado.
- Duplicate: duplica el contenido definido para este idioma y elige una variante diferente.
- Eliminar: elimine la variante y su contenido asociado.
Importar variantes de idioma desde CSV (notificaciones push) csv-upload
Para las notificaciones push, puede rellenar rápidamente todas las variantes de idioma cargando un archivo CSV que contenga su contenido multilingüe. Esta función optimiza la creación de campañas multilingües, ya que le permite preparar contenido sin conexión e importarlo por lotes.
- Eficiencia: agregue varios idiomas y su contenido en una sola operación
- Coherencia: garantice mensajes uniformes en todas las variantes de idioma
- Collaboration: permita que los equipos de contenido preparen traducciones en herramientas de hoja de cálculo conocidas
- Administración masiva: administre y actualice fácilmente un gran número de variantes de idioma
Requisitos previos csv-best-practices
Siga estas prácticas recomendadas para garantizar una importación correcta de CSV:
- Use la estructura de columnas exacta: las 14 columnas deben estar presentes en el archivo CSV, aunque deje algunas en blanco. Si faltan columnas, se produce un error de importación. Puede utilizar un orden diferente, pero todas las columnas deben estar presentes.
- Igualar nombres de columna exactamente: Los nombres de columna distinguen entre mayúsculas y minúsculas. Usar
titlenoTitle,badgenoBbadge,localenoLocale. - Use códigos de configuración regional en minúsculas: dé formato a los códigos de configuración regional como
en_us,fr_fr,de_de(en minúsculas con guion bajo), no comoen_USnien-us. - Rellenar columnas obligatorias: Las columnas
localeylanguagedeben contener valores para cada fila. Si los valores están vacíos, se producirá un error de importación. - Mantener configuraciones regionales únicas: Cada código de configuración regional debe aparecer solo una vez en el archivo CSV. Se rechazarán las configuraciones regionales duplicadas.
- Guardar como UTF-8: Guarde siempre el archivo CSV con la codificación UTF-8 para admitir correctamente los caracteres internacionales.
- Contenido que contiene comas: Si el título o el cuerpo del mensaje contiene comas, escriba todo el campo entre comillas dobles:
"Hello, welcome!". - Use valores numéricos correctamente: Para las columnas de indicador (isContentAvailable, isMutableContent, quietPush), use
1para true,0para false o déjelo en blanco para default. - Validar formato JSON: Si utiliza la columna customFields, asegúrese de que el JSON tenga el formato correcto:
{"key":"value"}con comillas y corchetes correctos. - Primero realice la prueba con datos mínimos: empiece con un CSV sencillo en 2-3 idiomas para comprobar el formato antes de crear archivos grandes.
Importar el archivo CSV csv-steps
Para importar variantes de idioma desde un archivo CSV, siga estos pasos:
-
En el editor de contenido de la entrega, haga clic en Agregar idioma.
{modal="regular"}
-
Seleccione el archivo CSV arrastrándolo y soltándolo en el área de carga, o haga clic en para examinar el equipo.
El sistema valida el formato y el contenido del archivo. Si la validación falla, los mensajes de error indican qué columnas o datos son incorrectos. Solucione los problemas en el archivo CSV y vuelva a cargar. Consulte esta sección.
{modal="regular"}
-
Revise el contenido importado en el panel Variantes de idioma para confirmar que todas las traducciones se han cargado correctamente.
{modal="regular"}
Estructura de columna csv-columns
Esta es la estructura de columnas correcta que se debe utilizar:
- title: título de notificación (obligatorio)
- messageBody: cuerpo del mensaje de notificación (obligatorio)
- sound: nombre del archivo de sonido (por ejemplo:
default,custom_sound.mp3) - dejar en blanco de forma predeterminada - distintivo: número de distintivo que se mostrará en el icono de la aplicación (iOS) - usar solo números
- deeplinkURI: URL de vínculo profundo que se abrirá al pulsar la notificación (déjelo en blanco si no se usa)
- category: Identificador de categoría de notificación para acciones personalizadas (iOS): déjelo en blanco si no se usa.
- iosMediaAttachmentURL: URL del archivo adjunto de medios para las notificaciones de iOS; déjelo en blanco si no se utiliza.
- androidMediaAttachmentURL: URL de archivo adjunto multimedia para notificaciones de Android. Déjelo en blanco si no se utiliza.
- isContentAvailable: indicador de contenido disponible (iOS): use
1para true,0para false y déjelo en blanco para default (0) - isMutableContent: indicador de contenido mutable (iOS): use
1para true,0para false y déjelo en blanco para default (0) - customFields: datos personalizados en formato JSON (por ejemplo,
{"key1":"value1","key2":"value2"}): déjelo en blanco si no se usa. - configuración regional: el código de idioma (obligatorio) (por ejemplo,
en_us,fr_fr,de_de- obligatorio) debe ser único por fila - idioma: nombre del idioma (obligatorio); por ejemplo,
English-United States,French-France- obligatorio - quietPush: indicador de inserción silenciosa: use
1para la inserción silenciosa,0para la normal, déjelo en blanco para la predeterminada (0)
Ejemplo de archivo CSV csv-examples
Este es un ejemplo básico con los campos obligatorios:
title,messageBody,sound,badge,deeplinkURI,category,iosMediaAttachmentURL,androidMediaAttachmentURL,isContentAvailable,isMutableContent,customFields,locale,language,silentPush
Welcome!,Thank you for joining us,,,,,,,,,, en_us,English-United States,0
Bienvenue !,Merci de nous avoir rejoint,,,,,,,,,,fr_fr,French-France,0
Willkommen!,Vielen Dank für Ihre Anmeldung,,,,,,,,,, de_de,German-Germany,0
¡Bienvenido!,Gracias por unirte a nosotros,,,,,,,,,, es_es,Spanish-Spain,0
Este es un ejemplo con campos opcionales:
title,messageBody,sound,badge,deeplinkURI,category,iosMediaAttachmentURL,androidMediaAttachmentURL,isContentAvailable,isMutableContent,customFields,locale,language,silentPush
Welcome!,Thank you for joining us,default,1,,,https://example.com/welcome-en.jpg,https://example.com/welcome-en.jpg,,,, en_us,English-United States,0
Bienvenue !,Merci de nous avoir rejoint,default,1,,,https://example.com/welcome-fr.jpg,https://example.com/welcome-fr.jpg,,,, fr_fr,French-France,0
Willkommen!,Vielen Dank für Ihre Anmeldung,default,1,,,https://example.com/welcome-de.jpg,https://example.com/welcome-de.jpg,,,, de_de,German-Germany,0
¡Bienvenido!,Gracias por unirte a nosotros,default,1,,,https://example.com/welcome-es.jpg,https://example.com/welcome-es.jpg,,,, es_es,Spanish-Spain,0
Este es un ejemplo con campos personalizados
title,messageBody,sound,badge,deeplinkURI,category,iosMediaAttachmentURL,androidMediaAttachmentURL,isContentAvailable,isMutableContent,customFields,locale,language,silentPush
New Collection,Discover our latest products,default,1,,,,,,,"{"campaign":"summer2025","segment":"premium"}",en_us,English-United States,0
Nouvelle Collection,Découvrez nos derniers produits,default,1,,,,,,,"{"campaign":"summer2025","segment":"premium"}",fr_fr,French-France,0
Personalization en archivos CSV csv-personalization
Para utilizar campos de personalización en el contenido CSV, debe utilizar etiquetas <span>:
title,messageBody,sound,badge,deeplinkURI,category,iosMediaAttachmentURL,androidMediaAttachmentURL,isContentAvailable,isMutableContent,customFields,locale,language,silentPush
"Hello <span class=""nl-dce-field nl-dce-done"" data-nl-expr=""recipient.firstName"">recipient.firstName</span>","Your order has shipped!",,,,,,,,,,en_us,English-United States,0
"Bonjour <span class=""nl-dce-field nl-dce-done"" data-nl-expr=""recipient.firstName"">recipient.firstName</span>","Votre commande a été expédiée !",,,,,,,,,,fr_fr,French-France,0
Durante la entrega, Campaign reemplaza estos marcadores de posición con los datos de destinatario reales.
Solución de problemas csv-troubleshooting
{"key":"value"} o déjelo en blancobadge, no Badge ni BADGE)Las prácticas recomendadas se enumeran en esta sección. La estructura de columnas se detalla en esta sección.