Skip to content

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

Para conocer los tipos de datos de catálogo compatibles, sus descripciones, cómo se pueden crear o actualizar (CSV vs API y CDI), y su formato y ejemplos, consulta Tipos de datos.

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:

Paso 2: Cargar CSV

Arrastra y suelta tu archivo en la zona de carga, o selecciona Upload CSV y elige tu archivo.

Selecciona un tipo de datos para cada columna.

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

Un catálogo llamado "my_catalog".

Selecciona Process Catalog para crear el catálogo.

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.

Cuatro nombres de columnas del catálogo: "id", "title", "price", "image_link".

A continuación, daremos a este catálogo el nombre “games_catalog” y seleccionaremos el botón Process Catalog. Braze comprobará si hay errores en el catálogo antes de crearlo.

Un catálogo llamado "games_catalog".

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:

  • View Catalogs
  • Edit Catalogs
  • Export Catalogs
  • Delete Catalogs

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

Un catálogo llamado "my_catalog".

Paso 2: Crea tu catálogo

Selecciona tu catálogo de la lista y, a continuación, selecciona Update Catalog > Add fields. Introduce el Field name y utiliza el menú desplegable para seleccionar el tipo de datos. Repite la operación según sea necesario.

Dos campos de ejemplo "rating" y "name".

Selecciona Update Catalog > Add items 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 Save Item o Save and Add Another para seguir añadiendo tus elementos.

Añade un elemento del catálogo.

Para conocer los tipos de datos de catálogo con formato y ejemplos, consulta Tipos de datos.

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 Update Catalog > Upload CSV y, a continuación, selecciona si deseas actualizar, añadir o eliminar elementos de tu catálogo.

Uso de la REST API

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 REST API admite todos los tipos de datos de 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 REST API.

Uso de la Ingesta de datos de Cloud

Puedes mantener catálogos a través de la Ingesta de datos de Cloud 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.

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.
New Stuff!