Modificatori

Panoramica #

I Modifiers ti permettono di modificare i dati dopo la sincronizzazione, senza toccare il tuo data feed o coinvolgere uno sviluppatore. I Modifiers attualmente supportano Products, Categories, Customers e Pages.

I Modifiers vengono valutati dall’alto verso il basso, quindi l’ordine in cui appaiono nella lista è importante. Gli esempi qui sotto usano dati di prodotto, ma la stessa funzione di modifier può essere utilizzata anche con gli altri tipi di dati supportati.

Ci sono due modi per creare un modifier: usando AI Modifiers, che è l’approccio consigliato, oppure scegliendo uno dei tipi di modifiers standard per trasformazioni più semplici e predefinite.

AI Modifiers #

Gli AI Modifiers sono il modo predefinito e consigliato per creare dei modifiers. Invece di configurare singoli campi e regole, descrivi semplicemente in linguaggio naturale ciò che vuoi che il modifier faccia, e l’AI genera una funzione Python che trasforma i dati dei tuoi prodotti di conseguenza.

Questo approccio è molto più flessibile rispetto ai tipi di modifiers standard. Puoi descrivere logiche complesse, combinare più condizioni, calcolare nuovi valori da attributi esistenti e gestire casi particolari — tutto senza dover scrivere codice.

1. Fai clic su Add Modifier e seleziona AI Modifier come tipo (selezionato di default).
2. Nella pagina del modifier, clicca sul pulsante per aprire la barra laterale Ask.
3. Nella barra laterale Ask, descrivi cosa deve fare il modifier. Sii il più specifico possibile sulla logica, gli attributi coinvolti e il risultato atteso.
4. L’AI genera una funzione Python basata sulla tua descrizione.
5. Testa il modifier utilizzando l’anteprima Before & After prima di salvarlo.

Prompt di esempio:

• “Crea un attributo chiamato variant_stock_percentage che mostri quante varianti di un prodotto sono attualmente disponibili, come percentuale compresa tra 0 e 100.”
• “Imposta availability su In stock se stock è maggiore di 0, altrimenti impostalo su Out of stock.”
• “Crea un attributo discount_percentage calcolando la percentuale di differenza tra list_price e price, arrotondata all’intero più vicino.”

La funzione Python generata dall’AI è di sola lettura — non puoi modificarla direttamente. Per cambiare la logica, continua la conversazione nella barra laterale Ask e lascia che la aggiorni. Ask Clerk.io può fare ricerche sul tuo store e sulla configurazione prima di creare il modifier, il che lo aiuta a capire il contesto dietro la richiesta.

Tipi di Modifiers Standard #

Per trasformazioni più semplici, sono disponibili i tipi di modifiers standard. Questi coprono un insieme di operazioni predefinite e sono facili da configurare, ma sono più limitati rispetto agli AI Modifiers.

Tutti i modifiers standard hanno un campo if di input. Se si aggiunge una condizione, il modifier verrà eseguito solo sui prodotti per cui quella condizione è vera.

Ecco una descrizione di ciascun tipo di modifier standard.

Create new attribute #

Accetta un new_value che indica quale valore assegnare all’attributo, può essere usato sia come nuovo attributo sia per sostituirne uno esistente.

Delete attribute #

Elimina l’attributo indicato da tutti i prodotti, o solo da quelli specifici su base di una condizione if.

Delete product #

Elimina il/i prodotto/i specifici in base ad una condizione if.

Update attribute #

Questo modifier usa regex con la libreria Python. Se non conosci le regex, considera di usare gli AI Modifiers — possono gestire le stesse trasformazioni senza necessità di comprendere le regex.

L’update accetta l’attributo regexp che è un’espressione regex che individua alcune parti dell’attributo e sostituisce ciascun gruppo abbinato con il contenuto di replace_by. Questo è uno strumento utile per creare la tua regex.

Un esempio di regex potrebbe essere []+ con un replace_by di ’/’; questa espressione sostituirà tutti i casi in cui l’attributo contiene più / di seguito in una singola /. Così https://test//tests diventerà https:/test/tests.

Esempio #

In questo esempio, vogliamo rimuovere la parte finale di una URL usando una regex. L’URL di partenza è: https://example.domain/product/153//__example. Per rimuovere la parte //__example possiamo usare questa regex: \/\/__example.

Poiché vogliamo semplicemente eliminare questa parte senza sostituirla con altro, il campo Replace by viene lasciato vuoto.

Change attribute type #

Permette di cambiare il tipo di un attributo. Ad esempio, se il dato è un numero e lo vuoi come stringa, puoi farlo tramite questa opzione. I tipi di attributo sono: string, int, float e boolean.

Split attribute #

Permette di dividere una stringa tramite un separatore, ottenendo una lista di stringhe. Di default, il separatore è la virgola se non viene indicato nulla.

Esempio #

Qui stiamo dividendo un attributo con categorie, trasformandolo in una lista: "lineman, chute" diventa ["lineman","chute"].

Append value #

Permette di aggiungere nuovi valori ad un attributo di tipo lista già esistente.

Ad esempio per aggiungere nuove stringhe all’attributo tags, oppure aggiungere una nuova categoria all’attributo categories.

Evaluate an expression #

L’azione Expression valuta un’espressione matematica, che può includere attributi, costanti e operatori. Ad esempio, se definisci questa espressione: price * 0.8 il sistema calcolerà il risultato moltiplicando il valore dell’attributo price per 0.8, applicando uno sconto del 20%.

Esempio #

Se inserisci nel campo New Value la stringa: price * 0.8 e il prezzo è 100, il risultato sarà 80.

New formatted attribute #

Questa azione crea un nuovo attributo, basandosi su dati esistenti e applicando formattazione o trasformazioni al valore.

Per fare riferimento ad un attributo esistente, racchiudi il nome tra parentesi graffe senza spazi: {attributeName}.

• Per copiare un attributo: imposta New Value su {MPN}.
• Per concatenare testo e attributi: € + {price}.

Se inserisci degli spazi all’interno delle parentesi graffe, come { attribute }, il sistema salverà la stringa letterale (comprese le parentesi), non il valore dell’attributo.

Esempio #

Puoi combinare attributi, aggiungere prefissi o suffissi o cambiare la visualizzazione dei dati. Per esempio, per creare un prezzo formattato come €100,00, imposta New Value a: € + {price}.

If Statements #

Se aggiungi una qualsiasi condizione nel campo if, il comando verrà eseguito solo sugli attributi per cui la condizione risulta vera.

Gli operatori disponibili sono:

Esempio #

Crea un nuovo attributo Availability impostato su Available, If stock > 0.

Creare attributi da liste #

Un caso d’uso comune è creare un attributo separato sulla base dei valori presenti in un attributo di tipo lista. Per esempio, se hai un attributo tags con valori come Female, Male e Unisex, puoi creare un attributo dedicato gender da usare nei facet di Search.

L’operatore in controlla se un valore esiste all’interno di una lista. La sintassi è:

"value" in attribute_name

Per creare un attributo gender dai tags, imposta più modifiers in sequenza:

Ogni modifier sarà eseguito solo quando la propria condizione è vera. L’ordine conta: se un prodotto ha più tag corrispondenti, l’ultimo modifier valido determina il valore finale.

Nota: Il valore che si controlla deve essere tra virgolette (ad es. "Female"), mentre il nome dell’attributo va senza virgolette (ad es. tags).

Combinare condizioni #

Si possono combinare più condizioni usando gli operatori and e or.

Seleziona prodotti dove il brand è Nike E lo stock è maggiore di 0:

brand == "Nike" and stock > 0

Seleziona prodotti dove la categoria contiene shoes O boots:

"shoes" in categories or "boots" in categories

Seleziona prodotti con uno specifico tag E prezzo superiore a 100:

"premium" in tags and price > 100

Testing & Save #

Prima di fare clic su Save & Run, che applica i modifiers all’intero catalogo, è consigliabile testare prima il nuovo modifier. Puoi farlo nella sezione See how your modifiers impact your product data.

Qui puoi selezionare un prodotto e vedere come viene modificato da un modifier tramite la visualizzazione Before & After.

Puoi includere o escludere singoli modifiers dall’anteprima. Usa la checkbox Include in preview su ogni modifier per rimuoverlo temporaneamente dal calcolo dell’anteprima quando testi un prodotto. Questa selezione influisce solo sull’anteprima e non sul modifier live — tutti i modifiers saranno applicati quando clicchi su Save & Run.