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 idiomas

Paso 1: Configurar idiomas

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

Paso 2: Marcar contenido para traducción

Envuelve el texto que quieres 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 %}. Si el mensaje incluye Content Blocks, consulta Content Blocks que contienen traducción para saber cómo se aplica la unicidad.

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 con 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 Añadir personalización para agregar etiquetas de traducción.

Localizar URL

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

URL estándar (estáticas)

Las URL 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>

URL 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 URL están envueltas en etiquetas de traducción.

Atributos y estructura HTML

Solo envuelve texto legible para humanos en etiquetas de traducción. 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: Añadir idiomas a tu mensaje

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

Content Blocks que contienen traducción

Los Content Blocks con etiquetas de traducción se comportan de forma diferente dependiendo de si el bloque tiene sus propias traducciones guardadas:

Content Blocks con traducciones guardadas

Si tu mensaje contiene Content Blocks que ya tienen traducciones guardadas, no necesitas volver a cargar esas traducciones. Las traducciones guardadas se aplican automáticamente cuando el Content Block se añade a tu mensaje. Esos bloques mantienen sus propios ID de etiqueta, que no necesitan ser únicos respecto al mensaje principal. Para saber cómo guardar traducciones en el propio bloque, consulta Guardar traducciones en Content Blocks.

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

Importante

Asegúrate de que cada Content Block incluya traducciones para cada idioma añadido a tu mensaje. Si un Content Block no tiene traducciones para uno de los idiomas que añadiste, se mostrará en su idioma original para los usuarios de ese idioma.

Content Blocks solo con etiquetas de traducción

Cuando un Content Block tiene etiquetas de traducción pero no tiene idiomas ni traducciones guardadas, sus etiquetas se tratan como contenido fuente sin traducir en el mensaje principal. La exportación de Gestionar idiomas del mensaje principal incluye esas etiquetas, y el CSV del mensaje principal debe proporcionar sus traducciones. Esas etiquetas deben ser únicas respecto a otras etiquetas del mensaje principal.

Si reutilizas un Content Block sin traducir en otro mensaje, ese segundo mensaje también debe proporcionar traducciones para las etiquetas del bloque. Para evitar proporcionar traducciones en cada mensaje que use un Content Block, añade idiomas y traducciones directamente al propio Content Block.

Paso 4: Añadir traducciones

Después de seleccionar los idiomas, añade traducciones a tu mensaje usando uno de los siguientes métodos:

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

Selecciona Descargar plantilla para descargar un CSV que contiene una matriz de tus ID de traducción seleccionados e idiomas.

Importante

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

Al completar la plantilla, traduce solo el contenido de texto para cada idioma. Si hay etiquetas HTML presentes en la plantilla descargada, déjalas sin cambios 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, carga el archivo completado y las traducciones se aplicarán a tu mensaje.

Usa la API de traducción de un partner para gestionar 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 localización o deseas conectarte directamente con un partner de traducción.

Para usar los endpoints de traducción con Canvas, incluye los siguientes parámetros:

• workflow_id
• step_id
• message_variation_id

Nota

Cuando uses la API de traducción con pasos en Canvas que fueron creados después de que Canvas se lanzara, 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 del menú desplegable Previsualizar como usuario. Esto te permite alternar entre diferentes definiciones de idiomas 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 locales estén definidos en ese espacio de trabajo de destino. Asegúrate de revisar y actualizar las traducciones según corresponda cuando hagas modificaciones en tu Canvas o Campaign.

Guardar traducciones en Content Blocks

Los Content Blocks admiten multilenguaje de la misma manera que los mensajes. Al crear o editar Content Blocks, puedes etiquetar contenido para traducción, agregar locales y cargar traducciones usando un CSV o la API de traducciones.

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

Mensajes de derecha a izquierda

Cuando completes 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 tenga el formato adecuado:

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 rastrea los enlaces agregando 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 agregar 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 agregarse el seguimiento.

Las URL utilizan dos caracteres especiales para controlar cómo funciona esto:

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

Configuración de idioma y accesibilidad

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

Cuando uses mensajes multilenguaje, alinea el idioma de accesibilidad con cada locale 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 las limitaciones por canal, consulta Idioma de accesibilidad.

Nivel de locale

Para mensajes multilenguaje, establece el idioma de accesibilidad para cada locale 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 locale.

Que ese token aparezca de forma predeterminada para mensajes nuevos depende del canal y el editor. Por ejemplo, los mensajes dentro de la aplicación 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 2000 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 de los correos electrónicos.

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 resolver esto:

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

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

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

¿Braze proporciona traducciones?

No. Debes proporcionar tus propias traducciones ya sea subiendo un CSV o usando 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 necesite ser localizado. Esto ayuda a prevenir problemas de formato, enlaces u otros elementos que no son texto.

Además, considera envolver piezas de texto más pequeñas y semánticamente relacionadas 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 haz la edición en el archivo y luego súbelo de nuevo para hacer un cambio en la copia traducida. Si usas la API de traducción, utiliza los endpoints de actualización para hacer cambios.

¿Qué validaciones o comprobaciones adicionales realiza Braze?