Modificadores

Descripción general #

Los modificadores te permiten cambiar los datos de productos después de la sincronización, sin tocar tu feed de datos ni involucrar a un desarrollador. Los modificadores se evalúan de arriba hacia abajo, por lo que el orden en que aparecen en la lista importa.

Hay dos formas de crear un modificador: usando AI Modifiers, que es el enfoque recomendado, o eligiendo uno de los tipos de modificador estándar para transformaciones más simples y predefinidas.

AI Modifiers #

AI Modifiers es la forma predeterminada y recomendada de crear modificadores. En lugar de configurar campos y reglas individuales, simplemente describes lo que quieres que haga el modificador en lenguaje natural y la IA genera una función en Python que transforma tus datos de producto según lo indicado.

Este enfoque es mucho más flexible que los tipos estándar de modificador. Puedes describir lógica compleja, combinar múltiples condiciones, calcular nuevos valores a partir de atributos existentes y gestionar casos límite, todo sin escribir código.

1. Haz clic en Add Modifier y selecciona AI Modifier como el tipo (esto se selecciona por defecto).
2. En el campo de texto, describe lo que debe hacer el modificador. Sé lo más específico posible sobre la lógica, los atributos involucrados y el resultado esperado.
3. La IA genera una función Python basada en tu descripción.
4. Prueba el modificador usando la vista previa Before & After antes de guardar.

Ejemplos de instrucciones:

• “Crea un atributo llamado variant_stock_percentage que muestre cuántas de las variantes de un producto están actualmente en stock, como un porcentaje entre 0 y 100.”
• “Establece availability en In stock si stock es mayor que 0, de lo contrario deja Out of stock.”
• “Crea un atributo discount_percentage calculando la diferencia porcentual entre list_price y price, redondeando al entero más cercano.”

La función Python generada por la IA es de solo lectura, no puedes editarla directamente. Para modificar la lógica, simplemente chatea con la IA a través del campo de texto y deja que actualice la función. Esto asegura que la función siempre coincida con la intención descrita.

Tipos de modificador estándar #

Para transformaciones más sencillas, existen tipos de modificadores estándar. Estos cubren un conjunto de operaciones predefinidas y son fáciles de configurar, pero son más limitados en lo que pueden hacer comparados con AI Modifiers.

Todos los modificadores estándar tienen un campo de entrada if. Si se añade una declaración, el modificador solo se ejecuta en los productos donde esa declaración es verdadera.

Aquí tienes una descripción de cada tipo de modificador estándar.

Crear nuevo atributo #

Toma un new_value que indica qué valor asignar al atributo, puede usarse tanto para un atributo nuevo como para reemplazar uno existente.

Eliminar atributo #

Elimina el atributo dado de todos los productos, o de específicos según una declaración if.

Eliminar producto #

Elimina el(los) producto(s) dado(s) según una declaración if.

Actualizar atributo #

Este modificador usa regex con la librería de Python. Si regex es algo nuevo para ti, considera usar AI Modifiers en su lugar; pueden hacer las mismas transformaciones sin conocimiento de regex.

La actualización toma el atributo regexp que es una expresión regex que coincide con ciertas partes del atributo y reemplaza cada grupo coincidente con el contenido de replace_by. Aquí tienes una herramienta útil para crear tu expresión regex.

Por ejemplo, una regex como []+ con un replace_by de ’/’, tomará todos los lugares en el atributo que tengan varios ’/’ seguidos y los reemplazará por un solo /. Así, https://test//tests pasará a ser https:/test/tests.

Ejemplo #

En este ejemplo, queremos eliminar la última parte de una URL utilizando una expresión regex. La URL de inicio es: https://example.domain/product/153//__example. Para eliminar la parte //__example, podemos usar la siguiente regex: \/\/__example.

Como simplemente queremos eliminar esta parte de la URL sin reemplazarla por nada, el campo Replace by se deja vacío.

Cambiar tipo de atributo #

Permite cambiar los tipos en un atributo. Así que si los datos son un número y necesitas que sea una cadena, puedes usar esto para hacer el cambio de tipo. Los tipos de atributo son: string, int, float y boolean.

Dividir atributo #

Permite dividir una cadena por un separador, en una lista de cadenas. Por defecto, divide por coma si no se da ningún separador.

Ejemplo #

Aquí dividimos un atributo de categorías convirtiéndolo en una lista: "lineman, chute" a ["lineman","chute"].

Añadir valor #

Permite añadir nuevos valores a un atributo de lista existente.

Esto podría ser añadir cadenas adicionales a un atributo tags, o añadir una nueva categoría a un atributo categories.

Evaluar una expresión #

La acción de Expresión evalúa una expresión matemática, la cual puede incluir atributos, constantes y operadores. Así, si defines esta expresión: price * 0.8 el sistema calculará el resultado multiplicando el valor del atributo price por 0.8, aplicando un descuento del 20%.

Ejemplo #

Si en el campo New Value introduces la cadena: price * 0.8 y el precio es 100, entonces el resultado será 80.

Nuevo atributo formateado #

Esta acción crea un atributo nuevo basado en datos existentes, aplicando formato o transformaciones a su valor.

Para hacer referencia a un atributo existente, coloca su nombre entre llaves sin espacios: {attributeName}.

• Copiar un atributo: pon New Value como {MPN}.
• Concatenar texto y atributos: € + {price}.

Si incluyes espacios dentro de las llaves, como { attribute }, el sistema guardará la cadena literal (incluidas las llaves), no el valor del atributo.

Ejemplo #

Puedes combinar atributos, añadir prefijos o sufijos, o cambiar la manera en que aparecen los datos. Por ejemplo, para crear un precio formateado como €100,00, pon New Value como: € + {price}.

Sentencias If #

Si añades cualquier declaración en el campo if, el comando solo se ejecutará en los atributos donde la declaración indicada sea verdadera.

Los operadores disponibles son:

Ejemplo #

Crea un nuevo atributo Availability puesto en Available, If stock > 0.

Crear atributos a partir de listas #

Un uso común es crear un atributo separado basado en los valores de un atributo de lista existente. Por ejemplo, si tienes un atributo tags que contiene valores como Female, Male y Unisex, puedes crear un atributo dedicado gender para usar en facetas de Search.

El operador in comprueba si un valor existe dentro de una lista. La sintaxis es:

"value" in attribute_name

Para crear un atributo gender desde tags, crea varios modificadores en secuencia:

Cada modificador se ejecuta solo cuando su condición es verdadera. El orden importa: si un producto tiene varias etiquetas coincidentes, el último modificador coincidente determina el valor final.

Nota: El valor que estás comprobando debe ir entre comillas (por ejemplo, "Female"), mientras que el nombre del atributo va sin comillas (por ejemplo, tags).

Combinar condiciones #

Puedes combinar varias condiciones usando los operadores and y or.

Coincide con productos donde la marca es Nike Y el stock es mayor que 0:

brand == "Nike" and stock > 0

Coincide con productos donde la categoría contiene zapatos O botas:

"shoes" in categories or "boots" in categories

Coincide con productos con una etiqueta específica Y precio mayor de 100:

"premium" in tags and price > 100

Prueba y guardado #

Antes de hacer clic en Save & Run, que aplica los modificadores a todo tu catálogo, es recomendable probar primero tu nuevo modificador. Puedes hacerlo en la sección See how your modifiers impact your product data.

Aquí puedes seleccionar un producto y ver cómo le afecta el modificador usando la visualización Before & After.

Puedes incluir o excluir modificadores individuales de la vista previa. Utiliza la casilla Include in preview en cada modificador para quitarlo temporalmente del cálculo de la vista previa al probar un producto. Esta selección solo afecta la vista previa y no el modificador en vivo; todos los modificadores se aplicarán al hacer clic en Save & Run.