Guide
Produktattributter: sådan udtrækker, normaliserer og mapper du dem
Rene produktattributter er det, der får filtre, sammenligninger, feeds og compliance-udkast til at fungere. Denne guide gennemgår skemaet, udtrækket, reglerne for enheder og ordforråd og taksonomimappingen, der omdanner rodede leverandørværdier til ensartede data.
Hver leverandør beskriver det samme på sin egen måde. Ét datablad skriver »Capacity: 1,5 l«, et andet »1500 ml«, et tredje gemmer »holds 1.5 liters« i et afsnit. For en kunde er det én kendsgerning; for et filter eller et feed er det tre urelaterede tekststrenge. Normalisering af produktattributter omdanner disse variationer til én værdi, i én enhed, under ét attributnavn.
Denne guide følger den rækkefølge, arbejdet foregår i i praksis: skema, udtræk, normalisering af tal og tekst, taksonomimapping, varianter og validering. Eksemplerne bruger rigtige enhedskoder og taksonomistrukturer, så du kan tilpasse dem direkte.
Hvad produktattributter er (og hvad de ikke er)
En produktattribut er en navngiven egenskab med en værdi: material = stainless steel, capacity = 1.5 L, color = black. Forskning i attributudtræk kalder dem attribut-værdi-par. Attributter beskriver selve produktet og forbliver sande, uanset hvor det sælges, og derfor hører de hjemme i strukturerede felter og ikke kun i beskrivelsens brødtekst.
Tre nærtliggende begreber er lette at forveksle med attributter, og når de blandes sammen, skaber det de fleste skemaproblemer senere:
| Begreb | Formål | Eksempel | Typisk placering |
|---|---|---|---|
| Attribut | Beskriver en egenskab ved produktet | Materiale: rustfrit stål; Kapacitet: 1,5 l | Specifikationstabel, filtre, kategorifelter |
| Identifikator | Navngiver produktet eller handelsenheden entydigt | GTIN, MPN, SKU, modelnummer | Dedikerede identifikatorfelter |
| Variantvalg | En attribut, som køberen vælger imellem | Farve: sort / hvid; Størrelse: S / M / L | Variantakser (Shopify tillader op til 3 valg) |
| Beskrivelse | Forklarer fordele og brug i løbende tekst | »Koger en fuld kedel på få minutter« | Beskrivelse og punkttegn |
Definér attributskemaet, før du udtrækker noget
Et attributskema er den kontrakt, hver værdi skal opfylde. Uden det udtrækker man, hvad kilden tilfældigvis siger, og normalisering bliver gætværk. For hver attribut skal du beslutte navn, datatype, kanonisk enhed, tilladte værdier eller valideringsregel, om den kan indeholde flere værdier, og hvor den er påkrævet.
Hold skemaet pr. produktfamilie frem for én gigantisk liste: en kedel har brug for kapacitet og mærkeeffekt, en T-shirt har brug for fibersammensætning og størrelse. Start med de attributter, dine kanaler kræver, og som dine kunder filtrerer på, og tilføj derefter de tekniske attributter, som dine datablade pålideligt leverer.
| Attribut | Datatype | Enhed / format | Tilladte værdier eller regel | Påkrævet |
|---|---|---|---|---|
| model_number | Tekst | — | Som trykt af producenten; ingen mellemrum tilføjet | Ja |
| gtin | Tekst (cifre) | 8, 12, 13 eller 14 cifre | Gyldigt GS1-kontrolciffer | Hvis tildelt |
| capacity | Decimal | LTR (liter) | 0,1 til 5,0; én værdi pr. variant | Ja |
| rated_power_min / rated_power_max | Heltal | WTT (watt) | min ≤ maks.; begge fra den samme mærkedatalinje | Ja |
| body_material | Enum (flere værdier) | — | stainless steel, glass, plastic, ceramic | Ja |
| color | Enum | — | Liste over basisfarver; markedsføringsnavn gemmes separat | Ja, pr. variant |
| net_weight | Decimal | KGM (kilogram) | > 0; må ikke overstige bruttovægten | Til forsendelse |
Hvor attributværdier kommer fra, og hvilken kilde der vinder
Værdier kommer som regel fra flere kilder, som ikke altid er enige. Fastsæt en kildeprioritet pr. attribut, så konflikter løses ensartet og ikke af den, der redigerer posten sidst.
Et praktisk udgangspunkt: tekniske dokumenter vinder over markedsføringstekst, og det specifikke dokument vinder over det generelle. Når ligeværdige kilder er uenige — f.eks. når datablad og emballage angiver forskellige vægte — så beregn ikke et gennemsnit, og vælg ikke bare den ene; spørg leverandøren, hvilken der er gældende.
- Datablade og specifikationsark: den mest pålidelige kilde til dimensioner, mærkedata, materialer og ydeevneværdier, som regel i tabeller.
- Emballage og etiketgrafik: autoritativ for det, der er trykt på pakken, såsom nettomængde, advarsler og mærkninger.
- Sikkerhedsdatablade: fareklassificering, sammensætning og fysiske egenskaber for kemiske produkter; ikke markedsføringsattributter.
- Leverandørens produktbeskrivelser: nyttige til attributter, der aldrig optræder i en tabel (stil, tilsigtet brug, kompatible modeller), men den mindst præcise kilde.
Sådan udtrækker du attributter fra produktbeskrivelser
Frie tekstbeskrivelser er den sværeste kilde, fordi værdierne er pakket ind i sætninger, kvalificeret af markedsføringssprog og somme tider negeret. Uanset om du bruger regler, en ordbog over kendte værdier eller en sprogmodel, er fremgangsmåden, der holder outputtet troværdigt, den samme:
- List målattributterne for produktfamilien med deres tilladte værdier og enheder, før du læser nogen tekst.
- Del teksten op i sætninger og punkttegn, og find derefter kandidatværdier: tal med enheder, kendte ordforrådstermer og mønstre som »kompatibel med …«.
- Tjek konteksten for hver kandidat for forbehold (»op til«, »ca.«, »fra«), negationer (»BPA-fri«, »ikke egnet til«) og betingelser (»med låg«, »ved 20 °C«).
- Tildel hver værdi til netop én attribut; når et tal kan høre til to attributter, så lad det være utildelt til gennemgang i stedet for at gætte.
- Normalisér værdien og enheden efter reglerne i de følgende afsnit, og behold den oprindelige tekst ved siden af.
- Markér hver attribut, der kun stammer fra markedsføringstekst, så den, der gennemgår, kan bekræfte den mod et datablad, før den bruges i en specifikationstabel eller et erklæringsudkast.
| Tekst i beskrivelsen | Attribut | Udtrukket værdi | Bemærkning |
|---|---|---|---|
| »…en kedel i rustfrit stål på 1,7 liter…« | capacity; body_material | 1.7 LTR; stainless steel | To attributter i én frase |
| »…med et BPA-frit plastiklåg…« | lid_material; bpa_free | plastic; true | Negationen bliver til en boolsk værdi, ikke et materiale |
| »…ikke egnet til induktionskogeplader…« | induction_compatible | false | Negeret udsagn vendt om |
| »…fås i mat sort og creme…« | color (variantvalg) | black; beige | Markedsføringsnavne gemt separat |
Map databladets overskrifter til kanoniske attributnavne
Hver producent betegner den samme attribut forskelligt, ofte på sit eget sprog. Opbyg en synonymtabel, der mapper den overskriftstekst, du rent faktisk støder på, til dit kanoniske attributnavn; den vokser hurtigt i starten, stabiliserer sig derefter og bliver dit mest genbrugelige normaliseringsaktiv. Registrér også den enhed, der står i overskriften: under »Weight (lbs)« gentager ingen celle enheden. Tabellayouts, scanninger og OCR behandles i guiden om udtræk af produktdata fra PDF'er.
| Overskrift som trykt | Kanonisk attribut | Enhed, som overskriften angiver | Bemærkning |
|---|---|---|---|
| Rated power / Power consumption / Leistung / Effekt | rated_power | WTT | Kontrollér, at det er indgangseffekt, ikke udgangseffekt |
| Net weight / Weight (unit) / Nettogewicht / Nettovægt | net_weight | KGM eller LBR, som trykt | Ikke forsendelsesvægten |
| Capacity / Volume / Fassungsvermögen / Kapacitet | capacity | LTR eller MLT | For beholdere, ikke pakkens volumen |
| Dimensions (W × D × H) mm | width, depth, height | MMT | Aksernes rækkefølge hentet fra overskriften |
Normalisér tal og enheder
Gem hver kvantitativ attribut som to felter: et tal og en enhedskode. UN/CEFACT-anbefaling nr. 20 (»Codes for Units of Measure Used in International Trade«) giver trebogstavs fælleskoder til formålet, og schema.org bruger de samme koder i egenskaben unitCode, for eksempel en QuantitativeValue på 25 med unitCode CMT. Når du bruger disse koder i stedet for fritekstenheder (»cm«, »cms«, »centimeter«), fjerner du en hel klasse af uoverensstemmelser.
Vælg én kanonisk enhed pr. attribut, som regel SI-enheden eller et decimalt multiplum af den, og omregn ved import, så værdier kan sammenlignes korrekt på tværs af leverandører. Behold den oprindelige værdi og enhed som trykt af hensyn til sporbarheden, og omregn tilbage til kanalens enheder ved eksport: en Shopify-produkt-CSV forventer vægt i gram, mens WooCommerce bruger de vægt- og dimensionsenheder, der er konfigureret i butikken.
Vær opmærksom på de detaljer, der giver stille fejl. Decimal- og tusindseparatorer afhænger af dokumentets landestandard: på et tysk datablad er »1.000 W« et tusind watt. Del intervaller op i minimums- og maksimumsfelter, gem tolerancer adskilt fra nominalværdien, og behold forbehold som »ca.« eller »maks.« i deres eget felt. Imperiale omregninger bruger eksakte definitioner (1 tomme = 25,4 mm; 1 lb = 0,45359237 kg); afrund én gang, ved visning.
| Rå værdi som trykt | Normaliseret værdi | UNECE Rec 20-kode | Anvendt regel |
|---|---|---|---|
| 1,5 l | 1.5 | LTR | Decimalkomma læst ud fra dokumentets landestandard |
| 1500 ml | 1.5 | LTR | Omregnet til attributtens kanoniske enhed; originalen bevaret |
| 1.000 W (tysk datablad) | 1000 | WTT | Punktum læst som tusindseparator |
| 220–240 V~ | min. 220, maks. 240 | VLT | Interval delt op; »~« gemt som strømtypen AC |
| Ø 12 mm ± 0,2 | nominel 12, tolerance 0.2 | MMT | Tolerance gemt separat |
| ca. 2,3 kg | 2.3 (forbehold: omtrentlig) | KGM | Forbehold bevaret, ikke udeladt |
| 5 lb | 2.26796 | KGM | Omregnet med 0,45359237; original LBR bevaret |
| 1/2 in | 12.7 | MMT | Brøk omsat; original INH bevaret |
| Pakke med 6 | 6 | H87 | Antal stk. pr. pakke |
Brug kontrollerede ordforråd til tekstattributter
Et kontrolleret ordforråd er listen over de værdier, en tekstattribut kan antage, plus de synonymer, der mapper til hver af dem. Det gør, at et filter »Farve: black« fanger produkter, der er beskrevet som »blk«, »Black« og »schwarz«.
Hold to felter adskilt, hvor markedsføring og filtrering trækker i hver sin retning: en normaliseret basisværdi til filtre og feeds og producentens eget navn til visning. »Midnight Graphite« er en god detalje på produktsiden og en ubrugelig filterværdi; »gray« er det modsatte. For flersprogede kataloger skal du gemme ordforrådsværdier som sprogneutrale koder og oversætte deres etiketter, så det samme produkt filtreres korrekt på alle butikkens sprog.
| Rå tekstværdi | Normaliseret værdi | Ordforrådsregel |
|---|---|---|
| blk / BLACK / schwarz | black | Synonymer og oversættelser mappes til én kode |
| Midnight Graphite | gray (visningsnavn bevaret) | Markedsføringsnavn gemt separat |
| 18/8 SS | stainless steel | Forkortelse udvidet; kvalitet bevaret som sin egen attribut |
| Bomuld 95 %, elastan 5 % | cotton 95; elastane 5 | Sammensætning som par af værdi og procent |
| Ja / ✓ / medfølger | true | Booleske værdier reduceret til true eller false |
Map attributter til taksonomier og kanalskemaer
En taksonomi afgør, hvilke attributter der gælder for et produkt, og hvad de hedder. Du får sjældent selv lov at vælge: en forhandler kan bede om GS1 GPC, en grossist om ETIM, Shopify om sin Standard Product Taxonomy, og søgemaskiner læser schema.org-markup. Behold dit eget attributskema som master, og vedligehold en mapping til hver ekstern taksonomi.
I GS1 GPC er brick byggestenen, og brick-attributter rummer detaljer såsom, om en mælk er animalsk eller ikke-animalsk. ETIM giver hver klasse et foruddefineret sæt egenskaber med faste værdilister og enheder og udgiver sin model på 17 sprog. Shopify beder om én kategori, valgt efter produktets hovedfunktion; når den er sat, låses kategorimetafelter op. schema.org Product har dedikerede egenskaber som gtin, mpn, brand, color, material, size og weight.
| Taksonomi | Primære brugere | Struktur | Attributmodel | Vær opmærksom på |
|---|---|---|---|---|
| GS1 GPC | Udveksling af data for detailhandel og forbrugsvarer | Segment > Family > Class > Brick | Brick-attributter med definerede værdier | Klassifikation, ikke en fuld specifikationsmodel |
| ETIM | Teknisk grosshandel: el, HVAC, VVS | Klasser med synonymer | Egenskaber typet som alfanumerisk, logisk, numerisk eller interval, med enheder | Egenskabsværdier skal komme fra klassens lister |
| Shopify Standard Product Taxonomy | Shopify-butikker | Kategoristi eller kategori-ID | Kategorimetafelter (produktattributter) pr. kategori | I CSV angives enten stien eller ID'et, ikke begge |
| schema.org Product | Strukturerede data til søgemaskiner | Enkelt Product-type med egenskaber | Dedikerede egenskaber; QuantitativeValue med unitCode | Brug specifikke egenskaber før additionalProperty |
Håndtér varianter uden at duplikere attributter
Varianter er produkter, der deler de fleste attributter og adskiller sig på nogle få. Modellér dem som en forældrepost med de fælles attributter og børneposter, der kun rummer variantakserne og de værdier, der ændrer sig med dem, såsom farve, størrelse, kapacitet og deres egne identifikatorer. GS1's GTIN-regler behandler hver stil-, farve- og størrelsesvariation som et unikt produkt med sin egen GTIN, så identifikatoren hører altid hjemme på børneposten.
Specifikationstabeller med flere modeller giver de fleste variantfejl. Del en tabel med én kolonne pr. model op i én post pr. kolonne, og kopiér enhver værdi, der er trykt én gang på tværs af kolonner — en flettet celle eller »alle modeller: 230 V« under tabellen — til hver børnepost, den gælder for. I Shopify forbinder CSV-kolonnen Option1 LinkedTo et variantvalg med et kategorimetafelt; et produkt kan have op til tre valg og 2.048 varianter.
Valider attributter med regler og QA-stikprøver
Valideringsregler fanger mekaniske fejl: forkert type, forkert enhed, umulig værdi, manglende påkrævet attribut. Kør dem ved hver import, og send fejl videre til en, der gennemgår, i stedet for at lade værdier forsvinde stille.
Regler kan ikke fange en plausibel, men forkert værdi — en kapacitet kopieret fra nabomodellens kolonne består alle kontroller. QA-stikprøver kan: sammenlign udtrukne poster med kildedokumenterne felt for felt. Der findes ingen universel stikprøvestørrelse eller fejltærskel; fastsæt dem efter risiko.
- Træk en stikprøve af poster pr. leverandør, vægtet mod nye leverandører og nye dokumentlayouts.
- Sammenlign hver udtrukket attribut i stikprøven med kilden, og registrér match, forkerte værdier og manglende værdier hver for sig.
- Beregn fejlrater pr. attribut, ikke kun pr. post, for at finde de attributter eller overskriftsmappinger, der volder problemer.
- Kontrollér sikkerhedsrelevante og lovpligtige attributter på hver post, ikke på en stikprøve.
| Regeltype | Eksempel | Handling ved fejl |
|---|---|---|
| Type og format | capacity skal være et decimaltal; gtin kun cifre | Afvis værdien, behold rå tekst til gennemgang |
| Interval og plausibilitet | kedelkapacitet mellem 0,1 og 5 l | Markér som sandsynlig enheds- eller separatorfejl |
| Enum-medlemskab | color skal være på listen over basisfarver | Map synonymet, eller tilføj det til ordforrådet |
| På tværs af felter | min ≤ maks.; nettovægt ≤ bruttovægt | Markér begge felter |
| Kontrolciffer | GTIN består GS1's mod-10-kontrol | Afvis; genlæs fra kilden |
| Fuldstændighed | alle påkrævede attributter for familien og kanalen er udfyldt | Bloker publicering; anmod leverandøren om data |
Kør attributnormalisering i stor skala
Skemaet, synonymtabellerne, ordforrådene og reglerne er den varige del af dette arbejde; udtrækmetoden kan ændre sig under dem. Versionsstyr dem, giv hver en ejer, log manuelle rettelser med en begrundelse (gentagne rettelser viser en manglende regel), og gennemgå synonymtabellen, hver gang en ny leverandør onboardes.
Hvis dine attributter starter i leverandør-PDF'er, kan Doc2Shelf udføre udtrækstrinnet: det læser uploadede datablade, specifikationsark, sikkerhedsdatablade og kataloger, bevarer værdier og enheder nøjagtigt som trykt med siden og et kort citat som dokumentation og markerer manglende påkrævede data. Dine normaliseringsregler anvendes derefter under gennemgangen, før posten fodrer produktlister eller erklæringsudkast.
Ofte stillede spørgsmål
- Hvad er produktattributter?
- Produktattributter er navngivne egenskaber med værdier, der beskriver et produkt, såsom materiale, farve, kapacitet, dimensioner eller mærkeeffekt. De ligger i strukturerede felter, så de kan drive filtre, specifikationstabeller, feeds og kategorikrav, i modsætning til beskrivelsesteksten.
- Hvad er forskellen på en produktattribut og en variant?
- En attribut er enhver egenskab ved et produkt. En variant er en version af produktet, der adskiller sig på en eller flere attributter, som køberen vælger imellem, såsom størrelse eller farve. De valgte attributter er variantvalgene; resten forbliver fælles på forældreproduktet.
- Hvordan udtrækker jeg attributter fra produktbeskrivelser?
- Definér først målattributterne og de tilladte værdier, del teksten op i sætninger, find kandidatværdier, og kontrollér hver enkelt for forbehold, negationer og betingelser, før du tildeler den til en attribut. Bekræft attributter, der kun optræder i markedsføringstekst, mod et datablad.
- Hvad er UNECE Recommendation 20-enhedskoder?
- Det er trebogstavskoder for måleenheder, der bruges i international handel, udgivet af UN/CEFACT — for eksempel MTR for meter, KGM for kilogram, LTR for liter og WTT for watt. schema.orgs egenskab unitCode bruger de samme koder.
- Skal jeg gemme den oprindelige værdi eller den omregnede værdi?
- Begge. Gem det normaliserede tal og enhedskoden til filtrering, sammenligning og validering, og behold værdien som trykt af hensyn til sporbarheden. Omregn til hver kanals forventede enhed ved eksport, f.eks. gram for vægt i en Shopify-produkt-CSV.
- Hvilken produkttaksonomi skal jeg bruge: GS1 GPC, ETIM eller Shopifys?
- Brug den, dine samhandelspartnere og kanaler beder om, og ofte mere end én. Behold dit eget attributskema som master, og vedligehold mappinger til GPC for udveksling af detaildata, ETIM for teknisk grosshandel og Shopifys Standard Product Taxonomy for en Shopify-butik.
- Hvordan måler jeg kvaliteten af attributudtræk?
- Sammenlign et udsnit af udtrukne poster med kildedokumenterne felt for felt, og tæl korrekte, forkerte og manglende værdier hver for sig for hver attribut. Forkerte værdier peger på præcisionsproblemer; manglende værdier peger på recall-problemer. Følg begge pr. leverandør.
- Hvordan håndterer jeg produktattributter på flere sprog?
- Gem opregnede værdier såsom farver og materialer som sprogneutrale koder med oversatte etiketter, og hold tal og enhedskoder sproguafhængige. Fritekstattributter kræver oversættelse og gennemgang pr. sprog.
Officielle kilder
Primære retskilder og officiel vejledning, der henvises til i denne guide.
- GTIN Management Standard — regler for tildeling af GTIN'er (GS1)
- Sådan beregner du et kontrolciffer manuelt (GS1)
Denne guide er generel information og ikke juridisk rådgivning. Kravene afhænger af produktet og markedet; tjek de officielle tekster, og søg kvalificeret rådgivning til din situation.