Guida Completa al Sistema di Regole Feed

Comprendere il Sistema di Regole Feed

Il Sistema di Regole Feed è una funzionalità potente che ti consente di filtrare, trasformare e ottimizzare i dati dei tuoi prodotti prima che vengano esportati verso vari marketplace. Le regole vengono applicate in sequenza durante la generazione del feed, dandoti il pieno controllo sul tuo catalogo prodotti.

Consiglio pro: Le regole sono elaborate dall'alto verso il basso. Puoi trascinare e rilasciare le regole per modificarne l'ordine.

Tipi di regole

Regole semplici

Singola condizione con una sola azione. Perfette per trasformazioni immediate.

Regole complesse

Più condizioni con logica IF/THEN/ELSE. Ideali per elaborazioni sofisticate dei dati.

Tutte le condizioni disponibili

Le condizioni determinano quando applicare una regola a un prodotto. Ecco l'elenco completo con esempi:

Condizioni di confronto testuale

Condizione	Descrizione	Esempio
`contains`	Verifica se il campo contiene il testo specificato (ignorando maiuscole/minuscole)	Il titolo contiene "Sale" → Corrisponde a "Summer Sale Items"
`not contains`	Verifica se il campo NON contiene il testo specificato	Il titolo non contiene "Draft" → Esclude i prodotti bozza
`starts with`	Verifica se il campo inizia con il testo specificato	SKU inizia con "WS-" → Corrisponde a "WS-12345"
`ends with`	Verifica se il campo termina con il testo specificato	Il titolo termina con "- Refurbished" → Corrisponde agli articoli ricondizionati
`equals`	Corrispondenza esatta (ignorando maiuscole/minuscole)	Stato uguale a "active" → Solo prodotti attivi
`not equals`	Non corrisponde esattamente	Categoria diversa da "Uncategorized"

Condizioni di confronto con liste

Condizione	Descrizione	Esempio
`contains one of`	Corrisponde se il campo contiene ALMENO uno dei valori elencati	Brand contiene uno tra: Nike Adidas Puma
`not contains one of`	Corrisponde se il campo NON contiene nessuno dei valori elencati	Titolo non contiene uno tra: Test Demo Sample
`in list`	Corrispondenza esatta rispetto a un elenco di valori	Categoria nell'elenco: Elettronica Computer Accessori
`not in list`	Non corrisponde a nessun valore nell'elenco	Stato non nell'elenco: discontinued out_of_stock

Condizioni numeriche

Condizione	Descrizione	Esempio
`greater than`	Il valore numerico è maggiore di quello specificato	Prezzo maggiore di 100
`less than`	Il valore numerico è minore di quello specificato	Giacenza minore di 5
`greater or equal`	Il valore numerico è maggiore o uguale a	Peso maggiore o uguale a 1,5
`less or equal`	Il valore numerico è minore o uguale a	Sconto minore o uguale a 50
`between`	Il valore numerico rientra in un intervallo	Prezzo compreso tra 10-50

Verifica dei valori

Condizione	Descrizione	Esempio
`is empty`	Il campo è senza valore o contiene solo spazi	Descrizione è vuota
`is not empty`	Il campo ha un valore	L'URL immagine non è vuoto
`always`	Sempre vero (nessun controllo condizione)	Usa per trasformazioni globali

Metriche del testo

Condizione	Descrizione	Esempio
`length exceeds`	La lunghezza del testo supera i caratteri specificati	Lunghezza titolo superiore a 150
`length not exceeds`	La lunghezza del testo è entro il limite	Lunghezza descrizione non supera 5000
`word count exceeds`	Il numero di parole supera quello specificato	Conteggio parole descrizione superiore a 50
`word count not exceeds`	Il numero di parole è entro il limite	Conteggio parole titolo non supera 10

Corrispondenze avanzate (pattern)

Condizione	Descrizione	Esempio
`matches regex`	Corrisponde a un'espressione regolare	SKU matches regex: ^[A-Z]{2}-d{4}$
`not matches regex`	Non corrisponde all'espressione regolare	Description not matches regex: ɓ(spam\|junk)ɓ

Nota: Quando si usano segnaposto di campo come {{price}} nelle condizioni, il sistema li sostituirà con i valori reali del prodotto durante la valutazione.

Tutte le azioni disponibili

Le azioni definiscono cosa accade quando una condizione è soddisfatta. Ecco l'elenco completo:

Azioni di controllo del feed

Azione	Descrizione	Esempio d'uso
`exclude`	Rimuove completamente il prodotto dal feed	Escludi prodotti con prezzo = 0
`deduplicate products` ⭐	Rimuove i prodotti duplicati in base al campo di confronto	Tieni solo la variante con prezzo più basso per SKU

Azioni di trasformazione del testo

Azione	Descrizione	Esempio
`replace text`	Trova e sostituisce testo (ignorando maiuscole/minuscole)	Sostituisci "Spedizione gratuita" con "Spedizione gratis"
`transform field` ⭐	Trasformazione completa del campo usando un modello	Trasforma in: {{brand}} - {{title}} ({{color}})
`combine fields`	Unisce più campi tramite un modello	Combina: {{title}} \| Taglia: {{size}}
`strip HTML`	Rimuove tutti i tag HTML dal testo	Pulisci le descrizioni dei prodotti
`change case`	Converte in MAIUSCOLO, minuscolo o Titolo	Rendi i nomi dei brand in maiuscolo
`trim whitespace`	Rimuove spazi e interruzioni di riga in eccesso	Pulisci dati disordinati
`add prefix`	Aggiunge testo all'inizio del campo	Aggiungi "SALE: " al titolo
`add suffix`	Aggiunge testo alla fine del campo	Aggiungi " - Spedizione gratuita" al titolo
`truncate text`	Limita il testo alla lunghezza specificata	Limita la descrizione a 500 caratteri

Operazioni numeriche

Azione	Descrizione	Esempio
`math operation`	Aggiunge, sottrae, moltiplica, divide, arrotonda	Moltiplica il prezzo per 1,2 (mark-up 20%)
`percentage change`	Aumenta/diminuisce in percentuale	Diminuisci il prezzo del 15%
`round price`	Arrotonda al numero di decimali specificato	Arrotonda il prezzo all'unità
`extract number`	Estrae un valore numerico dal testo	Estrai "12.5" da "Peso: 12.5 kg"

Elaborazione testo avanzata

Azione	Descrizione	Esempio
`split text`	Estrae una parte del testo tramite delimitatore	Dividi "Colore\|Taglia\|Materiale" prendi elemento 1
`clean text`	Rimuove caratteri speciali e ripulisce la formattazione	Pulisci i titoli dei prodotti
`regex replace`	Cerca/sostituisce avanzato con pattern	Rimuovi tutti i prezzi: /$[d,]+.?d*/
`remove non-alphanumeric`	Conserva solo lettere, numeri e spazi	Pulisci SKU o ID

Operazioni URL

Azione	Descrizione	Esempio
`add UTM parameters`	Aggiunge parametri di tracciamento agli URL	Aggiungi utm_source=google&utm_medium=shopping
`URL encode`	Codifica i caratteri speciali negli URL	Rendi gli URL sicuri per tutti i sistemi
`URL decode`	Decodifica gli URL codificati	Converti %20 in spazi
`validate URL`	Pulisce URL non validi	Rimuovi collegamenti malformati

Data e formattazione

Azione	Descrizione	Esempio
`format date`	Cambia il formato della data	Converti nel formato Y-m-d o d/m/Y

Azione in evidenza: Transform Field

L'azione Transform Field è una delle funzionalità più potenti del sistema di regole. Ti consente di ricostruire completamente il contenuto di un campo usando un modello con segnaposto.

Come funziona

Usa i segnaposto {{field_name}} per inserire i valori di qualsiasi campo del prodotto:

Template: {{brand}} - {{title}} | {{color}} {{size}}
Product: {brand: "Nike", title: "Running Shoes", color: "Red", size: "10"}
Result: Nike - Running Shoes | Red 10

Casi d'uso comuni

Titoli SEO: Compra {{title}} - {{brand}} | Spedizione gratuita
Generazione SKU: {{brand}}-{{category}}-{{id}}
Intestazioni descrizione: Informazioni su questa {{category}}: {{title}}
Titoli varianti: {{parent_title}} - {{color}} / {{size}}

Consiglio pro: Puoi usare Transform Field con qualsiasi condizione, compresa "always" per applicarlo a tutti i prodotti.

Azione in evidenza: Deduplicate Products

L'azione Deduplicate Products ti aiuta a rimuovere i prodotti duplicati dal feed in base a criteri di corrispondenza.

Opzioni di configurazione

Campo di confronto	Il campo usato per identificare i duplicati (ad es. SKU, GTIN, titolo)
Campo di priorità	Il campo per determinare quale duplicato mantenere (ad es. prezzo, stock)
Direzione priorità	Mantieni il prodotto con valore di priorità più basso o più alto

Scenari di esempio

Scenario 1: Mantieni la variante più economica

Campo di confronto: parent_sku
Campo di priorità: price
Direzione priorità: lowest

Risultato: Per i prodotti con lo stesso parent_sku, viene mantenuta solo la variante più economica.

Scenario 2: Mantieni l'articolo con più disponibilità

Campo di confronto: gtin
Campo di priorità: inventory
Direzione priorità: highest

Risultato: Per i prodotti con lo stesso GTIN, mantieni quello con più stock.

Importante: La deduplicazione avviene dopo l'applicazione di tutte le altre regole, garantendo risultati coerenti.

Regole complesse (IF/THEN/ELSE)

Le regole complesse consentono di creare logiche sofisticate con più condizioni e azioni diverse in base all'esito delle condizioni.

Struttura

IF (Condizioni con logica AND/OR)

THEN (Azioni quando le condizioni sono VERE)

ELSE (Azioni quando le condizioni sono FALSE) - Opzionale

Esempio di regola complessa

Regola: Strategia di prezzo per prodotti premium

IF:

Brand uguale a "Premium Brand" AND
Categoria contiene "Electronics" AND
Prezzo maggiore di 100

THEN:

Aggiungi prefisso "[PREMIUM] " al titolo
Operazione matematica: aggiungi 50 al prezzo
Trasforma descrizione: "Prodotto {{brand}} esclusivo - {{title}}"

ELSE:

Variazione percentuale: -10% sul prezzo
Aggiungi suffisso " - Grande valore!" al titolo

Buone pratiche e consigli

L'ordine delle regole è importante

Le regole sono elaborate in sequenza. Posiziona le regole di esclusione prima di quelle di trasformazione per evitare elaborazioni inutili.

Testa prima di applicare

Usa le schede di anteprima dei prodotti per vedere come le regole influenzano i prodotti prima di pubblicare il feed.

Usa titoli descrittivi

Dai alle tue regole titoli chiari e descrittivi per comprenderne facilmente lo scopo in seguito.

Combina regole semplici e complesse

Usa regole semplici per attività immediate e regole complesse per logiche sofisticate.

Segnaposto di campo

Ricorda che puoi usare i segnaposto {{field_name}} nella maggior parte dei valori testuali, non solo nelle azioni di trasformazione.

Domande frequenti

Posso utilizzare più regole di deduplicazione?

Sì! Ogni regola di deduplicazione funziona in modo indipendente. Ad esempio, puoi prima deduplicare per SKU mantenendo il prezzo più basso, poi deduplicare per titolo mantenendo lo stock più alto.

Cosa succede se un segnaposto di campo non esiste?

Se un campo referenziato in {{field_name}} non esiste, verrà sostituito con una stringa vuota.

Posso combinare condizioni con logica OR nelle regole semplici?

Le regole semplici supportano solo una singola condizione. Per la logica OR, usa regole complesse o crea più regole semplici.

Come posso capire perché un prodotto è stato escluso?

Controlla la scheda "Prodotti esclusi" nell'interfaccia delle regole del feed. Mostra tutti i prodotti rimossi dalle regole di esclusione.

Centro Assistenza