Cómo controlar qué metacampos de producto puede usar Shoply

How to Blacklist Product Metafields

Tu Asistente de Compras con IA está diseñado para ayudar a los clientes leyendo la información de tus productos, respondiendo preguntas y haciendo recomendaciones.

Sin embargo, no todos los datos del producto están destinados a los clientes. Algunos metacampos de producto  pueden incluir información interna (como el margen de beneficio), detalles de proveedores u otros atributos que deben permanecer privados. En estos casos, puede que prefieras que Shoply no use esos metacampos al responder preguntas de los clientes.

Shoply usa IA para determinar automáticamente qué metacampos se pueden usar al responder preguntas de los clientes. Sin embargo, para darte control total, Shoply te permite establecer una lista negra (excluir) de metacampos de producto específicos o de espacios de nombres completos de metacampos.

Esta guía explica por qué esto es útil y cómo configurarlo.

¿Dónde encontrar la Configuración avanzada?

Ve a la sección “Settings” de la consola de administración de la app y, a continuación, desplázate hacia abajo hasta la sección “Advanced Settings”. En esta sección, puedes proporcionar un objeto JSON  para configurar varios ajustes.

Para conocer la política de datos más amplia, revisa qué información puede usar Shoply.

Settings → Advanced Settings is the editor used for the configuration below. The screenshot shows the demo store’s existing configuration; use the keys explained in this guide.
Settings → Advanced Settings is the editor used for the configuration below. The screenshot shows the demo store’s existing configuration; use the keys explained in this guide. Click the screenshot to view it at full size.

Configuración de lista negra

Usa estas configuraciones para evitar que Shoply use metacampos de producto específicos al responder preguntas de los clientes.

Para ocultar un artículo completo en lugar de campos individuales, excluye productos completos de la indexación.

blacklist_product_fields

Una lista de claves exactas de metacampos (nombres de campo) que quieres excluir. El nombre del campo debe coincidir exactamente con la clave del metacampo tal como aparece dentro de Shopify.

Ejemplos de claves de metacampos:

  • start_date
  • product_type
  • backstock_number
  • upc
  • shipping_lead_time
  • brand

Nota: si no quieres mostrar el proveedor del producto, debes añadir “brand” a la lista negra, ya que Shoply usa el metacampo brand para almacenar información del proveedor por razones heredadas.

blacklist_display_filters

Una lista de claves exactas de metacampos para ocultar solo en la interfaz de filtros/facetas. A diferencia de blacklist_product_fields, estos campos siguen estando disponibles para la IA para responder preguntas de los clientes; simplemente no se muestran como filtros seleccionables en la interfaz de búsqueda.

Para obtener contexto sobre qué atributos aparecen, consulta cómo Shoply genera filtros de productos.

Esto es útil cuando un metacampo contiene información valiosa del producto que la IA debería conocer, pero no tiene sentido como filtro orientado al cliente.

Ejemplo:

  • warehouse_region — contexto útil para la IA, pero no un filtro útil para los clientes
  • care_instructions — bueno para respuestas de IA, pero no una categoría de filtro significativa

blacklist_namespaces

Una lista de espacios de nombres  completos que quieres que la IA ignore.

Ejemplo:

  • RenterInfo

Si un metacampo pertenece a un espacio de nombres incluido en la lista negra, todos los campos de ese espacio de nombres se excluyen automáticamente.

Esto es útil cuando un espacio de nombres completo es interno o sensible.

Consejos para usar la lista negra

Recomendado incluir en la lista negra:

  • Códigos de proveedor
  • Detalles de almacén / inventario
  • Notas internas de cumplimiento
  • Metacampos usados por otras apps
  • Cualquier campo que no deba ser visible para los clientes

Evita incluir en la lista negra campos como:

  • Título del producto
  • Descripción
  • Material
  • Talla, dimensiones o especificaciones
  • Ingredientes
  • Instrucciones de cuidado
  • Nombres/opciones de variantes

(Estos ayudan a la IA a dar mejores respuestas).

Enriquecer datos de producto a partir de etiquetas

split_tag_to_metafield_by

Las etiquetas de Shopify son una forma práctica de etiquetar productos, pero se almacenan como una lista plana de cadenas y no se pueden usar como filtros estructurados. Esta configuración te permite convertir etiquetas con formato key:value en metacampos adecuados que Shoply puede indexar y usar para filtrar.

Cómo funciona:

Establece split_tag_to_metafield_by con el carácter delimitador usado en tus etiquetas. Shoply dividirá cada etiqueta por ese carácter, tratará la parte izquierda como la clave del metacampo y la parte derecha como el valor, y las indexará en consecuencia.

Por ejemplo, si tus productos tienen etiquetas como:

plaintext
material:aluminum color:matte-black compatible-with:iPhone 15

Configurar el delimitador en ":" producirá metacampos:

ClaveValor
materialaluminum
colormatte-black
compatible-withiPhone 15

Estos metacampos indexados pueden usarse después como filtros de facetas en Shoply AI Search, igual que los metacampos nativos de Shopify.

Las etiquetas que no contengan el delimitador son ignoradas por esta configuración y permanecen como etiquetas normales.

Ejemplo de configuración:

json
{ "split_tag_to_metafield_by": ":" }

Cuándo usar esto:

  • Tu tienda ya usa etiquetas key:value para atributos (por ejemplo, desde una importación masiva o una app de terceros)
  • Quieres añadir atributos filtrables sin crear definiciones formales de metacampos en Shopify
  • Necesitas una forma rápida de exponer datos estructurados de producto a Shoply sin volver a etiquetar tu catálogo

Controlar la visualización del producto

Usa estas configuraciones para controlar qué información se muestra cuando los productos aparecen en el chat o en la interfaz de búsqueda.

Para cambios visuales en los campos que conserves, puedes personalizar el estilo de la tarjeta de producto con CSS.

hide_discount

Cuando se establece en true, los porcentajes de descuento (por ejemplo, “-40%”) se ocultarán en las visualizaciones de productos. Esto es útil si no quieres enfatizar los descuentos a los clientes.

hide_price

Cuando se establece en true, toda la información de precios se ocultará, incluidos los precios originales y los precios con descuento. Usa esto si prefieres que los clientes visiten la página del producto para ver los precios, o si tu estrategia de precios requiere ocultarlos en la interfaz de chat/búsqueda.

hide_review

Cuando se establece en true, las valoraciones de reseñas no se mostrarán en las visualizaciones de productos. Esto es útil si no quieres que las puntuaciones de reseñas influyan en las decisiones de los clientes en la interfaz de chat/búsqueda.

Ejemplo de un objeto JSON válido

Aquí tienes un ejemplo completamente válido:

json
{ "blacklist_product_fields": [ "profit_margin", "inventory_level" ], "blacklist_display_filters": [ "product_type", "category_name", "warehouse_region", "care_instructions" ], "blacklist_namespaces": [ "SupplierInfo" ], "split_tag_to_metafield_by": ":", "hide_discount": true, "hide_price": false, "hide_review": false }

Puedes eliminar los elementos que no necesites o añadir tus propias claves de metacampos y espacios de nombres. Establece las opciones hide_* en true o false según tus preferencias.