Metadatos

Los metadatos son tus propios datos de referencia sobre un producto, guardados como simples pares clave/valor — por ejemplo SKU: ABC-123, Supplier: Acme, Season: SS26. Es información que tú aportas y controlas; Semantico nunca la genera ni la modifica. Úsalos para llevar junto a cada producto los campos que tu negocio ya gestiona.

Un punto clave: las claves de metadatos se comparten en todo tu espacio de trabajo. La primera vez que usas una clave como Supplier en cualquier producto, esa clave pasa a estar disponible en todo tu catálogo. Así, los mismos datos de producto se guardan bajo un conjunto de claves coherente y reutilizable, en lugar de etiquetas improvisadas.

En qué se diferencian los metadatos de todo lo demás

Es fácil confundir los metadatos con otros conceptos del catálogo, así que esta es la diferencia:

Metadatos — datos clave/valor en bruto tuyos sobre un producto. Nunca los genera la IA.
Secciones (atributos personalizados) — contenido que Semantico genera con IA a partir de un prompt.
Categorías / Taxonomías — una clasificación controlada (un árbol, o una lista de opciones reutilizable). Consulta Categorías y listas y Taxonomías.
Listas — agrupaciones de productos para un flujo de trabajo o una exportación.

Si ves la palabra “Atributos” en el dashboard, es solo otro nombre para tus claves de metadatos — agrupar atributos es una forma de organizar esas mismas claves.

Añadir metadatos

Hay varias formas de añadir metadatos, según el volumen:

En un solo producto — abre un producto y usa la tarjeta Metadatos para añadir filas clave/valor (Añadir metadatos).
De forma masiva con importación por CSV — cualquier columna de tu CSV que no sea un campo de producto reconocido (como sku, name, brand, category_path, product_lists…) se importa como clave de metadatos. Es la forma más rápida de cargar tus datos existentes — pon a las columnas el nombre con el que quieres que aparezcan las claves.
Mediante la API — envía un objeto metadata al crear o actualizar un producto. Consulta la API de productos.

Gestionar las claves

La página Metadatos (en la navegación del dashboard) gestiona las claves en sí en todo tu espacio de trabajo — no los valores de cada producto. Desde ahí puedes:

Renombrar una clave y definir su orden de visualización.
Ver qué productos usan una clave.
Fusionar claves — consolidar los valores de varias claves en una sola. Útil para limpiar duplicados como supplier y Supplier. La fusión es permanente.
Eliminar una clave.
Marcar una clave como por idioma cuando su valor deba ser distinto en cada idioma (ver más abajo).

Metadatos por idioma

La mayoría de los metadatos (un SKU, un código de proveedor) son iguales en todos los idiomas. Para esos, deja la clave con un único valor compartido.

Cuando un valor realmente cambia según el idioma, marca la clave como por idioma — así guarda un valor distinto para cada idioma, igual que el contenido traducido. Importar un valor específico de un idioma para una clave la convierte automáticamente en una clave por idioma, así que usa esta opción solo cuando de verdad necesites valores por idioma.

Para qué se usan los metadatos

Los metadatos no son solo almacenamiento — alimentan varias partes de la plataforma:

Filtrar tu catálogo — filtra productos por una clave y un valor de metadatos para encontrar o segmentar productos (por ejemplo, todo lo de un proveedor o una temporada concretos).
Exportaciones — cada clave puede aparecer como su propia columna en las exportaciones. Para cada clave puedes definir:
- si se incluye en la exportación por defecto,
- la cabecera de columna que se usará (su etiqueta de exportación; si no hay, se usa el nombre de la clave),
- y su orden entre tus columnas.
Publicar en tu tienda — en el mapeo de campos de una integración con tu tienda, una clave de metadatos puede ser el origen de un campo de la tienda (por ejemplo, enviar Supplier a un metafield de Shopify o a una característica de PrestaShop), y también puede traerse de vuelta desde la tienda.
Prompts de IA — el prompt de una sección personalizada puede hacer referencia a un valor de metadatos con un marcador {{ metadata:KEY }}, para que el contenido generado incorpore tus propios datos. Ten en cuenta que la IA no lee tus metadatos automáticamente — solo las claves a las que haces referencia de forma explícita en un prompt.

Buenas prácticas recomendadas

Estandariza los nombres de las claves. Las claves son comunes a todo el espacio de trabajo y se comparan de forma exacta, así que decide desde el principio una convención (mayúsculas, ortografía). Supplier y supplier son dos claves distintas. Usa la opción de fusionar de la página Metadatos para limpiar las que se hayan desviado.
Importa de forma masiva con columnas bien nombradas. Como las columnas desconocidas del CSV se convierten en claves, las cabeceras de tu CSV definen en la práctica tu esquema de metadatos — ponles nombre con cuidado.
Elige bien qué exportas. Desactiva la exportación de las claves de uso interno y define etiquetas de exportación claras y un orden para las que van a partners o canales.
Mantén los valores simples. Los valores de metadatos se guardan como texto — un valor por clave (por idioma). Están pensados para datos de referencia, no para objetos estructurados o anidados.
Usa las claves por idioma con moderación — solo cuando un valor cambie realmente según el idioma.
SKU tiene un significado especial. Si defines un valor de metadatos SKU (o sku) en un producto que aún no tiene SKU, Semantico lo usa como SKU del producto. Mantenlo coherente con tus SKU reales.
Deja un momento para la propagación. Tras una importación masiva, los metadatos recién añadidos pueden tardar un poco en aparecer en las exportaciones y los filtros mientras se procesan.