Modificatori

Panoramica #

I modificatori ti permettono di cambiare i dati dei prodotti dopo la sincronizzazione, senza modificare il tuo feed di dati o coinvolgere uno sviluppatore. I modificatori vengono valutati dall’alto verso il basso, quindi l’ordine in cui appaiono nella lista è importante.

Ci sono due modi per creare un modificatore: usando i Modificatori AI, che è l’approccio raccomandato, oppure scegliendo uno dei tipi di modificatori standard per trasformazioni più semplici e predefinite.

Modificatori AI #

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

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

1. Clicca su Aggiungi Modificatore e seleziona Modificatore AI come tipo (questa è la selezione predefinita).
2. Nel campo di testo, descrivi cosa dovrebbe fare il modificatore. Sii il più specifico possibile riguardo la logica, gli attributi coinvolti e l’output atteso.
3. L’AI genera una funzione Python basata sulla tua descrizione.
4. Testa il modificatore usando l’anteprima Prima & Dopo prima di salvare.

Esempi di prompt:

• “Crea un attributo chiamato variant_stock_percentage che mostra quanti delle varianti di un prodotto sono attualmente disponibili, 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, arrotondata all’intero più vicino.”

La funzione Python generata dall’AI è di sola lettura — non puoi modificarla direttamente. Per cambiare la logica, chatti semplicemente con l’AI tramite il campo di testo e lascia che aggiorni la funzione. Questo garantisce che la funzione corrisponda sempre all’intento descritto.

Tipi di Modificatori Standard #

Per trasformazioni più semplici, sono disponibili tipi di modificatori standard. Questi coprono un insieme di operazioni predefinite e sono semplici da configurare, ma sono più limitati rispetto ai Modificatori AI.

Tutti i modificatori standard hanno un campo di input if. Se viene aggiunta un’istruzione, il modificatore viene eseguito solo sui prodotti per cui quella condizione è vera.

Qui sotto una descrizione di ciascun tipo di modificatore standard.

Create new attribute #

Richiede un new_value che indica quale valore assegnare all’attributo; può essere usato sia come nuovo attributo, sia su uno esistente per sostituirlo.

Delete attribute #

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

Delete product #

Elimina uno o più prodotti in base a una condizione if.

Update attribute #

Questo modificatore usa regex con la libreria Python. Se non hai familiarità con le regex, considera di usare i Modificatori AI — possono gestire le stesse trasformazioni senza necessità di conoscere le regex.

Update richiede l’attributo regexp, che è un’espressione regex che trova alcune parti dell’attributo e sostituisce ogni gruppo trovato 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 ’/’: questo sostituirà tutte le sequenze di più / di fila nell’attributo con un singolo /. Quindi https://test//tests diventa https:/test/tests.

Esempio #

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

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

Change attribute type #

Permette di modificare il tipo di un attributo. Se i dati sono un numero e hai bisogno che sia una stringa, puoi usare questa funzione per eseguire il typecast. I tipi disponibili sono: string, int, float e boolean.

Split attribute #

Permette di dividere una stringa tramite un separatore in una lista di stringhe. Per impostazione predefinita divide per virgola se non viene indicato un separatore.

Esempio #

Qui suddividiamo un attributo con categorie per ottenere una lista: "lineman, chute" diventa ["lineman","chute"].

Append value #

Permette di aggiungere nuovi valori a un attributo lista esistente.

Potresti aggiungere ulteriori stringhe a un 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 a partire da dati esistenti, applicando formattazioni o trasformazioni sul valore.

Per riferirti a un attributo esistente, racchiudi il suo nome tra parentesi graffe senza spazi: {attributeName}.

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

Se includi spazi all’interno delle parentesi, 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 come appaiono i dati. Ad esempio, per creare un prezzo formattato come €100,00, imposta New Value su: € + {price}.

Istruzioni If #

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

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 molto comune è creare un attributo separato basato su valori presenti in un attributo lista esistente. Ad esempio, se hai un attributo tags che contiene valori come Female, Male e Unisex, puoi creare un attributo dedicato gender da usare nelle faccette di Search.

L’operatore in verifica se un valore è presente in una lista. La sintassi è:

"value" in attribute_name

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

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

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

Combinare condizioni #

Puoi combinare più condizioni usando gli operatori and e or.

Seleziona prodotti con brand pari a Nike E 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 un tag specifico E prezzo superiore a 100:

"premium" in tags and price > 100

Test e Salvataggio #

Prima di cliccare su Salva ed Esegui, che applica i modificatori a tutto il tuo catalogo, è buona pratica testare prima il nuovo modificatore. Puoi farlo nella sezione Vedi come i tuoi modificatori impattano i dati dei prodotti.

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

Puoi includere o escludere singoli modificatori dalla preview. Usa la checkbox Include in preview su ciascun modificatore per rimuoverlo temporaneamente dal calcolo della preview durante il test di un prodotto. Questa selezione influenza solo l’anteprima e non il modificatore live — tutti i modificatori verranno applicati quando clicchi su Salva ed Esegui.