Modificadores

Descripción general #

Modifiers es una herramienta potente que te permite cambiar los datos del producto después de la sincronización sin necesidad de que un desarrollador haga cambios en el data-feed. Los Modifiers se evalúan de arriba a abajo, por lo que el orden en el que aparecen en la lista sí importa.

Tienes diferentes tipos de modifiers, aquí está la lista completa:

Todos los comandos tienen un campo de entrada if. El if puede añadirse a cualquier cosa con una expresión, y el comando solo se ejecutará en el atributo si la expresión se evalúa como verdadera.

Comandos #

Aquí tienes cada uno de los comandos con un ejemplo. Todos los modifiers llevan un tipo que especifica qué comando ejecutar y un attribute que indica en qué atributo ejecutar el comando.

Create new attribute #

Toma un new_value que indica el valor que se le asignará al atributo; puede usarse tanto como un nuevo atributo o para reemplazar uno ya existente.

Delete attribute #

Elimina el atributo indicado de todos los productos, o de productos específicos en base a una condición if.

Delete product #

Elimina el(los) producto(s) indicados en base a una condición if.

Update attribute #

Si no eres técnico y estás leyendo esto. Prepárate porque usaremos regex con la librería de python.

El comando Update usa el atributo regexp, que es una expresión regex que coincide con algunas partes del atributo y reemplaza cada grupo coincidente con el contenido de replace_by. Aquí tienes una herramienta útil para crear tu regex.

Un ejemplo de regex podría ser [/]+ con un replace_by de ’/’, esto tomaría todos los lugares del atributo que tengan múltiples / seguidos y los reemplazaría por un solo /. Así, https://test//tests se convertiría en https:/test/tests.

Ejemplo #

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

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

Change attribute type #

Permite cambiar el tipo 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.

Split attribute #

Permite dividir una cadena por un separador, en una lista de cadenas. Por defecto separa por coma si no se especifica un separador.

Ejemplo #

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

Append value #

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

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

Evaluate an expression #

La acción Expression evalúa una expresión matemática, que puede incluir atributos, constantes y operadores. 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 introduces en el campo New Value la cadena: price * 0.8 y el precio es 100, el resultado será 80.

New formatted attribute #

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

Para referenciar un atributo existente, pon 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 (incluyendo las llaves), no el valor del atributo.

Ejemplo #

Puedes combinar atributos, agregar prefijos o sufijos, o cambiar cómo se muestra el dato. Por ejemplo, para crear un precio formateado tipo €100,00, pon New Value como: € + {price}.

If Statements #

Si escribes cualquier expresión en el campo if, el comando solo se ejecutará en los atributos donde la expresión indicada se evalúe como verdadera.

Los operadores disponibles son:

Ejemplo #

Crear un nuevo atributo Availability con el valor Available, If stock > 0.

Crear atributos a partir de listas #

Un caso común es crear un atributo separado basado en 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 gender dedicado para usar en facetas de Search.

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

"value" in attribute_name

Para crear un atributo gender a partir de tags, configura varios modifiers en secuencia:

Cada modifier se ejecuta solo cuando su condición es verdadera. El orden importa: si un producto tiene múltiples tags coincidentes, el último modifier 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 se escribe sin comillas (por ejemplo, tags).

Combinando condiciones #

Puedes combinar varias condiciones usando los operadores and y or.

Coincidir productos donde la brand sea Nike Y el stock sea mayor a 0:

brand == "Nike" and stock > 0

Coincidir productos donde la categoría contiene shoes O boots:

"shoes" in categories or "boots" in categories

Coincidir productos con una tag específica Y precio superior a 100:

"premium" in tags and price > 100

Prueba y guardar #

Antes de hacer clic en Save & Run, que aplicará los modifiers en todo tu catálogo, es una buena práctica probar tu nuevo modifier primero. Puedes hacerlo en la sección See how your modifiers impact your product data.

Aquí puedes seleccionar un producto y ver cómo se ve afectado por el modifier usando la visualización Before & After.

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