Gids

Productkenmerken: extraheren, normaliseren en koppelen

Schone productkenmerken zorgen ervoor dat filters, vergelijkingen, feeds en conceptdocumenten voor compliance werken. Deze gids behandelt het schema, de extractie, de regels voor eenheden en vocabulaire en de koppeling aan taxonomieën waarmee rommelige leveranciersgegevens consistente data worden.

Elke leverancier beschrijft hetzelfde anders. Het ene datablad zegt „Inhoud: 1,5 l”, een ander „1500 ml”, en een derde verstopt „bevat 1.5 liter” in een alinea. Voor een shopper is dit één feit; voor een filter of feed zijn het drie losstaande tekenreeksen. Normalisatie van productkenmerken zet die variaties om in één waarde, in één eenheid, onder één kenmerknaam.

Deze gids volgt de volgorde waarin het werk in de praktijk verloopt: schema, extractie, normalisatie van getallen en tekst, koppeling aan taxonomieën, varianten en validatie. De voorbeelden gebruiken echte eenheidscodes en taxonomiestructuren, zodat u ze rechtstreeks kunt overnemen.

Wat productkenmerken zijn (en wat niet)

Een productkenmerk is een benoemde eigenschap met een waarde: material = roestvrij staal, capacity = 1.5 L, color = zwart. In onderzoek naar kenmerkextractie heten dit attribuut-waardeparen. Kenmerken beschrijven het product zelf en blijven waar, waar het ook wordt verkocht; daarom horen ze in gestructureerde velden en niet alleen in de lopende tekst van een beschrijving.

Drie verwante begrippen worden gemakkelijk met kenmerken verward, en het door elkaar halen ervan veroorzaakt later de meeste schemaproblemen:

Kenmerken vergeleken met verwante productgegevens
BegripDoelVoorbeeldGebruikelijke plaats
KenmerkBeschrijft een eigenschap van het productMateriaal: roestvrij staal; Inhoud: 1.5 LSpecificatietabel, filters, categorievelden
IdentificatiecodeIdentificeert het product of handelsitem eenduidigGTIN, MPN, SKU, modelnummerSpeciale velden voor identificatiecodes
VariantoptieEen kenmerk waartussen de koper kiestKleur: zwart / wit; Maat: S / M / LVariantassen (Shopify staat maximaal 3 opties toe)
BeschrijvingLegt voordelen en gebruik uit in lopende tekst„Kookt een volle waterkoker in enkele minuten”Beschrijving en opsommingstekens

Definieer het kenmerkschema voordat u iets extraheert

Een kenmerkschema is het contract waaraan elke waarde moet voldoen. Zonder schema levert extractie op wat de bron toevallig zegt en wordt normalisatie gokwerk. Bepaal per kenmerk de naam, het gegevenstype, de canonieke eenheid, de toegestane waarden of validatieregel, of er meerdere waarden in mogen en waar het verplicht is.

Houd het schema per productfamilie bij in plaats van één gigantische lijst: een waterkoker heeft inhoud en nominaal vermogen nodig, een T-shirt vezelsamenstelling en maat. Begin met de kenmerken die uw kanalen vereisen en waarop uw shoppers filteren, en voeg daarna de technische kenmerken toe die uw databladen betrouwbaar leveren.

Voorbeeld van een kenmerkschema voor een familie elektrische waterkokers
KenmerkGegevenstypeEenheid / notatieToegestane waarden of regelVerplicht
model_numberTekst—Zoals afgedrukt door de fabrikant; geen spaties toegevoegdJa
gtinTekst (cijfers)8, 12, 13 of 14 cijfersGeldig GS1-controlecijferIndien toegekend
capacityDecimaalLTR (liter)0,1 tot 5,0; één waarde per variantJa
rated_power_min / rated_power_maxGeheel getalWTT (watt)min ≤ max; beide uit dezelfde vermogensregelJa
body_materialEnum (meerdere waarden)—roestvrij staal, glas, kunststof, keramiekJa
colorEnum—Lijst met basiskleuren; commerciële naam apart opgeslagenJa, per variant
net_weightDecimaalKGM (kilogram)> 0; mag het brutogewicht niet overschrijdenVoor verzending

Waar kenmerkwaarden vandaan komen en welke bron voorrang heeft

Waarden komen meestal uit meerdere bronnen die het niet altijd eens zijn. Stel per kenmerk een bronprioriteit vast, zodat conflicten consistent worden opgelost en niet door wie het record het laatst bewerkt.

Een praktische standaard: technische documenten gaan voor marketingtekst, en het specifieke document gaat voor het algemene. Als gelijkwaardige bronnen elkaar tegenspreken — bijvoorbeeld een datablad en verpakking met verschillende gewichten — neem dan niet het gemiddelde en kies er niet een; vraag de leverancier welke actueel is.

  • Databladen en specificatiebladen: de betrouwbaarste bron voor afmetingen, nominale waarden, materialen en prestatiewaarden, meestal in tabellen.
  • Verpakking en labelontwerpen: gezaghebbend voor wat op de verpakking staat, zoals nettohoeveelheid, waarschuwingen en markeringen.
  • Veiligheidsinformatiebladen: gevarenclassificatie, samenstelling en fysische eigenschappen van chemische producten; geen marketingkenmerken.
  • Productbeschrijvingen van leveranciers: nuttig voor kenmerken die nooit in een tabel staan (stijl, beoogd gebruik, compatibele modellen), maar het minst nauwkeurig.

Kenmerken uit productbeschrijvingen extraheren

Vrije tekstbeschrijvingen zijn de moeilijkste bron, omdat waarden in zinnen zijn verpakt, door marketingtaal worden genuanceerd en soms worden ontkend. Of u nu regels, een woordenboek met bekende waarden of een taalmodel gebruikt, de werkwijze die de uitvoer betrouwbaar houdt, is dezelfde:

  1. Maak een lijst van de doelkenmerken voor de productfamilie, met hun toegestane waarden en eenheden, voordat u tekst leest.
  2. Splits de tekst in zinnen en opsommingstekens en zoek kandidaatwaarden: getallen met eenheden, bekende vocabulairetermen en patronen zoals „compatibel met …”.
  3. Controleer de context van elke kandidaat op kwalificaties („tot”, „ca.”, „vanaf”), ontkenningen („BPA-vrij”, „niet geschikt voor”) en voorwaarden („met deksel”, „bij 20 °C”).
  4. Wijs elke waarde aan precies één kenmerk toe; kan een getal bij twee kenmerken horen, laat het dan voor beoordeling ongekoppeld in plaats van te gokken.
  5. Normaliseer de waarde en eenheid volgens de regels in de volgende onderdelen en bewaar de oorspronkelijke tekst ernaast.
  6. Markeer elk kenmerk dat alleen uit marketingtekst komt, zodat een beoordelaar het aan de hand van een datablad kan bevestigen voordat het in een specificatietabel of conceptverklaring wordt gebruikt.
Uitgewerkt voorbeeld: kenmerken uit één zin van een beschrijving
Tekst in de beschrijvingKenmerkGeëxtraheerde waardeOpmerking
„…een roestvrijstalen waterkoker van 1,7 liter…”capacity; body_material1.7 LTR; roestvrij staalTwee kenmerken in één zinsdeel
„…met een BPA-vrij kunststof deksel…”lid_material; bpa_freekunststof; trueOntkenning wordt een boolean, geen materiaal
„…niet geschikt voor inductiekookplaten…”induction_compatiblefalseOntkennende bewering omgekeerd
„…verkrijgbaar in mat zwart en crème…”color (variantoptie)zwart; beigeCommerciële namen apart bewaard

Kopteksten van databladen koppelen aan canonieke kenmerknamen

Elke fabrikant benoemt hetzelfde kenmerk anders, vaak in de eigen taal. Bouw een synoniementabel die de kopteksten die u daadwerkelijk tegenkomt koppelt aan uw canonieke kenmerknaam; die groeit aanvankelijk snel, stabiliseert dan en wordt uw meest herbruikbare normalisatiemiddel. Leg ook de eenheid vast die in de kop staat: onder „Gewicht (lbs)” herhaalt geen enkele cel de eenheid. Tabelopmaak, scans en OCR komen aan bod in de gids over het extraheren van productgegevens uit pdf’s.

Synoniemen van kopteksten gekoppeld aan één canoniek kenmerk
Kop zoals afgedruktCanoniek kenmerkEenheid die uit de kop volgtOpmerking
Nominaal vermogen / Opgenomen vermogen / Leistungrated_powerWTTControleer of het ingangsvermogen is bedoeld en niet het uitgangsvermogen
Nettogewicht / Gewicht (eenheid) / Net weightnet_weightKGM of LBR, zoals afgedruktNiet het verzendgewicht
Inhoud / Volume / FassungsvermögencapacityLTR of MLTVoor houders, niet het volume van de verpakking
Afmetingen (B × D × H) mmwidth, depth, heightMMTVolgorde van de assen overgenomen uit de kop

Getallen en eenheden normaliseren

Sla elk kwantitatief kenmerk op als twee velden: een getal en een eenheidscode. Aanbeveling nr. 20 van UN/CEFACT („Codes for Units of Measure Used in International Trade”, codes voor meeteenheden in het internationale handelsverkeer) biedt hiervoor gangbare codes van drie tekens, en schema.org gebruikt dezelfde codes in de eigenschap unitCode, bijvoorbeeld een QuantitativeValue van 25 met unitCode CMT. Het gebruik van deze codes in plaats van vrije teksteenheden („cm”, „cms”, „centimeters”) voorkomt een hele categorie afwijkingen.

Kies per kenmerk één canonieke eenheid, meestal de SI-eenheid of een decimaal veelvoud daarvan, en reken om bij import, zodat waarden over leveranciers heen goed vergelijkbaar zijn. Bewaar de oorspronkelijke waarde en eenheid zoals afgedrukt voor de herleidbaarheid en reken bij export terug naar de eenheden van het kanaal: een Shopify-product-CSV verwacht het gewicht in gram, terwijl WooCommerce de gewichts- en afmetingseenheden gebruikt die in de winkel zijn ingesteld.

Let op de details die stille fouten veroorzaken. Decimale tekens en scheidingstekens voor duizendtallen hangen af van de taalregio van het document: op een Duits datablad is „1.000 W” duizend watt. Splits bereiken in minimum- en maximumvelden, sla toleranties los van de nominale waarde op en bewaar kwalificaties zoals „ca.” of „max.” in een eigen veld. Imperiale omrekeningen gebruiken exacte definities (1 inch = 25,4 mm; 1 lb = 0,45359237 kg); rond één keer af, op het moment van weergave.

Ruwe leverancierswaarden en hun genormaliseerde vorm
Ruwe waarde zoals afgedruktGenormaliseerde waardeUNECE Rec 20-codeToegepaste regel
1,5 l1.5LTRDecimale komma gelezen volgens de taalregio van het document
1500 ml1.5LTROmgerekend naar de canonieke eenheid van het kenmerk; origineel bewaard
1.000 W (Duits datablad)1000WTTPunt gelezen als scheidingsteken voor duizendtallen
220–240 V~min. 220, max. 240VLTBereik gesplitst; „~” opgeslagen als stroomsoort AC
Ø 12 mm ± 0,2nominaal 12, tolerantie 0.2MMTTolerantie apart opgeslagen
ca. 2,3 kg2.3 (kwalificatie: bij benadering)KGMKwalificatie bewaard, niet weggelaten
5 lb2.26796KGMOmgerekend met 0,45359237; origineel in LBR bewaard
1/2 inch12.7MMTBreuk omgezet; origineel in INH bewaard
Verpakking van 66H87Aantal stuks per verpakking

Gebruik gecontroleerde vocabulaires voor tekstkenmerken

Een gecontroleerd vocabulaire is de lijst met waarden die een tekstkenmerk kan aannemen, plus de synoniemen die op elke waarde worden afgebeeld. Zo vangt een filter „Kleur: zwart” ook producten die zijn beschreven als „blk”, „Black” en „schwarz”.

Houd twee velden aan waar marketing en filteren verschillende kanten op trekken: een genormaliseerde basiswaarde voor filters en feeds, en de eigen naam van de fabrikant voor weergave. „Midnight Graphite” is een mooi detail voor een productpagina en een nutteloze filterwaarde; „grijs” is het omgekeerde. Sla bij meertalige catalogi vocabulairewaarden op als taalneutrale codes en vertaal de labels, zodat hetzelfde product in elke taal van de winkel goed filtert.

Tekstwaarden vóór en na normalisatie van het vocabulaire
Ruwe tekstwaardeGenormaliseerde waardeVocabulairegregel
blk / ZWART / schwarzzwartSynoniemen en vertalingen worden afgebeeld op één code
Middernachtgrafietgrijs (weergavenaam bewaard)Commerciële naam apart opgeslagen
18/8 RVSroestvrij staalAfkorting uitgeschreven; kwaliteit als eigen kenmerk bewaard
Katoen 95%, elastaan 5%katoen 95; elastaan 5Samenstelling als waarde-percentagekoppels
Ja / ✓ / inbegrepentrueBooleaanse waarden teruggebracht tot true of false

Kenmerken koppelen aan taxonomieën en kanaalschema’s

Een taxonomie bepaalt welke kenmerken voor een product gelden en hoe ze heten. U kunt er zelden zelf een kiezen: een retailer vraagt misschien om GS1 GPC, een groothandel om ETIM, Shopify om zijn Standard Product Taxonomy, en zoekmachines lezen schema.org-markup. Houd uw eigen kenmerkschema als hoofdschema aan en onderhoud een koppeling met elke externe taxonomie.

In GS1 GPC is de brick de bouwsteen, en brick-kenmerken bevatten details zoals of een melk dierlijk of niet-dierlijk is. ETIM geeft elke klasse een vooraf gedefinieerde set kenmerken met vaste waardelijsten en eenheden en publiceert zijn model in 17 talen. Shopify vraagt om één categorie, gekozen op de hoofdfunctie van het product; het instellen ervan ontgrendelt categoriemetavelden. schema.org Product heeft speciale eigenschappen zoals gtin, mpn, brand, color, material, size en weight.

Productentaxonomieën vergeleken
TaxonomieBelangrijkste gebruikersStructuurKenmerkmodelLet op
GS1 GPCGegevensuitwisseling voor retail en consumentengoederenSegment > Familie > Klasse > BrickBrick-kenmerken met gedefinieerde waardenClassificatie, geen volledig specificatiemodel
ETIMTechnische groothandel: elektra, hvac, sanitairKlassen met synoniemenKenmerken getypeerd als alfanumeriek, logisch, numeriek of bereik, met eenhedenKenmerkwaarden moeten uit de klassenlijsten komen
Standard Product Taxonomy van ShopifyShopify-winkelsCategoriepad (breadcrumb) of categorie-IDCategoriemetavelden (productkenmerken) per categorieGeef in de CSV het pad of de ID op, niet allebei
schema.org ProductGestructureerde gegevens voor zoekmachinesEén Product-type met eigenschappenSpeciale eigenschappen; QuantitativeValue met unitCodeGebruik specifieke eigenschappen vóór additionalProperty

Varianten verwerken zonder kenmerken te dupliceren

Varianten zijn producten die de meeste kenmerken delen en op enkele verschillen. Modelleer ze als een bovenliggend record met de gedeelde kenmerken en onderliggende records met alleen de variantassen en de waarden die daarmee veranderen, zoals kleur, maat, inhoud en hun eigen identificatiecodes. De GTIN-regels van GS1 behandelen elke stijl-, kleur- en maatvariatie als een uniek product met een eigen GTIN, dus de identificatiecode hoort altijd bij het onderliggende record.

Tabellen met meerdere modellen veroorzaken de meeste variantfouten. Splits een tabel met één kolom per model in één record per kolom en kopieer elke waarde die één keer over kolommen heen staat afgedrukt — een samengevoegde cel of „alle modellen: 230 V” onder de tabel — naar elk onderliggend record waarvoor ze geldt. In Shopify koppelt de CSV-kolom Option1 LinkedTo een variantoptie aan een categoriemetaveld; een product kan tot drie opties en 2.048 varianten hebben.

Kenmerken valideren met regels en QA-steekproeven

Validatieregels vangen mechanische fouten op: verkeerd type, verkeerde eenheid, onmogelijke waarde, ontbrekend verplicht kenmerk. Voer ze uit bij elke import en stuur mislukkingen naar een beoordelaar in plaats van waarden stilzwijgend te laten vallen.

Regels kunnen een aannemelijke maar foute waarde niet opvangen — een inhoud die uit de kolom van het naastgelegen model is overgenomen, slaagt voor elke controle. Een QA-steekproef wel: vergelijk steekproefsgewijs geselecteerde records veld voor veld met de brondocumenten. Er bestaat geen universele steekproefomvang of foutdrempel; bepaal die naar risico.

  1. Trek per leverancier een steekproef van records, met extra gewicht voor nieuwe leveranciers en nieuwe documentopmaak.
  2. Vergelijk elk kenmerk uit de steekproef met de bron en leg overeenkomsten, foute waarden en ontbrekende waarden apart vast.
  3. Bereken foutpercentages per kenmerk, niet alleen per record, om de kenmerken of koptoewijzingen te vinden die problemen veroorzaken.
  4. Controleer voor de veiligheid relevante en wettelijk vereiste kenmerken op elk record, niet op een steekproef.
Soorten validatieregels met voorbeelden
Soort regelVoorbeeldActie bij mislukking
Type en notatiecapacity moet een decimaal getal zijn; gtin alleen cijfersWaarde afwijzen, ruwe tekst bewaren voor beoordeling
Bereik en aannemelijkheidinhoud van een waterkoker tussen 0,1 en 5 LMarkeren als waarschijnlijke fout in eenheid of scheidingsteken
Lidmaatschap van een enumcolor moet in de lijst met basiskleuren staanHet synoniem koppelen of aan het vocabulaire toevoegen
Tussen veldenmin ≤ max; nettogewicht ≤ brutogewichtBeide velden markeren
ControlecijferGTIN slaagt voor de GS1 mod-10-controleAfwijzen; opnieuw uit de bron lezen
Volledigheidalle verplichte kenmerken voor de familie en het kanaal ingevuldPublicatie blokkeren; gegevens opvragen bij de leverancier

Kenmerknormalisatie op schaal uitvoeren

Het schema, de synoniementabellen, de vocabulaires en de regels vormen het blijvende deel van dit werk; de extractiemethode kan eronder veranderen. Geef ze versies, wijs een eigenaar aan, log handmatige correcties met een reden (herhaalde correcties wijzen op een ontbrekende regel) en beoordeel de synoniementabel telkens wanneer een nieuwe leverancier wordt toegevoegd.

Als uw kenmerken in leveranciers-pdf’s beginnen, kan Doc2Shelf de extractiestap uitvoeren: het leest geüploade databladen, specificatiebladen, SDS en catalogi, bewaart waarden en eenheden precies zoals afgedrukt met de pagina en een kort citaat als bewijs, en markeert ontbrekende verplichte gegevens. Uw normalisatieregels worden daarna tijdens de beoordeling toegepast, voordat het record vermeldingen of conceptverklaringen voedt.

Veelgestelde vragen

Wat zijn productkenmerken?
Productkenmerken zijn benoemde eigenschappen met waarden die een product beschrijven, zoals materiaal, kleur, inhoud, afmetingen of nominaal vermogen. Ze staan in gestructureerde velden, zodat ze anders dan beschrijvingstekst filters, specificatietabellen, feeds en categorievereisten kunnen aansturen.
Wat is het verschil tussen een productkenmerk en een variant?
Een kenmerk is elke eigenschap van een product. Een variant is een versie van het product die verschilt op een of meer kenmerken waartussen de koper kiest, zoals maat of kleur. Die gekozen kenmerken zijn de variantopties; de rest blijft gedeeld op het bovenliggende product.
Hoe haal ik kenmerken uit productbeschrijvingen?
Definieer eerst de doelkenmerken en toegestane waarden, splits de tekst in zinnen, zoek kandidaatwaarden en controleer elke waarde op kwalificaties, ontkenningen en voorwaarden voordat u haar aan een kenmerk toewijst. Bevestig kenmerken die alleen in marketingtekst voorkomen aan de hand van een datablad.
Wat zijn de eenheidscodes van UNECE-aanbeveling 20?
Het zijn codes van drie tekens voor meeteenheden die in de internationale handel worden gebruikt, gepubliceerd door UN/CEFACT — bijvoorbeeld MTR voor meter, KGM voor kilogram, LTR voor liter en WTT voor watt. De eigenschap unitCode van schema.org gebruikt dezelfde codes.
Moet ik de oorspronkelijke waarde of de omgerekende waarde opslaan?
Beide. Sla het genormaliseerde getal en de eenheidscode op voor filteren, vergelijken en valideren, en bewaar de waarde zoals afgedrukt voor de herleidbaarheid. Reken bij export om naar de verwachte eenheid van elk kanaal, bijvoorbeeld gram voor gewicht in een Shopify-product-CSV.
Welke productentaxonomie moet ik gebruiken: GS1 GPC, ETIM of die van Shopify?
Gebruik degene waar uw handelspartners en kanalen om vragen, en vaak meer dan één. Houd uw eigen kenmerkschema als hoofdschema aan en onderhoud koppelingen met GPC voor gegevensuitwisseling in de retail, ETIM voor de technische groothandel en de Standard Product Taxonomy van Shopify voor een Shopify-winkel.
Hoe meet ik de kwaliteit van kenmerkextractie?
Vergelijk een steekproef van geëxtraheerde records veld voor veld met de brondocumenten en tel juiste, foute en ontbrekende waarden per kenmerk apart. Foute waarden wijzen op precisieproblemen; ontbrekende waarden op recallproblemen. Houd beide bij per leverancier.
Hoe ga ik om met productkenmerken in meerdere talen?
Sla opgesomde waarden zoals kleuren en materialen op als taalneutrale codes met vertaalde labels, en houd getallen en eenheidscodes taalonafhankelijk. Vrijetekstkenmerken moeten per taal worden vertaald en beoordeeld.

Officiële bronnen

Primaire wettelijke teksten en officiële richtsnoeren waarnaar in deze gids wordt verwezen.

Deze gids bevat algemene informatie en is geen juridisch advies. De vereisten hangen af van het product en de markt; raadpleeg de officiële teksten en win gekwalificeerd advies in voor uw situatie.

Meer gidsen

Zet leveranciers-pdf’s om in gecontroleerde productgegevens

Doc2Shelf haalt productgegevens uit leveranciersdocumenten en stelt vermeldingen en compliancedocumenten op als concept, ter beoordeling door u.

Maak uw gratis account aan