Modificadores

Descripción general #

Los modificadores te permiten cambiar los datos después de la sincronización, sin modificar tu feed de datos ni involucrar a un desarrollador. Actualmente, los modificadores son compatibles con Productos, Categorías, Clientes y Páginas.

Los modificadores se evalúan de arriba hacia abajo, por lo que el orden en que aparecen en la lista es importante. Los ejemplos siguientes usan datos de productos, pero la misma función de modificador se puede usar con los otros tipos de datos soportados.

Hay dos maneras 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.

Orden de los modificadores #

Establece el orden cuando un modificador depende de un cambio realizado por otro. Clerk.io evalúa la lista de arriba hacia abajo.

En Data > Modifiers, toma el asa punteada de un modificador y arrástralo hasta la posición deseada. Una caja de líneas discontinuas muestra dónde caerá. Suelta la fila para moverla.

También puedes enfocar una fila de modificador y presionar Alt + ↑ o Alt + ↓ para moverla con el teclado. Los lectores de pantalla anuncian el movimiento.

Prueba la secuencia en la vista previa Antes y Después antes de hacer clic en Save & Run para aplicarlo a tu catálogo.

AI Modifiers #

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

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 manejar casos límite, todo sin escribir ningún código tú mismo.

1. Haz clic en Add Modifier y selecciona AI Modifier como tipo (esto viene seleccionado por defecto).
2. En la página del modificador, haz clic en el botón para abrir la barra lateral Ask.
3. En la barra lateral Ask, describe lo que debe hacer el modificador. Sé lo más específico posible sobre la lógica, los atributos implicados y el resultado esperado.
4. La IA genera una función Python basada en tu descripción.
5. Prueba el modificador usando la vista previa Before & After antes de guardarlo.

Ejemplos de indicaciones:

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

La función Python generada por la IA es de solo lectura: no se puede editar directamente. Para cambiar la lógica, continúa la conversación en la barra lateral Ask y deja que se actualice la función. Ask Clerk.io puede investigar tu tienda y configuración antes de crear el modificador, lo que ayuda a entender el contexto detrás de tu solicitud.

Tipos estándar de modificador #

Para transformaciones más simples, hay tipos de modificadores estándar disponibles. Estos cubren un conjunto de operaciones predefinidas y son fáciles de configurar, pero son más limitados en comparación con los AI Modifiers.

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

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

Create new attribute #

Toma un new_value que muestra el valor que se asignará al atributo; puede usarse como un nuevo atributo o encima de uno existente para reemplazarlo.

Delete attribute #

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

Delete product #

Elimina el/los producto(s) dado(s) en base a una declaración if.

Update attribute #

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

Update toma el atributo regexp, que es una expresión regex que encuentra algunas partes del atributo y reemplaza cada grupo coincidente por 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 reemplazaría todas las veces que en el atributo hubiera varios / seguidos y los cambiarí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 de inicio es: https://example.domain/product/153//__example. Para eliminar la parte //__example, podemos usar el siguiente regex: \/\/__example.

Como simplemente 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 de un atributo. Así, si los datos son un número y necesitas que sean una cadena, puedes usar esto para cambiar el tipo. Los tipos de atributo son: string, int, float y boolean.

Split attribute #

Permite dividir una cadena usando un separador, convirtiéndola en una lista de cadenas. Por defecto, divide por coma si no se da un separador.

Ejemplo #

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

Append value #

Permite añadir nuevos valores a un atributo tipo 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.

Evaluate an expression #

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

Ejemplo #

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

New formatted attribute #

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

Para referenciar un atributo existente, encierra su nombre entre llaves sin espacios: {attributeName}.

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

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

Ejemplo #

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

If Statements #

Si agregas cualquier declaración en el campo if, el comando solo se ejecutará en los atributos donde la declaración dada sea verdadera.

Los operadores disponibles son:

Ejemplo #

Crea un nuevo atributo Availability asignado como Available, If stock > 0.

Creación de atributos a partir de listas #

Un caso de uso común es crear un atributo separado basado en valores en un atributo de lista existente. Por ejemplo, si tienes un atributo tags que contiene valores como Female, Male y Unisex, puedes crear un atributo específico gender para usar en los facetes 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 a partir de tags, configura varios modificadores en secuencia:

Cada modificador solo se ejecuta 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 se escribe sin comillas (por ejemplo, tags).

Combinando condiciones #

Puedes combinar múltiples condiciones usando los operadores and y or.

Coincidir productos donde brand es Nike Y stock es mayor que 0:

brand == "Nike" and stock > 0

Coincidir productos donde category contiene shoes O boots:

"shoes" in categories or "boots" in categories

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

"premium" in tags and price > 100

Testing & Save #

Antes de hacer clic en Save & Run, que aplica los modificadores en 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 lo afecta el modificador usando la visualización Antes y Después.

Puedes incluir o excluir modificadores individuales de la vista previa. Usa 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 cuando hagas clic en Save & Run.