Modificatori

Panoramica #

I Modificatori ti permettono di modificare i dati dopo la sincronizzazione, senza toccare il tuo feed di dati o coinvolgere uno sviluppatore. Attualmente, i Modificatori supportano Prodotti, Categorie, Clienti e Pagine.

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

Ci sono due modi per creare un modificatore: utilizzando AI Modifiers, che è l’approccio consigliato, oppure scegliendo uno dei modificatori standard per trasformazioni più semplici e predefinite.

Ordine dei Modificatori #

Imposta l’ordine quando un modificatore dipende da una modifica apportata da un altro. Clerk.io valuta l’elenco dall’alto verso il basso.

In Data > Modifiers, prendi la maniglia punteggiata di un modificatore e trascinalo nella posizione desiderata. Un riquadro tratteggiato mostra dove atterrerà. Rilascia la riga per spostarla.

Puoi anche focalizzare una riga di modificatore e premere Alt + ↑ o Alt + ↓ per spostarla con la tastiera. I lettori di schermo annunciano lo spostamento.

Testa la sequenza nell’ Anteprima Prima & Dopo prima di cliccare su Save & Run per applicarla al tuo catalogo.

AI Modifiers #

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

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

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

Esempi di prompt:

• “Crea un attributo chiamato variant_stock_percentage che mostri quante varianti di un prodotto sono attualmente disponibili a magazzino, come percentuale 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 differenza percentuale tra list_price e price, arrotondato 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 sidebar Ask e lascia che aggiorni la funzione. Ask Clerk.io può ricercare il tuo store e la configurazione prima di creare il modificatore, cosa che lo aiuta a comprendere il contesto della tua richiesta.

Tipi di Modificatori Standard #

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

Tutti i modificatori standard hanno un campo if di input. Se viene aggiunta una condizione, il modificatore si applica solo ai prodotti per cui questa risulta vera.

Ecco una descrizione di ogni tipo di modificatore standard.

Create new attribute #

Richiede un new_value che rappresenta il valore da assegnare all’attributo; può essere utilizzato sia come nuovo attributo, sia per sovrascrivere uno esistente.

Delete attribute #

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

Delete product #

Elimina il/dei prodotto/i in base a una condizione if.

Update attribute #

Questo modificatore utilizza le regex con la libreria Python. Se non conosci le regex, considera di utilizzare AI Modifiers — sono in grado di gestire le stesse trasformazioni senza alcuna conoscenza delle regex.

L’Update richiede l’attributo regexp, ossia un’espressione regex che trova alcune parti dell’attributo e sostituisce ogni gruppo corrispondente con il contenuto di replace_by. Ecco uno strumento utile per creare la tua regex.

Un esempio di regex potrebbe essere []+ con un replace_by di ’/’, che convertirebbe tutte le occorrenze consecutive di / in una sola /. Quindi https://test//tests diventerebbe https:/test/tests.

Esempio #

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

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

Change attribute type #

Permette di cambiare il tipo di un attributo. Quindi, se il dato è un numero e serve come stringa, puoi usare questo comando per effettuare il typecast. I tipi disponibili sono: string,int,float e boolean.

Split attribute #

Permette di dividere una stringa tramite un separatore, trasformandola in una lista di stringhe. Di default divide tramite la virgola se non viene specificato alcun separatore.

Esempio #

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

Append value #

Permette di aggiungere nuovi valori a un attributo lista esistente.

Per esempio, puoi aggiungere ulteriori stringhe ad un attributo tags, o una nuova categoria all’attributo categories.

Evaluate an expression #

L’azione Expression valuta un’espressione matematica, che può includere attributi, costanti e operatori. Quindi, 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 nel campo New Value inserisci la stringa: price * 0.8 e il prezzo è 100, il risultato sarà 80.

New formatted attribute #

Questa azione crea un nuovo attributo partendo da dati esistenti, applicando formattazione o trasformazioni al suo valore.

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

• Copia un attributo: imposta New Value su {MPN}.
• Concatenamento di testo e attributi: € + {price}.

Se includi spazi tra le parentesi graffe, come { attribute }, il sistema salverà letteralmente la stringa, parentesi incluse, e non il valore dell’attributo.

Esempio #

Puoi combinare attributi, aggiungere prefissi o suffissi, o cambiare come appare il dato. Ad esempio, per creare un prezzo formattato come €100,00, imposta New Value su: € + {price}.

If Statements #

Se aggiungi una condizione nel campo if, il comando verrà eseguito solo su quegli attributi in cui la condizione risulta vera.

Gli operatori disponibili sono:

Esempio #

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

Creazione di attributi da liste #

Un caso d’uso comune è creare un attributo separato a partire da valori presenti in una lista di attributi esistente. Ad esempio, se hai un attributo tags che contiene valori come Female, Male e Unisex, puoi creare un attributo dedicato gender da usare nei filtri di Search.

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

"value" in attribute_name

Per creare un attributo gender a partire dai tags, imposta più modificatori in sequenza:

Ogni modificatore viene eseguito solo se la sua condizione è vera. L’ordine è importante: se un prodotto ha più tag corrispondenti, l’ultimo modificatore corrispondente determina il valore finale.

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

Combinare condizioni #

È possibile combinare più condizioni utilizzando 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 OPPURE boots:

"shoes" in categories or "boots" in categories

Seleziona prodotti con un tag specifico E price sopra 100:

"premium" in tags and price > 100

Testing & Save #

Prima di cliccare su Save & Run, che applica i modificatori su tutto il tuo catalogo, è buona norma testare prima il nuovo modificatore. Puoi farlo nella sezione Guarda come i tuoi modificatori influenzano i dati dei prodotti.

Qui puoi selezionare un prodotto e vedere come viene modificato dal modificatore utilizzando la visualizzazione Prima & Dopo.

Puoi includere o escludere singoli modificatori dall’anteprima. Usa la casella di controllo Include in preview su ogni modificatore per rimuoverlo temporaneamente dal calcolo di anteprima durante il test di un prodotto. Questa selezione influenza solo l’anteprima e non il modificatore reale — tutti i modificatori saranno applicati quando clicchi su Save & Run.