Mensajes multilingües

Después de añadir configuraciones regionales a tu espacio de trabajo, puedes dirigirte a usuarios en diferentes idiomas, todo dentro de un solo push, correo electrónico, webhook, banner, mensaje dentro de la aplicación o Content Block.

Requisitos previos

• configuraciones regionales multilingües
• tipos de mensaje
• plantillas

Usar locales

Paso 1: Configurar locales

Antes de poder agregar traducciones a un mensaje, primero debes crear los locales que deseas admitir. Los locales definen las variantes de idioma (y opcionalmente de región) disponibles para la mensajería.

Paso 2: Marcar el contenido para traducción

Envuelve el texto que deseas traducir con las etiquetas de traducción de Liquid {% translation your_id_here %} y {% endtranslation %} y asigna un ID de etiqueta. Los ID de las etiquetas de traducción deben ser únicos dentro de un mensaje. Considera usar nombres de ID semánticos que describan claramente el texto, como {% translation header %}.

Aquí tienes un ejemplo de mensaje marcado para traducción: {% translation greeting %}Hello!{% endtranslation %}

Consejo

Resalta el texto que deseas traducir y usa el atajo de teclado Cmd + Alt + L (macOS) o Ctrl + Alt + L (Windows) para envolverlo en etiquetas de traducción.

Este atajo funciona en todos los canales que admiten mensajería multilingüe, excepto en los editores de arrastrar y soltar para correo electrónico y Content Blocks. Para esos, usa el botón Agregar personalización para añadir etiquetas de traducción.

Localizar URLs

Al traducir contenido, las URLs requieren un manejo especial para evitar enlaces rotos.

URLs estándar (estáticas)

Las URLs estáticas se introducen manualmente en el editor (por ejemplo, https://example.com). También recomendamos lo siguiente:

Una URL estándar que sigue ambas recomendaciones es:

1
<a href="https://{% translation id_1 %}example.shop.com{% endtranslation %}">Visit our store</a>

URLs generadas con Liquid

Si tu URL se genera con Liquid (por ejemplo, {% landing_page_url %}), recomendamos lo siguiente:

Una URL generada con Liquid que sigue ambas recomendaciones es:

1
<a href="{% translation id_1 %}{% landing_page_url xyz %}{% endtranslation %}">View details</a>

Importante

Si estás usando seguimiento de enlaces de correo electrónico (aliasing de enlaces o plantillas de enlaces), se requiere configuración adicional cuando las URLs están envueltas en etiquetas de traducción.

Atributos y estructura HTML

Solo envuelve en etiquetas de traducción el texto legible para humanos. Evita envolver atributos HTML (como class, style o id) u otro código estructural. Los atributos HTML controlan el diseño, el estilo y la funcionalidad. Envolverlos en etiquetas de traducción puede romper el formato o los estilos en las versiones localizadas de tu mensaje.

Este texto está correctamente envuelto:

1
2
3
<p class="headline" style="color: red;">
  {% translation id_1 %}Welcome to our sale{% endtranslation %}
</p>

1
2
3
4
5
{% translation id_1 %}
<p class="headline" style="color: red;">
  Welcome to our sale
</p>
{% endtranslation %}

Paso 3: Agregar locales a tu mensaje

Después de agregar etiquetas de traducción a tu mensaje, selecciona Administrar idiomas en el editor (Idiomas en los editores de arrastrar y soltar para correo electrónico y Content Blocks) y selecciona al menos un locale para el que deseas agregar traducciones.

Content Blocks que contienen traducciones

Si tu mensaje contiene Content Blocks que ya tienen traducciones guardadas, no necesitas volver a subir esas traducciones. Las traducciones guardadas se aplican automáticamente cuando el Content Block se agrega a tu mensaje.

En el modal Administrar idiomas, los Content Blocks con traducciones guardadas aparecen en la lista, junto con los locales que admiten. Esto te permite ver qué partes de tu mensaje ya están localizadas antes de agregar nuevas traducciones.

Importante

Asegúrate de que cada Content Block incluya traducciones para cada locale agregado a tu mensaje. Si a un Content Block le faltan traducciones para uno de los locales que agregaste, se mostrará en su idioma original para los usuarios en ese locale.

Paso 4: Agregar traducciones

Después de seleccionar los locales, agrega traducciones a tu mensaje usando uno de los siguientes métodos:

• subir plantilla csv
• usar la api de traducción

Selecciona Descargar plantilla para descargar un CSV que contiene una matriz de los ID de traducción y locales seleccionados.

Importante

Para evitar problemas de visualización con caracteres no ingleses, evita usar Excel para tu CSV de traducción.

Cuando completes la plantilla, traduce solo el contenido de texto para cada locale. Si hay etiquetas HTML presentes en la plantilla descargada, déjalas sin modificar y traduce solo el texto dentro de las etiquetas.

Por ejemplo, si la plantilla contiene:

1
<p style="margin:0;margin-bottom:0">A charming bakery dedicated to crafting artisanal breads.</p>

Solo traduce el texto A charming bakery dedicated to crafting artisanal breads. y mantén las etiquetas HTML <p style="margin:0;margin-bottom:0"> y </p> tal como están.

Luego, sube el archivo completado y las traducciones se aplicarán a tu mensaje.

Usa una API de traducción de un partner para administrar y actualizar traducciones en tus Campaigns, Canvas, Content Blocks, plantillas de correo electrónico y plantillas de webhook. Esto es útil si usas un sistema externo para la localización o deseas conectarte directamente con un partner de traducción.

Para usar los endpoints de traducciones con Canvas, incluye los siguientes parámetros:

• workflow_id
• step_id
• message_variation_id

Nota

Al usar la API de traducción con pasos en Canvas que se crearon después de que Canvas se lanzó, el message_variation_id que pases a la API estará vacío o en blanco.

Paso 5: Previsualizar traducciones

Para previsualizar tu mensaje, selecciona la opción Usuario multilingüe en el menú desplegable Previsualizar como usuario. Esto te permite alternar entre diferentes definiciones de locale para previsualizar todas las traducciones de tu mensaje.

Gestionar traducciones

Duplicar pasos en Canvas o Campaigns, y traducciones

Cuando duplicas un paso en Canvas, una Campaign o una variante, las traducciones se incluyen. Esto también aplica al copiar entre espacios de trabajo, siempre que los idiomas estén definidos en ese espacio de trabajo de destino. Asegúrate de revisar y actualizar las traducciones de forma correspondiente al hacer modificaciones en tu Canvas o Campaign.

Guardar traducciones en Content Blocks

Los Content Blocks admiten el multiidioma de la misma forma que los mensajes. Al crear o editar Content Blocks, puedes etiquetar contenido para traducción, añadir idiomas y subir traducciones usando un CSV o la API de traducciones.

Las traducciones guardadas permanecen asociadas al Content Block. Cuando el bloque se añade a un mensaje, sus traducciones se incluyen automáticamente.

Mensajes de derecha a izquierda

Al completar el archivo de traducción para idiomas que se escriben de derecha a izquierda (como el árabe), envuelve la traducción con span para que se formatee correctamente:

1
{% translation your_id_here %}<span dir='rtl'>default text</span>{% endtranslation %}

Seguimiento de enlaces en correo electrónico

En las Campaigns de correo electrónico, Braze realiza el seguimiento de enlaces añadiendo información de seguimiento (parámetros de consulta) a cada URL. Este comportamiento admite tanto el aliasing de enlaces como las plantillas de enlaces.

Cuando una URL está envuelta en etiquetas de traducción, es posible que Braze no pueda determinar dónde añadir esta información de seguimiento. Para asegurar que esto funcione correctamente, debes incluir un carácter especial al final de la URL para indicar dónde debe añadirse el seguimiento.

Las URLs usan dos caracteres especiales para controlar cómo funciona esto:

• ? añade seguimiento a una URL que aún no lo tiene.
• & añade seguimiento adicional si ya existe un ? en la URL. Una URL solo puede contener un ?.

Configuración de idioma y accesibilidad

Comienza con Idioma de accesibilidad en Accesibilidad para contexto WCAG, comportamiento de canales y editores (incluidas las páginas de destino) y configuración de Accesibilidad a nivel de mensaje.

Cuando usas mensajes multiidioma, alinea el idioma de accesibilidad con cada idioma para que los envíos localizados declaren el idioma apropiado.

Configurar el idioma de accesibilidad

Puedes establecer el idioma de accesibilidad en dos niveles:

Nivel de mensaje

A nivel de mensaje, establece el idioma de accesibilidad en la sección Accesibilidad de la configuración de tu mensaje. Para seleccionar un idioma, usar Liquid y conocer las limitaciones por canal, consulta Idioma de accesibilidad.

Nivel de idioma

Para mensajes multiidioma, establece el idioma de accesibilidad para cada idioma en Configuración de localización. Puedes usar {{accessibility_language}} en la sección Accesibilidad para que el idioma del documento o la tarjeta se corresponda con esos valores de idioma.

Si ese token aparece de forma predeterminada para los nuevos mensajes depende del canal y el editor. Por ejemplo, los In-App Messages y los Banners se comportan de manera diferente a las páginas de destino y los correos electrónicos de arrastrar y soltar. Consulta Idioma de accesibilidad para más detalles.

Preguntas frecuentes

¿Cuáles son los límites para las etiquetas de traducción?

Al utilizar etiquetas de traducción, se aplican los siguientes límites:

• Cada mensaje puede tener hasta 200 etiquetas de traducción.
• Cada texto predeterminado (el contenido entre etiquetas de traducción) puede tener hasta 2.000 caracteres.
• Las traducciones por configuración regional pueden tener hasta 409.600 bytes (aproximadamente 409,6 KB).

¿Por qué recibo un error al descargar plantillas de correo electrónico multilingüe?

Si encuentras errores al descargar plantillas de correo electrónico multilingüe, es posible que las etiquetas de traducción estén envolviendo atributos HTML o estilos CSS que entran en conflicto con la forma en que Braze procesa los cuerpos del correo electrónico.

Braze trata el cuerpo HTML y el cuerpo de texto plano como componentes separados del mismo mensaje. Cuando las etiquetas de traducción incluyen referencias href y estilos CSS, esto puede generar etiquetas en conflicto que impiden que la plantilla se descargue correctamente.

Para resolverlo:

• Excluye las referencias href y los estilos CSS de las etiquetas de traducción.
• Envuelve solo el contenido de texto legible por humanos en etiquetas de traducción, como se describe en Atributos y estructura HTML.
• Para las URL, sigue la guía en Localizar URL.

¿Puedo hacer un cambio en la copia traducida en una de mis configuraciones regionales?

Sí. Primero, realiza la edición en el CSV y luego carga el archivo de nuevo para hacer un cambio en la copia traducida.

¿Braze proporciona traducciones?

No. Debes proporcionar tus propias traducciones ya sea cargando un CSV o utilizando la API de traducción.

¿Puedo anidar etiquetas de traducción?

No.

¿Puedo envolver mensajes HTML completos en una etiqueta de traducción?

No. Como práctica recomendada, solo debes envolver texto legible por humanos o contenido que deba localizarse. Esto ayuda a evitar problemas con el formato, los enlaces u otros elementos que no son texto.

Además, considera envolver fragmentos de texto más pequeños y semánticamente relacionados para crear traducciones precisas y evitar limitaciones de rendimiento o tamaño.

¿Puedo hacer un cambio en la copia traducida en una de mis configuraciones regionales?

Sí. Si usas un CSV, primero realiza la edición en el archivo y luego cárgalo de nuevo para hacer un cambio en la copia traducida. Si usas la API de traducción, utiliza los endpoints de actualización para realizar cambios.

¿Qué validaciones o comprobaciones adicionales realiza Braze?