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.
Ejemplos
Los ejemplos comunes de catálogos incluyen:
- Productos
- Servicios
- Comida
- 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 las propiedades del evento 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 CSV | Disponible mediante API y CDI |
|---|---|---|---|
| Cadena | Una secuencia de caracteres. | ✅ Sí | ✅ Sí |
| Número | Un valor numérico, ya sea entero o decimal. | ✅ Sí | ✅ Sí |
| Booleano | Un valor true o false. |
✅ Sí | ✅ Sí |
| Hora | Una cadena con formato ISO 8601. | ✅ Sí | ✅ Sí |
| Geolocalización | Una matriz de coordenadas [longitude, latitude]. La latitud debe estar entre -90 y 90; la longitud debe estar entre -180 y 180. Por ejemplo, [-73.988103, 40.779109]. |
✅ 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 y selecciona Crear nuevo catálogo. A continuación, elige una de las siguientes opciones:
Paso 1: Revisa tu archivo CSV
Antes de subir tu archivo CSV, asegúrate de que cumple los siguientes requisitos:
| Requisito del CSV | Detalles |
|---|---|
| Encabezados | La primera columna del archivo CSV debe llamarse id, y cada fila debe tener un valor de id único. |
| Columnas | Un archivo CSV puede tener un máximo de 1.000 campos (columnas), y cada nombre de columna puede tener hasta 250 caracteres. |
| Tamaño del archivo | Para los planes gratuitos, el tamaño total de todos los archivos CSV en una empresa está limitado a 500 MB. Para los planes Pro, el tamaño máximo de un único archivo CSV es de 2 GB. |
| Valores de campo | Cada celda (valor de campo) puede contener hasta 5.000 caracteres. |
| Caracteres válidos | La columna id y todos los valores de encabezado solo pueden contener letras, números, guiones y guiones bajos. |
| Tipos de datos | Los tipos de datos compatibles con las subidas de CSV incluyen cadena, número, booleano, hora y geolocalización. Para la lista completa de tipos de datos, incluidos los disponibles solo 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 sube el archivo CSV con 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 cómo mejorar tus catálogos.
Paso 2: Subir el CSV
Arrastra y suelta tu archivo en la zona de carga, o selecciona Subir CSV y elige tu archivo.
Selecciona un tipo de datos para cada columna.
Este tipo de datos no se puede editar una vez que hayas configurado tu 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
- Máximo de 250 caracteres
- Solo puede incluir números, letras, guiones y guiones bajos
También puedes usar 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 Campaign.
Selecciona Procesar catálogo para crear el catálogo.
Tutorial: Crear un catálogo a partir de un archivo CSV
Para este tutorial, usamos un catálogo que lista dos juegos, su precio 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 subiendo un archivo CSV. Los tipos de datos para id, title, price e image_link son cadena, cadena, número y cadena, respectivamente.
Este tipo de datos no se puede editar una vez que hayas configurado tu catálogo.
A continuación, nombraremos este catálogo “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 subir una versión actualizada con el mismo nombre de catálogo.
Después de crear el catálogo, puedes comenzar a hacer referencia al catálogo en una Campaign.
Los archivos CSV subidos anteriormente están disponibles para descargar desde la página de Catálogos durante 30 días a partir de la fecha de carga. Después de 30 días, el archivo se elimina permanentemente y ya no se puede acceder a él.
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
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
- Máximo de 250 caracteres
- Solo puede incluir números, letras, guiones y guiones bajos
También puedes usar 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 Campaign.
Paso 2: Crea tu catálogo
Selecciona tu catálogo de la lista y luego selecciona Actualizar catálogo > Añadir campos. Introduce el nombre del campo y usa el desplegable para seleccionar el tipo de datos. Repite según sea necesario.
Selecciona Actualizar catálogo > Añadir elementos para añadir un elemento a tu catálogo introduciendo la información basada en los campos que añadiste previamente. Luego, selecciona Guardar elemento o Guardar y añadir otro para seguir añadiendo elementos.
Braze procesa los valores de hora basándose en la marca de tiempo del panel. Por ejemplo, si una columna tiene un valor de “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 de los catálogos
Los catálogos admiten varios tipos de datos para ayudarte a organizar y estructurar tus datos de forma eficaz. La siguiente tabla describe cada tipo de dato admitido y cómo se relaciona con los nombres de tipo en CSV y API:
| Tipo de datos | Formato | Ejemplo | Descripción |
|---|---|---|---|
| String | 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. |
| Time | 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 importaciones CSV. |
| Boolean | true o false |
true |
Valores lógicos que representan estados verdadero o falso. Equivalente al tipo boolean en importaciones CSV y API. |
| Number | Entero o decimal | 42 o 19.99 |
Valores numéricos que incluyen enteros y números de coma flotante para precios, cantidades, calificaciones y más. Equivalente a los tipos integer y float en importaciones CSV y al tipo number en la API. |
| Geolocation | Matriz [longitud, latitud] |
[-73.988103, 40.779109] |
Un par de coordenadas que representa una ubicación geográfica. La longitud debe estar entre -180 y 180; la latitud debe estar entre -90 y 90. El valor de type en la API es geo. Se puede añadir a través del cajón Añadir campos en la interfaz de catálogos, la carga de CSV o la REST API. |
| Object | Objeto JSON | {"key": "value", "price": 10} |
Estructuras de datos anidadas complejas. El valor de type en la API es object. Se muestra como objeto JSON en el panel. Solo disponible a través de la API o la ingesta de datos en la nube (CDI). |
| Array | Matriz de cadenas | ["red", "blue", "green"] |
Listas de valores de cadena. El valor de type en la API es array. Se muestra como matriz de cadenas en el panel. 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 }}
Gestión de catálogos
En el panel
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 luego selecciona si deseas actualizar, añadir o eliminar elementos en tu catálogo.
Uso de la REST API
A medida que crees más catálogos, también puedes usar el endpoint Listar catálogos para devolver una lista de los catálogos en un espacio de trabajo.
La REST API es compatible con todos los tipos de datos de catálogo, incluidos objetos JSON y matrices de cadenas. Los objetos JSON y las matrices de cadenas solo se pueden crear o actualizar a través de la REST API.
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 artículos del catálogo
Además de gestionar tus catálogos, también puedes usar endpoints asíncronos y síncronos para gestionar los artículos del catálogo. Esto incluye la capacidad de editar y eliminar artículos del catálogo, así como listar los detalles de los artículos del catálogo.
Por ejemplo, si quieres editar un artículo individual del catálogo, puedes usar el endpoint /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 500 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 500 MB. Puedes tener un número ilimitado de elementos, siempre que no superen los 500 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 (500 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 artículo | Hasta 5000 caracteres en un solo valor. Por ejemplo, si tienes un campo etiquetado como description, el número máximo de caracteres dentro del campo es 5000. |
| Caracteres del nombre de columna de un artículo | Hasta 250 caracteres |
| Selecciones por catálogo | Hasta 30 selecciones por catálogo |
Las etiquetas de Liquid de catálogos no se pueden usar de forma recursiva, lo que significa que no puedes hacer referencia a un artículo de catálogo que luego llame a un segundo artículo de catálogo dentro de la misma evaluación de Liquid.