Gestionar contenido localizado con catálogos de Braze

Almacena cadenas localizadas y URL en catálogos para que cada usuario reciba el texto en su idioma desde una única Campaign o Canvas, sin variantes separadas por idioma.

Acerca de este ejemplo

PantsLabyrinth, un comercio minorista de ropa ficticio, vende sus productos en Norteamérica y Europa. Los nombres de productos, precios e imágenes principales varían según el idioma, pero el equipo de marketing quiere una sola plantilla de correo electrónico o push que personalice en el momento del envío.

Este ejemplo cubre tres patrones de catálogo que leen el ${language} atributo estándar del usuario (recopilado por el SDK a partir del idioma del dispositivo):

• Campos de objeto JSON: todos los idiomas en una sola fila por artículo
• Columnas planas por idioma: header_en, header_fr, etc.
• Catálogo separado por idioma: nombre de catálogo dinámico como pantslabyrinth-promo-en

Usa catálogos cuando el contenido localizado sea datos estructurados (productos, promociones, URL de imágenes). Para textos de mensaje de formato libre en correo electrónico o push, prefiere los mensajes multilingües cuando tus canales los soporten. Para comparar patrones de localización de forma más amplia, consulta Gestión de traducciones.

Consideraciones

• Los ejemplos son ilustrativos. Confirma las mayúsculas y el formato de ${language} en tu base de usuarios antes de nombrar claves o sufijos de catálogo.
• Para los métodos 1 y 2, si ${language} está vacío o no coincide con una clave o campo del catálogo, el resultado localizado puede quedar vacío; verifica cada campo de forma independiente y recurre a un valor predeterminado (por ejemplo, inglés).
• Para el método 3, define una lista de códigos de idioma admitidos antes de construir el nombre del catálogo; un catálogo inexistente cancela el mensaje.
• Los objetos JSON en catálogos se pueden crear o actualizar a través de la API o mediante ingesta de datos en la nube (CDI) para catálogos, no mediante carga de CSV.
• El método 2 admite mantenimiento por CSV, pero multiplica las columnas a medida que se agregan idiomas. Los archivos CSV admiten hasta 1000 columnas.
• El método 3 requiere un catálogo para cada código de idioma que llegue a la etiqueta catalog_items. Si el catálogo no existe, Braze cancela el mensaje. Un ID de artículo inexistente en un catálogo existente devuelve un array de artículos vacío.
• Las etiquetas de Liquid de catálogo no se pueden usar de forma recursiva.
• Las selecciones de catálogo admiten hasta 10 filtros y devuelven hasta 50 artículos; valida los filtros contra el esquema de tu catálogo.
• Revisa los niveles de almacenamiento de catálogos si mantienes fuentes de productos grandes con múltiples idiomas.

Configuración

Paso 1: Elige una estructura de catálogo

Elige una estructura de catálogo usando la guía de esta tabla.

Paso 2: Crea el catálogo y los artículos

1. Ve a Configuración de datos > Catálogos y crea un catálogo (o varios catálogos para el método 3).
2. Agrega campos y artículos según la estructura elegida. Consulta Crear un catálogo.
3. (Opcional) Crea una selección de catálogo para filtrar artículos, por ejemplo por category que coincida con un atributo personalizado del usuario.

• método 1: campos json
• método 2: campos planos
• método 3: catálogo por idioma

Paso 3: Agrega Liquid a tu mensaje

Selecciona el patrón de Liquid que corresponda a la estructura de catálogo que elegiste en el paso 1.

• método 1: campos json
• método 2: campos planos
• método 3: catálogo por idioma

Almacena todos los idiomas en campos de objeto JSON en una sola fila de catálogo y luego usa el filtro property_accessor para leer las claves name y price que coincidan con ${language} (normalizado a mayúsculas). Verifica cada campo de forma independiente y recurre a EN cuando ese campo esté vacío, de modo que un idioma con nombre pero sin precio reciba igualmente un precio en inglés.

1
2
3
4
5
6
7
8
9
10
11
12

{% catalog_items PantsLabyrinth_Product_Copy trail-runner-001 %}
{% assign lang = ${language} | upcase %}
{% assign localized_name = items[0].name | property_accessor: lang %}
{% assign localized_price = items[0].price | property_accessor: lang %}
{% if localized_name == blank %}
  {% assign localized_name = items[0].name | property_accessor: 'EN' %}
{% endif %}
{% if localized_price == blank %}
  {% assign localized_price = items[0].price | property_accessor: 'EN' %}
{% endif %}
Product: {{ localized_name }}
Price: {{ localized_price }}

Consulta Filtro property accessor.

Construye nombres de campo dinámicos a partir de ${language} (normalizado a minúsculas) y luego lee esos campos del artículo con búsqueda por corchetes. Por ejemplo, items[0][header_field] lee el encabezado del idioma resuelto. Verifica cada campo de forma independiente y recurre a la columna en inglés cuando ese campo esté vacío, de modo que un idioma con encabezado pero sin cuerpo reciba igualmente el texto del cuerpo en inglés.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

{% catalog_items PantsLabyrinth_Promo_Copy spring-sale %}
{% assign lang = ${language} | downcase %}
{% assign header_field = 'header_' | append: lang %}
{% assign body_field = 'body_' | append: lang %}
{% assign cta_field = 'cta_text_' | append: lang %}
{% assign img_field = 'img_src_' | append: lang %}
{% assign header_val = items[0][header_field] %}
{% assign body_val = items[0][body_field] %}
{% assign cta_val = items[0][cta_field] %}
{% assign img_val = items[0][img_field] %}
{% if header_val == blank %}
  {% assign header_val = items[0].header_en %}
{% endif %}
{% if body_val == blank %}
  {% assign body_val = items[0].body_en %}
{% endif %}
{% if cta_val == blank %}
  {% assign cta_val = items[0].cta_text_en %}
{% endif %}
{% if img_val == blank %}
  {% assign img_val = items[0].img_src_en %}
{% endif %}
<img src="{{ img_val }}" alt="" />
<h2>{{ header_val }}</h2>
<p>{{ body_val }}</p>
<a href="#">{{ cta_val }}</a>

Advertencia

Si el nombre de catálogo que pasas a catalog_items no existe, Braze cancela el mensaje. Define una lista de códigos de idioma admitidos antes de construir el nombre del catálogo. Un ID de artículo inexistente en un catálogo existente devuelve un array de artículos vacío; puedes recurrir al catálogo en inglés solo en ese caso.

Define una lista de los códigos de idioma que tienen catálogos correspondientes (aquí en, fr y de), asigna los valores no admitidos o vacíos a en y luego busca el artículo. Si el ID del artículo no existe en ese catálogo, recurre al catálogo en inglés.

1
2
3
4
5
6
7
8
9
10
11
12

{% assign lang = ${language} | downcase %}
{% assign supported = 'en,fr,de' | split: ',' %}
{% if supported contains lang %}{% else %}{% assign lang = 'en' %}{% endif %}
{% assign theCatalog = 'pantslabyrinth-promo-' | append: lang %}
{% catalog_items {{ theCatalog }} spring-sale %}
{% if items[0] == blank %}
  {% catalog_items pantslabyrinth-promo-en spring-sale %}
{% endif %}
<img src="{{ items[0].img_src }}" alt="" />
<h2>{{ items[0].header }}</h2>
<p>{{ items[0].body }}</p>
<a href="#">{{ items[0].cta_text }}</a>

Consulta Uso de plantillas en nombres de catálogo y Cancelar mensajes.

Selección de catálogo opcional por categoría

Filtra artículos antes de la personalización, por ejemplo promociones de calzado para usuarios con preferred_category = footwear:

1
2
3
4

{% catalog_selection_items PantsLabyrinth_Product_Copy footwear_promos %}
{% for item in items %}
  {{ item.name }}
{% endfor %}

Define la selección en el panel con filtros en tu columna category y atributos del usuario según sea necesario.

Paso 4: Vista previa y pruebas

1. Usa Vista previa como usuario con perfiles de usuario que tengan diferentes valores de ${language}.
2. Confirma el texto alternativo cuando el idioma esté ausente o no sea compatible, incluidos los casos de localización parcial (por ejemplo, un nombre sin precio).
3. Para el método 3, confirma que cada idioma admitido tenga un catálogo correspondiente y que los códigos de idioma no admitidos se asignen a tu catálogo predeterminado sin cancelar el envío.

Artículos relacionados

• Catálogos
• Usar catálogos
• Selecciones
• Crear un catálogo
• Filtros avanzados de Liquid
• Localización
• Mensajes multilingües
• Sincronizar y eliminar datos de catálogo
• Cancelar mensajes de Liquid