Poradnik

Atrybuty produktów: jak je wyodrębniać, normalizować i mapować

Czyste atrybuty produktów sprawiają, że filtry, porównania, feedy i wersje robocze dokumentów zgodności działają. Ten poradnik omawia schemat, wyodrębnianie, reguły dotyczące jednostek i słownictwa oraz mapowanie na taksonomię, które zamieniają chaotyczne wartości od dostawców w spójne dane.

Każdy dostawca opisuje to samo inaczej. Jedna karta danych mówi „Capacity: 1,5 l”, druga „1500 ml”, a trzecia chowa „holds 1.5 liters” w akapicie. Dla kupującego to jeden fakt; dla filtra lub feedu — trzy niezwiązane ciągi znaków. Normalizacja atrybutów produktu zamienia te warianty w jedną wartość, w jednej jednostce, pod jedną nazwą atrybutu.

Ten poradnik podąża za kolejnością, w jakiej praca przebiega w praktyce: schemat, wyodrębnianie, normalizacja liczb i tekstu, mapowanie na taksonomię, warianty i walidacja. Przykłady używają prawdziwych kodów jednostek i struktur taksonomii, więc możesz je bezpośrednio dostosować.

Czym są atrybuty produktu (a czym nie są)

Atrybut produktu to nazwana właściwość z wartością: material = stal nierdzewna, capacity = 1.5 L, color = czarny. Badania nad wyodrębnianiem atrybutów nazywają je parami atrybut–wartość. Atrybuty opisują sam produkt i pozostają prawdziwe wszędzie, gdzie jest sprzedawany, dlatego należą do pól strukturalnych, a nie tylko do tekstu opisu.

Trzy sąsiednie pojęcia łatwo pomylić z atrybutami, a ich mieszanie powoduje większość późniejszych problemów ze schematem:

Atrybuty w porównaniu z powiązanymi danymi produktu
PojęcieCelPrzykładTypowe miejsce
AtrybutOpisuje właściwość produktuMateriał: stal nierdzewna; Pojemność: 1,5 LTabela specyfikacji, filtry, pola kategorii
IdentyfikatorJednoznacznie nazywa produkt lub jednostkę handlowąGTIN, MPN, SKU, numer modeluDedykowane pola identyfikatorów
Opcja wariantuAtrybut, między którymi kupujący wybieraKolor: czarny / biały; Rozmiar: S / M / LOsie wariantów (Shopify pozwala na maksymalnie 3 opcje)
OpisWyjaśnia korzyści i zastosowanie w formie tekstu„Zagotuje pełny czajnik w kilka minut”Opis i punkty wypunktowania

Zdefiniuj schemat atrybutów, zanim cokolwiek wyodrębnisz

Schemat atrybutów to umowa, którą musi spełniać każda wartość. Bez niego wyodrębnianie daje to, co akurat mówi źródło, a normalizacja staje się zgadywaniem. Dla każdego atrybutu zdecyduj o nazwie, typie danych, jednostce kanonicznej, dozwolonych wartościach lub regule walidacji, o tym, czy może przyjmować kilka wartości, i gdzie jest wymagany.

Prowadź schemat dla rodziny produktów, a nie jedną gigantyczną listę: czajnik potrzebuje pojemności i mocy znamionowej, a T-shirt — składu włókien i rozmiaru. Zacznij od atrybutów, których wymagają Twoje kanały i według których filtrują kupujący, a następnie dodaj atrybuty techniczne, które karty danych konsekwentnie zawierają.

Przykładowy schemat atrybutów dla rodziny czajników elektrycznych
AtrybutTyp danychJednostka / formatDozwolone wartości lub regułaWymagany
model_numberTekst—Tak jak wydrukował producent; bez dodawania spacjiTak
gtinTekst (cyfry)8, 12, 13 lub 14 cyfrPrawidłowa cyfra kontrolna GS1Jeśli przypisany
capacityLiczba dziesiętnaLTR (litr)0.1 do 5.0; jedna wartość na wariantTak
rated_power_min / rated_power_maxLiczba całkowitaWTT (wat)min ≤ max; obie z tego samego wiersza parametrów znamionowychTak
body_materialEnum (wiele wartości)—stal nierdzewna, szkło, tworzywo sztuczne, ceramikaTak
colorEnum—Lista kolorów podstawowych; nazwa marketingowa przechowywana osobnoTak, dla każdego wariantu
net_weightLiczba dziesiętnaKGM (kilogram)> 0; nie może przekraczać wagi bruttoDo wysyłki

Skąd pochodzą wartości atrybutów i które źródło wygrywa

Wartości zwykle napływają z kilku źródeł, które nie zawsze się zgadzają. Ustal priorytet źródeł dla każdego atrybutu, aby konflikty rozstrzygać spójnie, a nie według tego, kto ostatni edytował rekord.

Praktyczna zasada domyślna: dokumenty techniczne mają pierwszeństwo przed tekstem marketingowym, a dokument szczegółowy przed ogólnym. Gdy równorzędne źródła się różnią — na przykład karta danych i opakowanie podają różne wagi — nie uśredniaj ani nie wybieraj jednego; zapytaj dostawcę, które jest aktualne.

  • Karty danych i karty specyfikacji: najbardziej wiarygodne źródło wymiarów, parametrów znamionowych, materiałów i wartości parametrów użytkowych, zwykle w tabelach.
  • Opakowanie i projekty etykiet: miarodajne dla tego, co jest wydrukowane na opakowaniu, np. ilości netto, ostrzeżeń i oznaczeń.
  • Karty charakterystyki: klasyfikacja zagrożeń, skład i właściwości fizyczne produktów chemicznych; nie atrybuty marketingowe.
  • Opisy produktów od dostawców: przydatne dla atrybutów, które nigdy nie pojawiają się w tabeli (styl, przeznaczenie, kompatybilne modele), ale najmniej precyzyjne.

Jak wyodrębniać atrybuty z opisów produktów

Opisy w formie swobodnego tekstu to najtrudniejsze źródło, ponieważ wartości są owinięte w zdania, opatrzone językiem marketingowym, a czasem zanegowane. Niezależnie od tego, czy używasz reguł, słownika znanych wartości, czy modelu językowego, procedura, która zapewnia wiarygodność wyniku, jest taka sama:

  1. Zanim przeczytasz jakikolwiek tekst, wypisz docelowe atrybuty dla rodziny produktów wraz z dozwolonymi wartościami i jednostkami.
  2. Podziel tekst na zdania i punkty, a następnie znajdź wartości kandydujące: liczby z jednostkami, znane terminy ze słownika i wzorce takie jak „kompatybilny z …”.
  3. Sprawdź kontekst każdego kandydata pod kątem kwalifikatorów („do”, „ok.”, „od”), negacji („bez BPA”, „nie nadaje się do”) i warunków („z pokrywką”, „w 20 °C”).
  4. Przypisz każdą wartość do dokładnie jednego atrybutu; gdy liczba mogłaby należeć do dwóch atrybutów, zostaw ją nieprzypisaną do weryfikacji zamiast zgadywać.
  5. Znormalizuj wartość i jednostkę według reguł z kolejnych sekcji, zachowując obok oryginalny tekst.
  6. Oznacz każdy atrybut, który pochodzi wyłącznie z tekstu marketingowego, aby osoba weryfikująca mogła go potwierdzić z kartą danych, zanim zostanie użyty w tabeli specyfikacji lub wersji roboczej deklaracji.
Przykład praktyczny: atrybuty znalezione w jednym zdaniu opisu
Tekst w opisieAtrybutWyodrębniona wartośćUwaga
„…czajnik ze stali nierdzewnej o pojemności 1,7 litra…”capacity; body_material1.7 LTR; stal nierdzewnaDwa atrybuty w jednym wyrażeniu
„…z pokrywką z tworzywa bez BPA…”lid_material; bpa_freetworzywo sztuczne; trueNegacja staje się wartością logiczną, a nie materiałem
„…nie nadaje się do płyt indukcyjnych…”induction_compatiblefalseZdanie przeczące zostało odwrócone
„…dostępny w kolorach czarny mat i kremowy…”color (opcja wariantu)czarny; beżowyNazwy marketingowe przechowywane osobno

Mapuj nagłówki kart danych na kanoniczne nazwy atrybutów

Każdy producent oznacza ten sam atrybut inaczej, często we własnym języku. Zbuduj tabelę synonimów, która mapuje tekst nagłówków, na które faktycznie trafiasz, na Twoją kanoniczną nazwę atrybutu; na początku rośnie szybko, potem się stabilizuje i staje się Twoim najbardziej wielokrotnie używanym zasobem normalizacji. Zapisuj też jednostkę podaną w nagłówku: pod nagłówkiem „Weight (lbs)” żadna komórka nie powtarza jednostki. Układy tabel, skany i OCR omawia poradnik o wyodrębnianiu danych produktowych z plików PDF.

Synonimy nagłówków zmapowane na jeden atrybut kanoniczny
Nagłówek w oryginaleAtrybut kanonicznyJednostka wynikająca z nagłówkaUwaga
Moc znamionowa / Pobór mocy / Leistungrated_powerWTTSprawdź, czy to moc wejściowa, a nie wyjściowa
Masa netto / Waga (jednostka) / Nettogewichtnet_weightKGM lub LBR, jak wydrukowanoNie waga wysyłkowa
Pojemność / Objętość / FassungsvermögencapacityLTR lub MLTDla pojemników, nie objętość opakowania
Wymiary (szer. × głęb. × wys.) mmwidth, depth, heightMMTKolejność osi przyjęta z nagłówka

Normalizuj liczby i jednostki

Każdy atrybut ilościowy zapisuj jako dwa pola: liczbę i kod jednostki. Zalecenie nr 20 UN/CEFACT („Codes for Units of Measure Used in International Trade”) podaje w tym celu trzyznakowe kody powszechne, a schema.org używa tych samych kodów we właściwości unitCode, na przykład QuantitativeValue o wartości 25 z unitCode CMT. Używanie tych kodów zamiast jednostek w postaci swobodnego tekstu („cm”, „cms”, „centymetry”) eliminuje całą klasę niezgodności.

Wybierz jedną jednostkę kanoniczną dla każdego atrybutu, zwykle jednostkę SI lub jej dziesiętną wielokrotność, i przeliczaj przy imporcie, aby wartości można było poprawnie porównywać między dostawcami. Zachowaj oryginalną wartość i jednostkę tak, jak wydrukowano, dla identyfikowalności, a przy eksporcie przeliczaj z powrotem na jednostki kanału: plik CSV produktów Shopify oczekuje wagi w gramach, a WooCommerce używa jednostek wagi i wymiarów skonfigurowanych w sklepie.

Uważaj na szczegóły, które powodują ciche błędy. Separatory dziesiętne i tysięcy zależą od ustawień regionalnych dokumentu: w niemieckiej karcie danych „1.000 W” to tysiąc watów. Dziel zakresy na pola minimum i maksimum, przechowuj tolerancje osobno od wartości nominalnej, a kwalifikatory, takie jak „ok.” lub „maks.”, trzymaj we własnym polu. Przeliczenia na jednostki imperialne używają dokładnych definicji (1 cal = 25,4 mm; 1 funt = 0,45359237 kg); zaokrąglaj raz, w momencie wyświetlania.

Surowe wartości od dostawców i ich postać znormalizowana
Surowa wartość w oryginaleWartość znormalizowanaKod UNECE Rec 20Zastosowana reguła
1,5 l1.5LTRPrzecinek dziesiętny odczytany według ustawień regionalnych dokumentu
1500 ml1.5LTRPrzeliczono na jednostkę kanoniczną atrybutu; oryginał zachowany
1.000 W (niemiecka karta danych)1000WTTKropka odczytana jako separator tysięcy
220–240 V~min 220, max 240VLTZakres podzielony; „~” zapisane jako rodzaj prądu AC
Ø 12 mm ± 0,2nominalnie 12, tolerancja 0.2MMTTolerancja zapisana osobno
ok. 2,3 kg2.3 (kwalifikator: w przybliżeniu)KGMKwalifikator zachowany, a nie pominięty
5 lb2.26796KGMPrzeliczono przez 0.45359237; oryginał w LBR zachowany
1/2 cala12.7MMTUłamek rozwiązany; oryginał w INH zachowany
Opakowanie 6 szt.6H87Liczba sztuk w opakowaniu

Używaj słowników kontrolowanych dla atrybutów tekstowych

Słownik kontrolowany to lista wartości, jakie może przyjmować atrybut tekstowy, wraz z synonimami przypisanymi do każdej z nich. Dzięki niemu filtr „Kolor: czarny” obejmie produkty opisane jako „blk”, „Black” i „schwarz”.

Prowadź dwa pola tam, gdzie marketing i filtrowanie ciągną w różne strony: znormalizowaną wartość bazową dla filtrów i feedów oraz własną nazwę producenta do wyświetlania. „Midnight Graphite” to dobry szczegół na stronie produktu i bezużyteczna wartość filtra; „szary” jest odwrotnie. W katalogach wielojęzycznych przechowuj wartości słownika jako kody niezależne od języka i tłumacz ich etykiety, aby ten sam produkt prawidłowo filtrował się w każdym języku sklepu.

Wartości tekstowe przed normalizacją słownikową i po niej
Surowa wartość tekstowaWartość znormalizowanaReguła słownika
blk / BLACK / schwarzczarnySynonimy i tłumaczenia mapowane na jeden kod
Midnight Graphiteszary (nazwa wyświetlana zachowana)Nazwa marketingowa przechowywana osobno
18/8 SSstal nierdzewnaSkrót rozwinięty; gatunek zachowany jako osobny atrybut
Bawełna 95%, Elastan 5%bawełna 95; elastan 5Skład jako pary wartość–procent
Tak / ✓ / w zestawietrueWartości logiczne sprowadzone do true lub false

Mapuj atrybuty na taksonomie i schematy kanałów

Taksonomia decyduje, które atrybuty dotyczą produktu i jak się nazywają. Rzadko możesz ją wybrać: sprzedawca detaliczny może poprosić o GS1 GPC, hurtownia o ETIM, Shopify o swoją Standard Product Taxonomy, a wyszukiwarki odczytują znaczniki schema.org. Zachowaj własny schemat atrybutów jako wzorcowy i utrzymuj mapowanie na każdą zewnętrzną taksonomię.

W GS1 GPC podstawowym elementem jest brick, a atrybuty bricka niosą szczegóły, takie jak to, czy mleko jest zwierzęce, czy roślinne. ETIM nadaje każdej klasie predefiniowany zestaw cech ze stałymi listami wartości i jednostkami oraz publikuje swój model w 17 językach. Shopify wymaga jednej kategorii wybranej według głównej funkcji produktu; jej ustawienie odblokowuje metapola kategorii. Product w schema.org ma dedykowane właściwości, takie jak gtin, mpn, brand, color, material, size i weight.

Porównanie taksonomii produktów
TaksonomiaGłówni użytkownicyStrukturaModel atrybutówNa co uważać
GS1 GPCWymiana danych w handlu detalicznym i dobrach konsumpcyjnychSegment > Family > Class > BrickAtrybuty bricka z zdefiniowanymi wartościamiKlasyfikacja, a nie pełny model specyfikacji
ETIMHurt techniczny: elektryka, HVAC, instalacje wodno-kanalizacyjneKlasy z synonimamiCechy typu alfanumerycznego, logicznego, liczbowego lub zakresowego, z jednostkamiWartości cech muszą pochodzić z list klasy
Shopify Standard Product TaxonomySklepy ShopifyŚcieżka kategorii lub identyfikator kategoriiMetapola kategorii (atrybuty produktu) dla każdej kategoriiW CSV podaj ścieżkę albo identyfikator, nie oba naraz
schema.org ProductDane strukturalne dla wyszukiwarekPojedynczy typ Product z właściwościamiDedykowane właściwości; QuantitativeValue z unitCodeUżywaj konkretnych właściwości przed additionalProperty

Obsługuj warianty bez duplikowania atrybutów

Warianty to produkty, które mają większość atrybutów wspólnych i różnią się kilkoma. Modeluj je jako rekord nadrzędny zawierający wspólne atrybuty i rekordy podrzędne zawierające tylko osie wariantów oraz wartości, które się z nimi zmieniają, takie jak kolor, rozmiar, pojemność i własne identyfikatory. Zasady GTIN GS1 traktują każdą odmianę stylu, koloru i rozmiaru jako unikalny produkt z własnym GTIN, więc identyfikator zawsze znajduje się w rekordzie podrzędnym.

Tabele specyfikacji wielomodelowych powodują większość błędów wariantów. Podziel tabelę z jedną kolumną na model na jeden rekord na kolumnę i skopiuj każdą wartość wydrukowaną raz w kilku kolumnach — scaloną komórkę lub „wszystkie modele: 230 V” pod tabelą — do każdego rekordu podrzędnego, którego dotyczy. W Shopify kolumna CSV Option1 LinkedTo łączy opcję wariantu z metapolem kategorii; produkt może mieć do trzech opcji i 2048 wariantów.

Waliduj atrybuty regułami i próbkowaniem QA

Reguły walidacji wychwytują błędy mechaniczne: zły typ, złą jednostkę, niemożliwą wartość, brakujący wymagany atrybut. Uruchamiaj je przy każdym imporcie i kieruj niepowodzenia do osoby weryfikującej zamiast po cichu odrzucać wartości.

Reguły nie wychwycą wiarygodnej, ale błędnej wartości — pojemność skopiowana z sąsiedniej kolumny modelu przechodzi każdą kontrolę. Próbkowanie QA może: porównaj próbki rekordów z dokumentami źródłowymi pole po polu. Nie ma uniwersalnej wielkości próbki ani progu błędów; ustal je według ryzyka.

  1. Pobierz próbkę rekordów dla każdego dostawcy, z większą wagą dla nowych dostawców i nowych układów dokumentów.
  2. Porównaj każdy atrybut z próbki ze źródłem, osobno odnotowując zgodności, wartości błędne i brakujące.
  3. Oblicz wskaźniki błędów dla każdego atrybutu, a nie tylko dla rekordu, aby znaleźć atrybuty lub mapowania nagłówków, które sprawiają kłopoty.
  4. Atrybuty istotne dla bezpieczeństwa i wymagane prawnie sprawdzaj w każdym rekordzie, a nie na próbce.
Rodzaje reguł walidacji z przykładami
Rodzaj regułyPrzykładDziałanie przy niepowodzeniu
Typ i formatcapacity musi być liczbą dziesiętną; gtin tylko cyfryOdrzuć wartość, zachowaj surowy tekst do weryfikacji
Zakres i wiarygodnośćpojemność czajnika między 0.1 a 5 LOznacz jako prawdopodobny błąd jednostki lub separatora
Przynależność do enumacolor musi znajdować się na liście kolorów podstawowychZmapuj synonim lub dodaj do słownika
Między polamimin ≤ max; waga netto ≤ waga bruttoOznacz oba pola
Cyfra kontrolnaGTIN przechodzi kontrolę mod-10 GS1Odrzuć; odczytaj ponownie ze źródła
Kompletnośćwszystkie wymagane atrybuty dla rodziny i kanału wypełnioneZablokuj publikację; poproś dostawcę o dane

Normalizacja atrybutów w dużej skali

Schemat, tabele synonimów, słowniki i reguły to trwała część tej pracy; metoda wyodrębniania może się pod nimi zmieniać. Wersjonuj je, wyznacz właściciela każdego z nich, rejestruj ręczne poprawki wraz z powodem (powtarzające się poprawki wskazują brakującą regułę) i przeglądaj tabelę synonimów przy każdym wdrożeniu nowego dostawcy.

Jeśli Twoje atrybuty zaczynają życie w plikach PDF od dostawców, Doc2Shelf może wykonać etap wyodrębniania: odczytuje przesłane karty danych, karty specyfikacji, karty charakterystyki (SDS) i katalogi, zachowuje wartości i jednostki dokładnie tak, jak wydrukowano, ze stroną i krótkim cytatem jako dowodem, oraz oznacza brakujące wymagane dane. Twoje reguły normalizacji stosują się następnie podczas weryfikacji, zanim rekord zasili oferty lub wersje robocze deklaracji.

Najczęściej zadawane pytania

Czym są atrybuty produktów?
Atrybuty produktów to nazwane właściwości z wartościami, które opisują produkt, takie jak materiał, kolor, pojemność, wymiary lub moc znamionowa. W przeciwieństwie do tekstu opisu znajdują się w polach strukturalnych, dzięki czemu mogą napędzać filtry, tabele specyfikacji, feedy i wymagania kategorii.
Czym różni się atrybut produktu od wariantu?
Atrybut to dowolna właściwość produktu. Wariant to wersja produktu, która różni się jednym lub kilkoma atrybutami, między którymi wybiera kupujący, takimi jak rozmiar lub kolor. Te wybierane atrybuty to opcje wariantu; pozostałe pozostają wspólne w produkcie nadrzędnym.
Jak wyodrębnić atrybuty z opisów produktów?
Najpierw zdefiniuj docelowe atrybuty i dozwolone wartości, podziel tekst na zdania, znajdź wartości kandydujące i sprawdź każdą pod kątem kwalifikatorów, negacji i warunków, zanim przypiszesz ją do atrybutu. Atrybuty, które pojawiają się tylko w tekście marketingowym, potwierdź z kartą danych.
Czym są kody jednostek z Zalecenia 20 UNECE?
To trzyznakowe kody jednostek miar używanych w handlu międzynarodowym, publikowane przez UN/CEFACT — na przykład MTR dla metra, KGM dla kilograma, LTR dla litra i WTT dla wata. Właściwość unitCode w schema.org używa tych samych kodów.
Czy przechowywać wartość oryginalną, czy przeliczoną?
Obie. Przechowuj znormalizowaną liczbę i kod jednostki do filtrowania, porównywania i walidacji oraz zachowaj wartość tak, jak wydrukowano, dla identyfikowalności. Przy eksporcie przeliczaj na jednostkę oczekiwaną przez dany kanał, np. gramy dla wagi w pliku CSV produktów Shopify.
Której taksonomii produktów użyć: GS1 GPC, ETIM czy Shopify?
Tej, o którą proszą Twoi partnerzy handlowi i kanały — często więcej niż jednej. Zachowaj własny schemat atrybutów jako wzorcowy i utrzymuj mapowania na GPC dla wymiany danych w handlu detalicznym, ETIM dla hurtu technicznego i Shopify Standard Product Taxonomy dla sklepu Shopify.
Jak mierzyć jakość wyodrębniania atrybutów?
Porównaj próbkę wyodrębnionych rekordów z dokumentami źródłowymi pole po polu i osobno policz wartości poprawne, błędne i brakujące dla każdego atrybutu. Błędne wartości wskazują na problemy z precyzją, brakujące — na problemy z kompletnością (recall). Śledź oba wskaźniki dla każdego dostawcy.
Jak obsługiwać atrybuty produktów w kilku językach?
Wartości wyliczeniowe, takie jak kolory i materiały, przechowuj jako kody niezależne od języka z przetłumaczonymi etykietami, a liczby i kody jednostek pozostaw niezależne od języka. Atrybuty w formie swobodnego tekstu wymagają tłumaczenia i weryfikacji dla każdego języka.

Oficjalne źródła

Pierwotne teksty prawne i oficjalne wytyczne, do których odwołuje się ten poradnik.

Ten poradnik zawiera informacje ogólne i nie stanowi porady prawnej. Wymagania zależą od produktu i rynku; sprawdź oficjalne teksty i skorzystaj z kwalifikowanej porady w swojej sytuacji.

Więcej poradników

Zamień pliki PDF od dostawców w sprawdzone dane produktów

Doc2Shelf wyodrębnia dane produktów z dokumentów dostawców i przygotowuje projekty ofert oraz dokumentów zgodności do Twojej weryfikacji.

Załóż darmowe konto