Crowdin

Crowdin es una plataforma de gestión de localización impulsada por IA que ayuda a los equipos a automatizar la traducción de su software, aplicaciones y contenido de marketing.

Conecta Crowdin a Braze para gestionar las traducciones de tus campañas y experiencias de Canvas. La sincronización automatizada funciona con traducción automática, Translation Memory y glosarios para que los flujos de trabajo humanos y automatizados se mantengan consistentes.

Esta integración está mantenida por Crowdin.

Sobre la integración

Crowdin ofrece dos aplicaciones para Braze: Braze Campaigns & Canvas y Braze Email Templates. Elige según las características de Braze que necesites localizar. La siguiente tabla las compara.

Elige la aplicación de Crowdin adecuada

Canal o característica	Braze Campaigns & Canvas	Braze Email Templates
Campañas	✅ Compatible	❌ No compatible
Pasos en Canvas	✅ Compatible	❌ No compatible
Plantillas de correo electrónico	❌ No compatible	✅ Compatible
Bloques de contenido	❌ No compatible	✅ Compatible

Requisitos previos

Requisito	Descripción
Cuenta de Crowdin	Se necesita una cuenta en Crowdin.com o una cuenta de Crowdin Enterprise.
Proyecto de Crowdin	Antes de conectar Braze, crea un proyecto de traducción en Crowdin o Crowdin Enterprise.
Clave de API REST de Braze	Una clave de API REST de Braze con permisos para campañas, Canvas, bloques de contenido, atributos personalizados, correo electrónico y plantillas.
Punto de conexión REST de Braze	La URL específica de tu punto de conexión REST de Braze (por ejemplo, https://rest.iad-03.braze.com).
Configuración multilingüe de Braze	Los locales deben estar configurados en tu dashboard de Braze en Configuración > Configuración de localización.

Integración de Braze Campaigns & Canvas

Si localizas contenido dentro de mensajes en vivo, usa la aplicación Braze Campaigns & Canvas para sincronizar las cadenas traducibles de tus borradores de campaña y Canvas con el soporte multilingüe de Braze.

Para un recorrido en video, consulta Integración de Braze Campaigns & Canvas.

Paso 1: Configura los ajustes multilingües en Braze

Antes de conectar Crowdin, añade tus idiomas de destino en Braze.

1. En Braze, ve a Configuración > Configuración de localización.
2. Añade los idiomas que planeas soportar.

3. Anota cada clave de locale (por ejemplo, en-US, fr-FR, es-ES). Usarás estos valores cuando mapees los idiomas en Crowdin.

Paso 2: Configura el proyecto de Braze en Crowdin

1. En tu cuenta de Crowdin Enterprise o Crowdin.com, ve a la Tienda en el menú de la izquierda.
2. Busca Braze Campaigns & Canvas y selecciona Instalar.

3. Selecciona el proyecto (o proyectos) donde quieras usar esta integración.
4. Para abrir la integración, ve a Integraciones > Braze Campaigns & Canvas en tu proyecto.

Conectar Braze a Crowdin

Autoriza la conexión con tus credenciales de API de Braze:

• Clave de API REST de Braze: Créala en Braze en Configuración > APIs e identificadores > Claves de API. Otorga los permisos que necesita esta integración (campañas, Canvas, bloques de contenido y atributos personalizados).
• Punto de conexión REST de Braze: Introduce la URL de tu instancia de Braze (por ejemplo, https://rest.iad-03.braze.com). Para más información, consulta Puntos de conexión de la API REST.

Selecciona Iniciar sesión con Braze Campaigns & Canvas.

Paso 3: Configura el mapeado de idiomas en Crowdin

Después de conectar tu cuenta, mapea cada idioma del proyecto de Crowdin con el locale correspondiente de Braze.

1. En el panel de la integración Braze Campaigns & Canvas, selecciona el ícono de engranaje de Configuración en la esquina superior derecha.

2. Abre la pestaña Configuración general.
3. Introduce las claves de locale. Crowdin lista los idiomas de tu proyecto (por ejemplo, francés, italiano). En cada campo, introduce la clave de locale de Braze correspondiente.
   • Por ejemplo, si Braze usa it para italiano, introduce it junto a italiano en Crowdin.
   • Cada entrada debe coincidir exactamente con la clave de locale de ese locale en la Configuración de localización de Braze.

4. Selecciona Guardar para confirmar el mapeado.

Paso 4: Añade etiquetas de traducción a tu mensaje de Braze

Crowdin lee las mismas etiquetas de traducción Liquid que Braze usa para mensajes multilingües. Añade {% translation your_id_here %} y {% endtranslation %} alrededor de cada fragmento de texto, URL de imagen o URL de enlace que quieras traducir. Cada bloque necesita un id único (por ejemplo, greeting o welcome_header).

Ejemplo:

{% translation greeting %}Hello!{% endtranslation %}

Para HTML, Liquid en enlaces y otros patrones, sigue las mismas reglas que en Traducción de locales (por ejemplo, mantén las etiquetas alrededor de los segmentos más pequeños posibles y envuelve solo las partes específicas del idioma en las URL al localizar enlaces).

Guarda tu mensaje de Braze como Borrador antes de que Crowdin pueda detectar y extraer el contenido.

Paso 5: Gestiona las traducciones en Crowdin

La pantalla de la integración tiene dos lados:

• Lado derecho (Braze): Tus campañas y Canvas.
• Lado izquierdo (Crowdin): Contenido ya sincronizado para traducción.

Sincronizar contenido

1. En el lado de Braze (derecho), selecciona la casilla de la campaña o Canvas que quieras traducir.
2. Selecciona Sincronizar con Crowdin.
3. Cuando la sincronización se complete, el archivo aparecerá en el lado de Crowdin (izquierdo). Los traductores pueden abrir las cadenas en el Editor de Crowdin.

Devolver las traducciones a Braze

1. Cuando las traducciones estén al 100% en Crowdin, vuelve a la pestaña Integraciones.
2. Selecciona el contenido completado en el lado de Crowdin (izquierdo).
3. Selecciona Sincronizar con Braze. Esto envía las cadenas traducidas a las variantes de idioma correspondientes en tu campaña de Braze.

Paso 6: Previsualiza el mensaje como un usuario multilingüe en Braze

Para confirmar la integración:

1. Abre tu campaña en el creador de mensajes de Braze.
2. Ve a la pestaña Prueba.
3. Selecciona Previsualizar mensaje como usuario.
4. Busca un perfil de usuario que tenga un atributo language que coincida con uno de tus locales traducidos.
5. Confirma que el contenido cambia del idioma de origen a la versión traducida.

Integración de Braze Email Templates

Si localizas correo electrónico a nivel de plantilla, usa la aplicación Braze Email Templates para sincronizar el HTML de tu biblioteca de medios de Braze.

Para un recorrido en video, consulta Integración de Braze Email Templates.

Paso 1: Instala la aplicación

1. En tu proyecto de Crowdin, ve a la pestaña Tienda.
2. Busca Braze Email Templates y selecciona Instalar.

3. Selecciona el proyecto (o proyectos) donde quieras usar esta integración.
4. Para abrir la integración, ve a Integraciones > Braze Email Templates en tu proyecto.

Paso 2: Conectar a Braze

Autoriza la conexión con tus credenciales de API de Braze:

1. Clave de API REST de Braze: Otorga permisos de templates.email y content_blocks (lectura y escritura). Crea la clave en Braze en Configuración > APIs e identificadores > Claves de API.

2. Para el punto de conexión REST de Braze, usa la URL específica de tu instancia (por ejemplo, https://rest.iad-03.braze.com).
3. Selecciona Iniciar sesión con Braze Email Templates.

Paso 3: Sincroniza el contenido para traducción

La pantalla de la integración muestra tu biblioteca de Braze:

• Lado derecho (Braze): Plantillas de correo electrónico y bloques de contenido que puedes sincronizar.
• Lado izquierdo (Crowdin): Contenido en traducción.

1. En el lado de Braze (derecho), selecciona la casilla junto a las plantillas o bloques que quieras localizar.
2. Selecciona Sincronizar con Crowdin.
3. Crowdin extrae el código HTML fuente. Los traductores trabajan en el Editor de Crowdin con una vista previa WYSIWYG en vivo para que el diseño se mantenga intacto.

Paso 4: Entrega las plantillas traducidas

Cuando las traducciones alcancen el 100% de completitud:

1. Selecciona los archivos completados en el lado de Crowdin (izquierdo).
2. Selecciona Sincronizar con Braze.
3. Crowdin crea automáticamente versiones localizadas de estos activos en tu biblioteca de medios de Braze (por ejemplo, Template_Name_fr).