Modificatori

Panoramica #

Modifiers è uno strumento potente che ti permette di modificare i dati di prodotto dopo la sincronizzazione senza la necessità di coinvolgere uno sviluppatore per apportare cambiamenti al data-feed. I Modifiers vengono valutati dall’alto verso il basso, quindi l’ordine in cui appaiono nella lista è importante.

Hai diversi tipi di modifiers, ecco la lista completa:

Tutti i comandi hanno un campo di input if. L’if può essere aggiunto a qualsiasi cosa con un’istruzione, e il comando verrà eseguito solo sull’attributo se l’istruzione restituisce vero.

Comandi #

Ecco ciascuno dei comandi con un esempio. Tutti i Modifiers hanno un tipo che specifica quale comando eseguire e un attribute che indica su quale attributo eseguire il comando.

Create new attribute #

Accetta un new_value che indica quale valore assegnare all’attributo; può essere usato sia per un nuovo attributo che sopra ad uno esistente per sovrascriverlo.

Delete attribute #

Elimina l’attributo dato da tutti i prodotti, o solo alcuni in base a una condizione if.

Delete product #

Elimina i prodotti specifici in base a una condizione if.

Update attribute #

Se non sei tecnico e stai leggendo questo, preparati perché stiamo usando regex con la libreria python.

L’aggiornamento richiede l’attributo regexp, che è un’espressione regex che trova alcune parti dell’attributo e sostituisce ogni gruppo corrispondente con il contenuto di replace_by. Questo tool ti aiuta a creare la tua regex.

Una regex di esempio potrebbe essere [/]+ con un replace_by di ’/’; questo sostituirebbe tutte le occorrenze nell’attributo dove ci sono più / consecutive con una sola /. Così, https://test//tests diventerebbe https:/test/tests.

Esempio #

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

Dato che vogliamo semplicemente rimuovere questa parte della 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 i dati sono un numero e hai bisogno che siano una stringa, puoi usarlo per effettuare il cast. I tipi di attributo sono: string, int, float e boolean.

Split attribute #

Permette di dividere una stringa tramite un separatore, creando una lista di stringhe. Se non specificato, il separatore di default è la virgola.

Esempio #

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

Append value #

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

Questo potrebbe voler dire aggiungere nuove stringhe a un attributo tags oppure aggiungere una nuova categoria a un attributo categories.

Evaluate an expression #

L’azione Expression valuta un’espressione matematica, che può includere attributi, costanti e operatori. Se definisci, per esempio: 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, applicando formattazioni o trasformazioni al suo 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}.
• Concatenamento testo e attributi: € + {price}.

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

Esempio #

Puoi combinare attributi, aggiungere prefissi o suffissi o cambiare il modo in cui i dati appaiono. Ad esempio, per creare un prezzo formattato come €100,00, imposta New Value su: € + {price}.

If Statements #

Se aggiungi un’istruzione nel campo if, il comando verrà eseguito solo sugli attributi per cui l’istruzione data restituisce vero.

Operatori disponibili:

Esempio #

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

Creazione di attributi da liste #

Un caso d’uso comune è creare un attributo separato basandosi sui valori di un attributo lista esistente. Ad esempio, se hai un attributo tags che contiene valori come Female, Male e Unisex, puoi creare un attributo gender dedicato 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 viene eseguito solo quando la sua condizione è vera. L’ordine è importante - se un prodotto ha più tag che corrispondono, l’ultimo Modifier applicato ne imposterà il valore finale.

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

Combinare condizioni #

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

Seleziona prodotti in cui brand è Nike E stock è maggiore di 0:

brand = "Nike" and stock > 0

Seleziona prodotti in cui la categoria contiene shoes OPPURE 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

Testing & Salvataggio #

Prima di cliccare su Save & Run, che applica i Modifiers all’intero catalogo, è buona pratica 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 grazie al Modifier attraverso 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 durante i test su un prodotto. Questa selezione influisce solo sull’anteprima e non sul Modifier dal vivo — tutti i Modifiers verranno applicati quando clicchi su Save & Run.