Guida
Attributi di prodotto: come estrarli, normalizzarli e mapparli
Attributi di prodotto puliti sono ciò che fa funzionare filtri, confronti, feed e bozze di conformità. Questa guida tratta lo schema, l’estrazione, le regole su unità e vocabolario e la mappatura della tassonomia che trasformano valori disordinati dei fornitori in dati coerenti.
Ogni fornitore descrive la stessa cosa in modo diverso. Una scheda tecnica dice “Capacità: 1,5 l”, un’altra “1500 ml”, una terza nasconde “contiene 1,5 litri” in un paragrafo. Per un acquirente sono un solo fatto; per un filtro o un feed sono tre stringhe non correlate. La normalizzazione degli attributi di prodotto riconduce queste variazioni a un solo valore, in una sola unità, sotto un solo nome di attributo.
Questa guida segue l’ordine in cui il lavoro avviene nella pratica: schema, estrazione, normalizzazione di numeri e testo, mappatura della tassonomia, varianti e validazione. Gli esempi usano codici di unità e strutture di tassonomia reali, così puoi adattarli direttamente.
Cosa sono gli attributi di prodotto (e cosa non sono)
Un attributo di prodotto è una proprietà con nome e valore: materiale = acciaio inossidabile, capacità = 1,5 L, colore = nero. La ricerca sull’estrazione degli attributi li chiama coppie attributo-valore. Gli attributi descrivono il prodotto stesso e restano veri ovunque venga venduto, ed è per questo che vanno in campi strutturati e non solo nel testo della descrizione.
Tre concetti vicini si confondono facilmente con gli attributi, e mescolarli causa la maggior parte dei problemi di schema successivi:
| Concetto | Scopo | Esempio | Collocazione tipica |
|---|---|---|---|
| Attributo | Descrive una proprietà del prodotto | Materiale: acciaio inossidabile; Capacità: 1,5 L | Tabella delle specifiche, filtri, campi di categoria |
| Identificativo | Denomina in modo univoco il prodotto o l’articolo commerciale | GTIN, MPN, SKU, numero di modello | Campi identificativi dedicati |
| Opzione di variante | Un attributo tra cui l’acquirente sceglie | Colore: nero / bianco; Taglia: S / M / L | Assi delle varianti (Shopify consente fino a 3 opzioni) |
| Descrizione | Spiega vantaggi e uso in forma discorsiva | “Porta a ebollizione un bollitore pieno in pochi minuti” | Descrizione ed elenco puntato |
Definisci lo schema degli attributi prima di estrarre qualsiasi cosa
Uno schema di attributi è il contratto che ogni valore deve rispettare. Senza di esso, l’estrazione produce ciò che la fonte capita di dire e la normalizzazione diventa un’ipotesi. Per ogni attributo decidi nome, tipo di dato, unità canonica, valori ammessi o regola di validazione, se può contenere più valori e dove è obbligatorio.
Mantieni lo schema per famiglia di prodotti anziché un unico elenco gigante: un bollitore richiede capacità e potenza nominale, una T-shirt richiede composizione delle fibre e taglia. Parti dagli attributi richiesti dai tuoi canali e su cui gli acquirenti filtrano, poi aggiungi gli attributi tecnici che le tue schede tecniche forniscono in modo affidabile.
| Attributo | Tipo di dato | Unità / formato | Valori ammessi o regola | Obbligatorio |
|---|---|---|---|---|
| model_number | Testo | — | Come stampato dal fabbricante; senza spazi aggiunti | Sì |
| gtin | Testo (cifre) | 8, 12, 13 o 14 cifre | Cifra di controllo GS1 valida | Se assegnato |
| capacity | Decimale | LTR (litro) | Da 0,1 a 5,0; un valore per variante | Sì |
| rated_power_min / rated_power_max | Intero | WTT (watt) | min ≤ max; entrambi dalla stessa riga dei valori nominali | Sì |
| body_material | Enum (multivalore) | — | stainless steel, glass, plastic, ceramic | Sì |
| color | Enum | — | Elenco dei colori di base; nome commerciale salvato separatamente | Sì, per variante |
| net_weight | Decimale | KGM (chilogrammo) | > 0; non deve superare il peso lordo | Per la spedizione |
Da dove provengono i valori degli attributi e quale fonte prevale
I valori arrivano di solito da più fonti che non sempre concordano. Stabilisci una priorità delle fonti per ciascun attributo, in modo che i conflitti si risolvano in modo coerente e non in base a chi modifica per ultimo il record.
Un’impostazione pratica predefinita: i documenti tecnici prevalgono sui testi di marketing, e il documento specifico prevale su quello generale. Quando fonti di pari livello non concordano — ad esempio scheda tecnica e confezione che riportano pesi diversi — non fare la media né sceglierne una: chiedi al fornitore quale sia quella aggiornata.
- Schede tecniche e schede delle specifiche: la fonte più affidabile per dimensioni, valori nominali, materiali e prestazioni, di solito nelle tabelle.
- Confezione e file grafici delle etichette: fanno fede per ciò che è stampato sulla confezione, come quantità netta, avvertenze e marcature.
- Schede di sicurezza: classificazione di pericolo, composizione e proprietà fisiche per i prodotti chimici; non sono attributi di marketing.
- Descrizioni dei prodotti del fornitore: utili per gli attributi che non compaiono mai in una tabella (stile, uso previsto, modelli compatibili), ma le meno precise.
Come estrarre gli attributi dalle descrizioni dei prodotti
Le descrizioni in testo libero sono la fonte più difficile perché i valori sono avvolti in frasi, qualificati dal linguaggio di marketing e talvolta negati. Che si usino regole, un dizionario di valori noti o un modello linguistico, la procedura che rende affidabile l’output è la stessa:
- Elenca gli attributi di destinazione per la famiglia di prodotti, con i relativi valori ammessi e unità, prima di leggere qualsiasi testo.
- Dividi il testo in frasi e punti elenco, poi individua i valori candidati: numeri con unità, termini del vocabolario noto e schemi come “compatibile con …”.
- Controlla il contesto di ogni candidato per qualificatori (“fino a”, “circa”, “da”), negazioni (“senza BPA”, “non adatto a”) e condizioni (“con coperchio”, “a 20 °C”).
- Assegna ogni valore a un solo attributo; quando un numero potrebbe appartenere a due attributi, lascialo non assegnato per la revisione anziché tirare a indovinare.
- Normalizza valore e unità con le regole delle sezioni successive, conservando accanto il testo originale.
- Segna ogni attributo proveniente solo dal testo di marketing, così che un revisore possa confermarlo su una scheda tecnica prima che venga usato in una tabella delle specifiche o in una bozza di dichiarazione.
| Testo nella descrizione | Attributo | Valore estratto | Nota |
|---|---|---|---|
| “…un bollitore in acciaio inossidabile da 1,7 litri…” | capacity; body_material | 1.7 LTR; stainless steel | Due attributi in un’unica espressione |
| “…con coperchio in plastica senza BPA…” | lid_material; bpa_free | plastic; true | La negazione diventa un booleano, non un materiale |
| “…non adatto ai piani a induzione…” | induction_compatible | false | Affermazione negata invertita |
| “…disponibile in nero opaco e crema…” | color (opzione di variante) | black; beige | Nomi commerciali conservati separatamente |
Mappa le intestazioni delle schede tecniche su nomi di attributi canonici
Ogni fabbricante etichetta lo stesso attributo in modo diverso, spesso nella propria lingua. Costruisci una tabella di sinonimi che associa il testo delle intestazioni che incontri davvero al nome canonico del tuo attributo; cresce rapidamente all’inizio, poi si stabilizza e diventa la tua risorsa di normalizzazione più riutilizzabile. Registra anche l’unità stampata nell’intestazione: sotto “Peso (lbs)” nessuna cella ripete l’unità. Layout delle tabelle, scansioni e OCR sono trattati nella guida sull’estrazione dei dati di prodotto dai PDF.
| Intestazione come stampata | Attributo canonico | Unità implicita nell’intestazione | Nota |
|---|---|---|---|
| Potenza nominale / Potenza assorbita / Leistung | rated_power | WTT | Verifica che sia la potenza in ingresso, non in uscita |
| Peso netto / Peso (unità) / Nettogewicht | net_weight | KGM o LBR, come stampato | Non il peso di spedizione |
| Capacità / Volume / Fassungsvermögen | capacity | LTR o MLT | Per i contenitori, non il volume della confezione |
| Dimensioni (L × P × A) mm | width, depth, height | MMT | Ordine degli assi ricavato dall’intestazione |
Normalizzare numeri e unità
Salva ogni attributo quantitativo in due campi: un numero e un codice di unità. La Raccomandazione n. 20 dell’UN/CEFACT (“Codes for Units of Measure Used in International Trade”) fornisce a tal fine codici comuni di tre caratteri, e schema.org usa gli stessi codici nella proprietà unitCode, ad esempio un QuantitativeValue di 25 con unitCode CMT. Usare questi codici al posto di unità in testo libero (“cm”, “cms”, “centimetri”) elimina un’intera classe di incongruenze.
Scegli un’unità canonica per attributo, di solito l’unità SI o un suo multiplo decimale, e converti all’importazione in modo che i valori siano confrontabili tra fornitori. Conserva il valore e l’unità originali come stampati per la tracciabilità e riconverti nelle unità del canale all’esportazione: un CSV prodotti di Shopify si aspetta il peso in grammi, mentre WooCommerce usa le unità di peso e dimensione configurate nel negozio.
Fai attenzione ai dettagli che causano errori silenziosi. I separatori decimali e delle migliaia dipendono dalle convenzioni linguistiche del documento: su una scheda tecnica tedesca “1.000 W” sono mille watt. Dividi gli intervalli in campi minimo e massimo, salva le tolleranze separatamente dal valore nominale e tieni qualificatori come “circa” o “max.” in un campo a parte. Le conversioni imperiali usano definizioni esatte (1 pollice = 25,4 mm; 1 lb = 0,45359237 kg); arrotonda una sola volta, al momento della visualizzazione.
| Valore grezzo come stampato | Valore normalizzato | Codice UNECE Rec. 20 | Regola applicata |
|---|---|---|---|
| 1,5 l | 1.5 | LTR | Virgola decimale interpretata secondo le convenzioni del documento |
| 1500 ml | 1.5 | LTR | Convertito nell’unità canonica dell’attributo; originale conservato |
| 1.000 W (scheda tecnica tedesca) | 1000 | WTT | Punto interpretato come separatore delle migliaia |
| 220–240 V~ | min 220, max 240 | VLT | Intervallo diviso; “~” salvato come tipo di corrente AC |
| Ø 12 mm ± 0,2 | nominal 12, tolerance 0.2 | MMT | Tolleranza salvata separatamente |
| ca. 2,3 kg | 2.3 (qualifier: approximate) | KGM | Qualificatore conservato, non scartato |
| 5 lb | 2.26796 | KGM | Convertito con 0,45359237; originale LBR conservato |
| 1/2 in | 12.7 | MMT | Frazione risolta; originale INH conservato |
| Confezione da 6 | 6 | H87 | Numero di pezzi per confezione |
Usa vocabolari controllati per gli attributi testuali
Un vocabolario controllato è l’elenco dei valori che un attributo testuale può assumere, più i sinonimi che vi si associano. Permette a un filtro “Colore: nero” di trovare prodotti descritti come “blk”, “Black” e “schwarz”.
Mantieni due campi dove marketing e filtri tirano in direzioni opposte: un valore di base normalizzato per filtri e feed, e il nome proprio del fabbricante per la visualizzazione. “Midnight Graphite” è un buon dettaglio per la pagina prodotto e un valore di filtro inutile; “grigio” è l’opposto. Per i cataloghi multilingue, salva i valori del vocabolario come codici indipendenti dalla lingua e traduci le relative etichette, così lo stesso prodotto si filtra correttamente in ogni lingua del negozio.
| Valore testuale grezzo | Valore normalizzato | Regola del vocabolario |
|---|---|---|
| blk / BLACK / schwarz | black | Sinonimi e traduzioni sono associati a un unico codice |
| Midnight Graphite | gray (nome visualizzato conservato) | Nome commerciale salvato separatamente |
| 18/8 SS | stainless steel | Abbreviazione espansa; qualità mantenuta come attributo a sé |
| Cotone 95%, elastan 5% | cotton 95; elastane 5 | Composizione come coppie valore–percentuale |
| Sì / ✓ / incluso | true | Valori booleani ridotti a true o false |
Mappa gli attributi su tassonomie e schemi dei canali
Una tassonomia stabilisce quali attributi si applicano a un prodotto e come si chiamano. Raramente puoi sceglierne una: un rivenditore può chiedere il GS1 GPC, un grossista l’ETIM, Shopify la propria Standard Product Taxonomy, e i motori di ricerca leggono il markup schema.org. Mantieni il tuo schema di attributi come riferimento principale e gestisci una mappatura verso ciascuna tassonomia esterna.
Nel GS1 GPC il brick è l’elemento costitutivo e gli attributi del brick riportano dettagli come il fatto che un latte sia di origine animale o non animale. L’ETIM assegna a ogni classe un insieme predefinito di caratteristiche con elenchi di valori e unità fissi, e pubblica il proprio modello in 17 lingue. Shopify chiede una sola categoria, scelta in base alla funzione principale del prodotto; impostarla sblocca i metacampi della categoria. Il Product di schema.org ha proprietà dedicate come gtin, mpn, brand, color, material, size e weight.
| Tassonomia | Principali utilizzatori | Struttura | Modello degli attributi | Da tenere presente |
|---|---|---|---|---|
| GS1 GPC | Scambio di dati per retail e beni di largo consumo | Segment > Family > Class > Brick | Attributi del brick con valori definiti | Classificazione, non un modello completo di specifiche |
| ETIM | Commercio all’ingrosso tecnico: elettrico, HVAC, idraulica | Classi con sinonimi | Caratteristiche tipizzate come alfanumeriche, logiche, numeriche o intervallo, con unità | I valori delle caratteristiche devono provenire dagli elenchi della classe |
| Shopify Standard Product Taxonomy | Negozi Shopify | Percorso della categoria o ID categoria | Metacampi della categoria (attributi di prodotto) per categoria | Nel CSV indica il percorso o l’ID, non entrambi |
| schema.org Product | Dati strutturati per i motori di ricerca | Un unico tipo Product con proprietà | Proprietà dedicate; QuantitativeValue con unitCode | Usa le proprietà specifiche prima di additionalProperty |
Gestire le varianti senza duplicare gli attributi
Le varianti sono prodotti che condividono la maggior parte degli attributi e differiscono per pochi. Modellale come un record padre che contiene gli attributi condivisi e record figlio che contengono solo gli assi della variante e i valori che cambiano con essi, come colore, taglia, capacità e i propri identificativi. Le regole GTIN di GS1 trattano ogni variazione di stile, colore e taglia come un prodotto unico con il proprio GTIN, quindi l’identificativo risiede sempre nel figlio.
Le tabelle di specifiche multi-modello causano la maggior parte degli errori sulle varianti. Dividi una tabella con una colonna per modello in un record per colonna e copia ogni valore stampato una sola volta su più colonne — una cella unita, o “tutti i modelli: 230 V” sotto la tabella — su ogni figlio a cui si applica. In Shopify la colonna CSV Option1 LinkedTo collega un’opzione di variante a un metacampo della categoria; un prodotto può avere fino a tre opzioni e 2.048 varianti.
Convalidare gli attributi con regole e campionamento QA
Le regole di validazione intercettano gli errori meccanici: tipo errato, unità errata, valore impossibile, attributo obbligatorio mancante. Eseguile a ogni importazione e indirizza gli errori a un revisore anziché scartare i valori in silenzio.
Le regole non possono intercettare un valore plausibile ma sbagliato: una capacità copiata dalla colonna del modello vicino supera tutti i controlli. Il campionamento QA può: confronta campi e fonti dei record campionati uno per uno. Non esiste una dimensione del campione o una soglia di errore universale; stabiliscile in base al rischio.
- Estrai un campione di record per fornitore, dando più peso ai nuovi fornitori e ai nuovi layout di documento.
- Confronta ogni attributo campionato con la fonte, registrando separatamente corrispondenze, valori errati e valori mancanti.
- Calcola i tassi di errore per attributo, non solo per record, per individuare gli attributi o le mappature delle intestazioni che causano problemi.
- Controlla gli attributi rilevanti per la sicurezza e quelli richiesti dalla legge su ogni record, non a campione.
| Tipo di regola | Esempio | Azione in caso di errore |
|---|---|---|
| Tipo e formato | capacity deve essere un decimale; gtin solo cifre | Rifiutare il valore, conservare il testo grezzo per la revisione |
| Intervallo e plausibilità | capacità del bollitore tra 0,1 e 5 L | Segnalare come probabile errore di unità o di separatore |
| Appartenenza all’enum | color deve essere nell’elenco dei colori di base | Associare il sinonimo o aggiungerlo al vocabolario |
| Tra più campi | min ≤ max; peso netto ≤ peso lordo | Segnalare entrambi i campi |
| Cifra di controllo | Il GTIN supera il controllo mod-10 di GS1 | Rifiutare; rileggere dalla fonte |
| Completezza | tutti gli attributi obbligatori per la famiglia e il canale sono compilati | Bloccare la pubblicazione; richiedere i dati al fornitore |
Gestire la normalizzazione degli attributi su larga scala
Lo schema, le tabelle di sinonimi, i vocabolari e le regole sono la parte duratura di questo lavoro; il metodo di estrazione può cambiare al di sotto di essi. Versionali, assegna a ciascuno un responsabile, registra le correzioni manuali con un motivo (correzioni ripetute indicano una regola mancante) e rivedi la tabella dei sinonimi ogni volta che inserisci un nuovo fornitore.
Se i tuoi attributi nascono nei PDF dei fornitori, Doc2Shelf può occuparsi della fase di estrazione: legge schede tecniche, schede delle specifiche, SDS e cataloghi caricati, mantiene valori e unità esattamente come stampati con la pagina e una breve citazione come evidenza, e segnala i dati obbligatori mancanti. Le tue regole di normalizzazione si applicano poi durante la revisione, prima che il record alimenti inserzioni o bozze di dichiarazione.
Domande frequenti
- Che cosa sono gli attributi di prodotto?
- Gli attributi di prodotto sono proprietà con nome e valore che descrivono un prodotto, come materiale, colore, capacità, dimensioni o potenza nominale. Risiedono in campi strutturati, così, a differenza del testo di una descrizione, possono guidare filtri, tabelle delle specifiche, feed e requisiti di categoria.
- Qual è la differenza tra un attributo di prodotto e una variante?
- Un attributo è una qualsiasi proprietà di un prodotto. Una variante è una versione del prodotto che differisce per uno o più attributi tra cui l’acquirente sceglie, come taglia o colore. Questi attributi scelti sono le opzioni di variante; gli altri restano condivisi sul prodotto padre.
- Come estraggo gli attributi dalle descrizioni dei prodotti?
- Definisci prima gli attributi di destinazione e i valori ammessi, dividi il testo in frasi, individua i valori candidati e controlla per ciascuno qualificatori, negazioni e condizioni prima di assegnarlo a un attributo. Conferma su una scheda tecnica gli attributi che compaiono solo nei testi di marketing.
- Che cosa sono i codici unità della Raccomandazione 20 dell’UNECE?
- Sono codici di tre caratteri per le unità di misura usate nel commercio internazionale, pubblicati dall’UN/CEFACT — ad esempio MTR per metro, KGM per chilogrammo, LTR per litro e WTT per watt. La proprietà unitCode di schema.org usa gli stessi codici.
- Devo salvare il valore originale o quello convertito?
- Entrambi. Salva il numero normalizzato e il codice unità per filtri, confronti e validazione, e conserva il valore come stampato per la tracciabilità. Converti nell’unità attesa da ciascun canale all’esportazione, ad esempio in grammi per il peso in un CSV prodotti di Shopify.
- Quale tassonomia di prodotto devo usare: GS1 GPC, ETIM o quella di Shopify?
- Usa quella richiesta dai tuoi partner commerciali e dai tuoi canali, e spesso più di una. Mantieni il tuo schema di attributi come riferimento principale e gestisci le mappature verso il GPC per lo scambio di dati retail, l’ETIM per il commercio all’ingrosso tecnico e la Standard Product Taxonomy di Shopify per un negozio Shopify.
- Come misuro la qualità dell’estrazione degli attributi?
- Confronta un campione di record estratti con i documenti di origine campo per campo e conta separatamente i valori corretti, errati e mancanti per ciascun attributo. I valori errati indicano problemi di precisione; i valori mancanti indicano problemi di recall. Monitora entrambi per fornitore.
- Come gestisco gli attributi di prodotto in più lingue?
- Salva i valori enumerati come colori e materiali come codici indipendenti dalla lingua con etichette tradotte e mantieni numeri e codici unità indipendenti dalla lingua. Gli attributi in testo libero richiedono traduzione e revisione per ciascuna lingua.
Fonti ufficiali
Testi giuridici primari e indicazioni ufficiali citati in questa guida.
- GTIN Management Standard — regole per l’assegnazione dei GTIN (GS1)
- Come calcolare manualmente una cifra di controllo (GS1)
Questa guida fornisce informazioni di carattere generale e non costituisce consulenza legale. I requisiti dipendono dal prodotto e dal mercato; consulta i testi ufficiali e rivolgiti a un professionista qualificato per la tua situazione.