Crear un catálogo
La creación de un catálogo implica la importación a Braze de un archivo CSV de datos no relativos al usuario. Esto te permite acceder a esa información para enriquecer tus mensajes. Puedes introducir cualquier tipo de datos en un catálogo. Estos datos suelen ser algún tipo de metadatos de tu empresa, como información sobre productos para una empresa de comercio electrónico, o información sobre cursos para un proveedor de educación.
Casos de uso
Los casos de uso habituales de los catálogos incluyen:
- Productos
- Servicios
- Alimentación
- Próximos eventos
- Música
- Paquetes
Una vez importada esta información, puedes empezar a acceder a ella en los mensajes de forma similar a como accedes a los atributos personalizados o a las propiedades del evento personalizado a través de Liquid.
Tipos de datos compatibles
La siguiente tabla enumera los tipos de datos de catálogo compatibles y cómo se pueden crear o actualizar.
| Tipo de datos | Descripción | Disponible mediante carga de CSV | Disponible a través de API y CDI |
|---|---|---|---|
| Cadena | Una secuencia de caracteres. | ✅ Sí | ✅ Sí |
| Número | Un valor numérico, ya sea entero o flotante. | ✅ Sí | ✅ Sí |
| Booleano | Un valor true o false. |
✅ Sí | ✅ Sí |
| Tiempo | Una cadena con formato ISO 8601. | ✅ Sí | ✅ Sí |
| Objeto JSON | Un objeto anidado con pares clave-valor. Se puede mostrar en la plataforma, pero solo se puede crear o actualizar a través de la API o CDI. | ⛔ No | ✅ Sí |
| Matriz de cadenas | Una lista de cadenas. Se puede mostrar en la plataforma, pero solo se puede crear o actualizar a través de la API o CDI. Máximo de 100 elementos. | ⛔ No | ✅ Sí |
Crear un catálogo
Para crear un catálogo, ve a Configuración de datos > Catálogos, selecciona Crear nuevo catálogo y elige una de las siguientes opciones:
Paso 1: Revisa tu archivo CSV
Antes de cargar tu archivo CSV, asegúrate de que cumple los siguientes requisitos:
| Requisitos CSV | Detalles |
|---|---|
| Encabezados | La primera columna del archivo CSV debe llamarse id, y cada fila debe tener un valor id único. |
| Columnas | Un archivo CSV puede tener un máximo de 1000 campos (columnas) y cada nombre de columna puede tener hasta 250 caracteres. |
| Tamaño del archivo | En los planes gratuitos, el tamaño total de todos los archivos CSV de una empresa está limitado a 100 MB. Para los planes Pro, el tamaño máximo de un solo archivo CSV es de 2 GB. |
| Valores de campo | Cada celda (valor de campo) puede contener hasta 5000 caracteres. |
| Caracteres válidos | La columna id y todos los valores del encabezado solo pueden contener letras, números, guiones y guiones bajos. |
| Tipos de datos | Los tipos de datos compatibles para las cargas CSV incluyen cadenas, números, valores booleanos y horas. Para obtener la lista completa de tipos de datos, incluidos los que solo están disponibles a través de la API y CDI, consulta Tipos de datos compatibles. |
| Formato | Formatea todo el texto en minúsculas para mantener la coherencia. |
| Codificación | Guarda y carga el archivo CSV utilizando la codificación UTF-8. |
¿Necesitas más espacio para tus archivos CSV? Ponte en contacto con tu director de cuentas de Braze para obtener más información sobre la actualización de tus catálogos.
Paso 2: Cargar CSV
Arrastra y suelta tu archivo en la zona de carga, o selecciona Cargar CSV y elige tu archivo.
Selecciona un tipo de datos para cada columna.
Este tipo de datos no se puede editar una vez configurado el catálogo. Además, un valor NULL no es compatible con la carga de CSV y se tratará como una cadena.
Introduce un nombre y una descripción opcional para tu catálogo. Ten en cuenta los siguientes requisitos al nombrar tu catálogo:
- Debe ser único
- 250 caracteres como máximo
- Solo puede incluir números, letras, guiones y guiones bajos
También puedes utilizar plantillas en el nombre del catálogo, lo que te permite generar dinámicamente nombres de catálogo basados en variables como el idioma o la campaña.
Selecciona Procesar catálogo para crear el catálogo.
Tu archivo CSV puede ser rechazado si superas tu nivel.
Tutorial: Creación de un catálogo a partir de un archivo CSV
Para este tutorial, vamos a utilizar un catálogo que enumera dos juegos, su coste y un enlace de imagen.
| id | title | price | image_link |
|---|---|---|---|
| 1234 | Tales | 7.49 | https://picsum.photos/200 |
| 1235 | Regeneration | 22.49 | https://picsum.photos/200 |
Crearemos el catálogo cargando un archivo CSV. Los tipos de datos de id, title, price y image_link son cadena, cadena, número y cadena, respectivamente.
Este tipo de datos no se puede editar una vez configurado el catálogo.
A continuación, daremos a este catálogo el nombre “games_catalog” y seleccionaremos el botón Procesar catálogo. Braze comprobará si hay errores en el catálogo antes de crearlo.
Ten en cuenta que no podrás editar este nombre una vez creado el catálogo. Puedes eliminar un catálogo y volver a cargar una versión actualizada utilizando el mismo nombre de catálogo.
Una vez creado el catálogo, puedes empezar a hacer referencia al catálogo en una campaña.
Requisitos previos
Antes de poder editar o crear catálogos en el navegador, necesitas los siguientes permisos de usuario para tu espacio de trabajo:
- Ver catálogos
- Editar catálogos
- Exportar catálogos
- Eliminar catálogos
Braze está pasando a un sistema de permisos de usuario granulares. Si utilizas los permisos heredados, consulta las definiciones en Lista de permisos. El acceso anticipado a los permisos granulares está disponible para determinados clientes. Todos los clientes serán objeto de una migración a los nuevos permisos en marzo de 2026.
Paso 1: Introduce los detalles del catálogo
Introduce un nombre y una descripción opcional para tu catálogo. Ten en cuenta los siguientes requisitos al nombrar tu catálogo:
- Debe ser único
- 250 caracteres como máximo
- Solo puede incluir números, letras, guiones y guiones bajos
También puedes utilizar plantillas en el nombre del catálogo, lo que te permite generar dinámicamente nombres de catálogo basados en variables como el idioma o la campaña.
Paso 2: Crea tu catálogo
Selecciona tu catálogo de la lista y, a continuación, selecciona Actualizar catálogo > Añadir campos. Introduce el Nombre del campo y utiliza el menú desplegable para seleccionar el tipo de datos. Repite la operación según sea necesario.
Selecciona Actualizar catálogo > Añadir elementos para añadir un elemento a tu catálogo introduciendo la información en función de los campos que hayas añadido previamente. A continuación, selecciona Guardar elemento o Guardar y añadir otro para seguir añadiendo tus elementos.
Braze procesa los valores de tiempo basándose en la marca de tiempo del dashboard. Por ejemplo, si una columna tiene el valor “03/13/2024” y tu zona horaria es la zona horaria del Pacífico, esta hora se importaría a Braze como “Mar 12, 2024, 5:00 PM”.
Tipos de datos del catálogo
Los catálogos admiten varios tipos de datos para ayudarte a organizar y estructurar tus datos de manera eficaz. La siguiente tabla describe cada tipo de datos compatible y cómo se mapea a los nombres de tipos CSV y API:
| Tipo de datos | Formato | Ejemplo | Descripción |
|---|---|---|---|
| Cadena | Texto | "Hello World" |
Cualquier secuencia de caracteres utilizada para datos de texto, como nombres, descripciones e ID. Equivalente al tipo string en importaciones CSV y API. |
| Tiempo | ISO 8601 o marca de tiempo unix (segundos) | "2024-03-15T14:30:00Z" |
Valores de fecha y hora con formato ISO 8601 o marca de tiempo unix en segundos. Equivalente al tipo time en la API y al tipo datetime en las importaciones CSV. |
| Booleano | true o false |
true |
Valores lógicos que representan estados verdaderos o falsos. Equivalente al tipo boolean en importaciones CSV y API. |
| Número | Entero o decimal | 42 o 19.99 |
Valores numéricos, incluyendo números enteros y decimales, para precios, cantidades, tasas y mucho más. Equivalente a los tipos integer y float en las importaciones CSV y al tipo number en la API. |
| Objeto | Objeto JSON | {"key": "value", "price": 10} |
Estructuras de datos anidadas complejas. El valor type de la API es object. Se muestra como objeto JSON en el dashboard. Solo disponible a través de API o ingesta de datos en la nube (CDI). |
| Matriz | Matriz de cadenas | ["red", "blue", "green"] |
Listas de valores de cadena. El valor type de la API es array. Se muestra como una matriz de cadenas en el dashboard. Solo disponible a través de la API o CDI. |
Uso de plantillas en los nombres de los catálogos
Al nombrar tu catálogo, también puedes utilizar plantillas en el nombre del catálogo. Esto te permite generar dinámicamente nombres de catálogos basados en variables como el idioma o la campaña. Por ejemplo, puedes utilizar lo siguiente:
1
2
3
4
{% assign language = "content_spanish" %}
{% catalog_items {{language}} fall_campaign %}
{{ items[0].body }}
Administración de catálogos
En el dashboard
Para actualizar tu catálogo después de cargar un archivo CSV o crear un catálogo en el navegador, selecciona Actualizar catálogo > Cargar CSV y, a continuación, selecciona si deseas actualizar, añadir o eliminar elementos de tu catálogo.
Uso de la API REST
A medida que crees más catálogos, también puedes utilizar el punto de conexión Listar catálogos para obtener una lista de los catálogos de un espacio de trabajo.
La API REST admite todos los tipos de datos del catálogo, incluidos los objetos JSON y las matrices de cadenas. Los objetos JSON y las matrices de cadenas solo se pueden crear o actualizar a través de la API REST.
Uso de la ingesta de datos en la nube
Puedes mantener catálogos a través de la ingesta de datos en la nube sincronizando los datos del catálogo directamente desde tu almacén de datos (como Snowflake, Redshift, BigQuery, Databricks, Microsoft Fabric o S3) de forma programada.
Gestión de los elementos del catálogo
Además de gestionar tus catálogos, también puedes utilizar puntos finales asíncronos y síncronos para gestionar los elementos del catálogo. Esto incluye la posibilidad de editar y eliminar elementos del catálogo, y de listar los detalles de los elementos del catálogo.
Por ejemplo, si quieres editar un elemento individual del catálogo, puedes utilizar el punto de conexión /catalogs/catalog_name/items/item_id.
Almacenamiento de catálogos
La versión gratuita de catálogos admite tamaños de archivo CSV de hasta 100 MB para todos los archivos CSV combinados de tu empresa, mientras que la versión Catalogs Pro admite tamaños de archivo CSV de hasta 2 GB para un único archivo CSV.
El derecho a paquete que se muestra en el panel de Braze se redondea a la unidad más próxima por motivos visuales; sin embargo, sigues teniendo derecho a la totalidad del derecho adquirido. Para solicitar una actualización del almacenamiento de catálogos, ponte en contacto con tu director de cuentas de Braze.
Versión gratuita
El tamaño de almacenamiento para la versión gratuita de los catálogos es de hasta 100 MB. Puedes tener un número ilimitado de elementos, siempre que no superen los 100 MB.
Catalogs Pro
A nivel de empresa, el almacenamiento máximo para Catalogs Pro se basa en el tamaño de los datos del catálogo. Las opciones de tamaño de almacenamiento son: 5 GB, 10 GB o 15 GB. Ten en cuenta que el almacenamiento de la versión gratuita (100 MB) está incluido en cada uno de estos planes.
Especificaciones
La siguiente tabla resume las especificaciones de lo que puedes incluir en los catálogos.
| Área | Especificaciones |
|---|---|
| Caracteres del valor de un elemento | Hasta 5000 caracteres en un solo valor. Por ejemplo, si tienes un campo llamado description, el número máximo de caracteres dentro del campo es 5000. |
| Caracteres del nombre de columna de un elemento | Hasta 250 caracteres |
| Selecciones por catálogo | Hasta 30 selecciones por catálogo |
Las etiquetas de Liquid de catálogos no se pueden utilizar de forma recursiva, lo que significa que no puedes hacer referencia a un elemento del catálogo que a su vez llame a un segundo elemento del catálogo dentro de la misma evaluación de Liquid.
Editar esta página en GitHub