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:

Attributi a confronto con altri dati di prodotto
ConcettoScopoEsempioCollocazione tipica
AttributoDescrive una proprietà del prodottoMateriale: acciaio inossidabile; Capacità: 1,5 LTabella delle specifiche, filtri, campi di categoria
IdentificativoDenomina in modo univoco il prodotto o l’articolo commercialeGTIN, MPN, SKU, numero di modelloCampi identificativi dedicati
Opzione di varianteUn attributo tra cui l’acquirente sceglieColore: nero / bianco; Taglia: S / M / LAssi delle varianti (Shopify consente fino a 3 opzioni)
DescrizioneSpiega 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.

Esempio di schema di attributi per una famiglia di bollitori elettrici
AttributoTipo di datoUnità / formatoValori ammessi o regolaObbligatorio
model_numberTesto—Come stampato dal fabbricante; senza spazi aggiuntiSì
gtinTesto (cifre)8, 12, 13 o 14 cifreCifra di controllo GS1 validaSe assegnato
capacityDecimaleLTR (litro)Da 0,1 a 5,0; un valore per varianteSì
rated_power_min / rated_power_maxInteroWTT (watt)min ≤ max; entrambi dalla stessa riga dei valori nominaliSì
body_materialEnum (multivalore)—stainless steel, glass, plastic, ceramicSì
colorEnum—Elenco dei colori di base; nome commerciale salvato separatamenteSì, per variante
net_weightDecimaleKGM (chilogrammo)> 0; non deve superare il peso lordoPer 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:

  1. Elenca gli attributi di destinazione per la famiglia di prodotti, con i relativi valori ammessi e unità, prima di leggere qualsiasi testo.
  2. 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 …”.
  3. 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”).
  4. 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.
  5. Normalizza valore e unità con le regole delle sezioni successive, conservando accanto il testo originale.
  6. 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.
Esempio pratico: attributi trovati in una frase di una descrizione
Testo nella descrizioneAttributoValore estrattoNota
“…un bollitore in acciaio inossidabile da 1,7 litri…”capacity; body_material1.7 LTR; stainless steelDue attributi in un’unica espressione
“…con coperchio in plastica senza BPA…”lid_material; bpa_freeplastic; trueLa negazione diventa un booleano, non un materiale
“…non adatto ai piani a induzione…”induction_compatiblefalseAffermazione negata invertita
“…disponibile in nero opaco e crema…”color (opzione di variante)black; beigeNomi 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.

Sinonimi delle intestazioni associati a un unico attributo canonico
Intestazione come stampataAttributo canonicoUnità implicita nell’intestazioneNota
Potenza nominale / Potenza assorbita / Leistungrated_powerWTTVerifica che sia la potenza in ingresso, non in uscita
Peso netto / Peso (unità) / Nettogewichtnet_weightKGM o LBR, come stampatoNon il peso di spedizione
Capacità / Volume / FassungsvermögencapacityLTR o MLTPer i contenitori, non il volume della confezione
Dimensioni (L × P × A) mmwidth, depth, heightMMTOrdine 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.

Valori grezzi dei fornitori e relativa forma normalizzata
Valore grezzo come stampatoValore normalizzatoCodice UNECE Rec. 20Regola applicata
1,5 l1.5LTRVirgola decimale interpretata secondo le convenzioni del documento
1500 ml1.5LTRConvertito nell’unità canonica dell’attributo; originale conservato
1.000 W (scheda tecnica tedesca)1000WTTPunto interpretato come separatore delle migliaia
220–240 V~min 220, max 240VLTIntervallo diviso; “~” salvato come tipo di corrente AC
Ø 12 mm ± 0,2nominal 12, tolerance 0.2MMTTolleranza salvata separatamente
ca. 2,3 kg2.3 (qualifier: approximate)KGMQualificatore conservato, non scartato
5 lb2.26796KGMConvertito con 0,45359237; originale LBR conservato
1/2 in12.7MMTFrazione risolta; originale INH conservato
Confezione da 66H87Numero 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.

Valori testuali prima e dopo la normalizzazione del vocabolario
Valore testuale grezzoValore normalizzatoRegola del vocabolario
blk / BLACK / schwarzblackSinonimi e traduzioni sono associati a un unico codice
Midnight Graphitegray (nome visualizzato conservato)Nome commerciale salvato separatamente
18/8 SSstainless steelAbbreviazione espansa; qualità mantenuta come attributo a sé
Cotone 95%, elastan 5%cotton 95; elastane 5Composizione come coppie valore–percentuale
Sì / ✓ / inclusotrueValori 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.

Confronto tra tassonomie di prodotto
TassonomiaPrincipali utilizzatoriStrutturaModello degli attributiDa tenere presente
GS1 GPCScambio di dati per retail e beni di largo consumoSegment > Family > Class > BrickAttributi del brick con valori definitiClassificazione, non un modello completo di specifiche
ETIMCommercio all’ingrosso tecnico: elettrico, HVAC, idraulicaClassi con sinonimiCaratteristiche tipizzate come alfanumeriche, logiche, numeriche o intervallo, con unitàI valori delle caratteristiche devono provenire dagli elenchi della classe
Shopify Standard Product TaxonomyNegozi ShopifyPercorso della categoria o ID categoriaMetacampi della categoria (attributi di prodotto) per categoriaNel CSV indica il percorso o l’ID, non entrambi
schema.org ProductDati strutturati per i motori di ricercaUn unico tipo Product con proprietàProprietà dedicate; QuantitativeValue con unitCodeUsa 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.

  1. Estrai un campione di record per fornitore, dando più peso ai nuovi fornitori e ai nuovi layout di documento.
  2. Confronta ogni attributo campionato con la fonte, registrando separatamente corrispondenze, valori errati e valori mancanti.
  3. Calcola i tassi di errore per attributo, non solo per record, per individuare gli attributi o le mappature delle intestazioni che causano problemi.
  4. Controlla gli attributi rilevanti per la sicurezza e quelli richiesti dalla legge su ogni record, non a campione.
Tipi di regole di validazione con esempi
Tipo di regolaEsempioAzione in caso di errore
Tipo e formatocapacity deve essere un decimale; gtin solo cifreRifiutare il valore, conservare il testo grezzo per la revisione
Intervallo e plausibilitàcapacità del bollitore tra 0,1 e 5 LSegnalare come probabile errore di unità o di separatore
Appartenenza all’enumcolor deve essere nell’elenco dei colori di baseAssociare il sinonimo o aggiungerlo al vocabolario
Tra più campimin ≤ max; peso netto ≤ peso lordoSegnalare entrambi i campi
Cifra di controlloIl GTIN supera il controllo mod-10 di GS1Rifiutare; rileggere dalla fonte
Completezzatutti gli attributi obbligatori per la famiglia e il canale sono compilatiBloccare 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.

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.

Altre guide

Trasforma i PDF dei fornitori in dati di prodotto verificati

Doc2Shelf estrae i dati di prodotto dai documenti dei fornitori e prepara bozze di inserzioni e documenti di conformità da sottoporre alla tua revisione.

Crea il tuo account gratuito