Mapowanie atrybutów elektroniki przy integracji z marketplace

Kategorie – fundament mapowania

Mapowanie zaczyna się od kategorii, bo to ona wyznacza listę atrybutów. Centrum Pomocy Media Expert zaleca przypisanie produktu do kategorii najniższego poziomu. Kategoria ma też znaczenie finansowe: stawka prowizji zależy od kategorii oferty, a regulamin przewiduje, że przy przypisaniu do kategorii z niższą stawką niż właściwa platforma może doliczyć prowizję według prawidłowej stawki – także wstecz.

Przy dużym katalogu warto przygotować tabelę mapowania kategorii: kategoria w systemie sprzedawcy, kategoria docelowa na platformie, lista atrybutów wymaganych. Kategorie w sklepie internetowym często są zbudowane pod nawigację klienta, a nie pod logikę marketplace, więc jedna kategoria sklepu może odpowiadać kilku kategoriom platformy – na przykład „Zasilanie” w sklepie to na marketplace osobno ładowarki, powerbanki i kable.

[#uwaga] Drzewo kategorii na marketplace się zmienia: pojawiają się nowe kategorie szczegółowe, część jest łączona lub wyłączana. Regulamin Media Expert pozwala tworzyć kategorie szczegółowe z odrębnymi stawkami. Tabelę mapowania kategorii warto przeglądać okresowo, a nie traktować jako jednorazowej pracy.

Skąd wziąć listę atrybutów i wartości

Listy atrybutów i dopuszczalnych wartości dla każdej kategorii są dostępne w panelu i w szablonach importu. Dla firm korzystających z API platforma Mirakl udostępnia w Seller API osobne zasoby: listę kategorii (H11), konfigurację atrybutów produktów (PM11) i listy wartości (VL11). Dzięki nim system sprzedawcy może automatycznie pobierać aktualne wymagania zamiast polegać na ręcznie przepisanych listach. Możliwości API opisujemy w artykule o API Media Expert.

Jeśli w liście wartości brakuje potrzebnej pozycji – na przykład nowego standardu złącza albo nowego modelu urządzenia w atrybucie kompatybilności – Centrum Pomocy wskazuje kontakt z opiekunem lub adres pomoc.marketplace@me.pl. Do czasu dodania wartości informację można umieścić w opisie produktu, ale nie należy wybierać wartości „najbliższej”, która nie odpowiada rzeczywistości.

Narzędzia: kreator mapowania, szablony i integracje

Media Expert oferuje kilka dróg przekazywania danych produktowych, a każda z nich wymaga mapowania w nieco inny sposób. Przy imporcie plikowym Centrum Pomocy opisuje kreator mapowania w zakładce Ustawienia > Mapowanie katalogu – siedmioetapowy proces, który pozwala przypisać kolumny własnego pliku do atrybutów platformy. Kreator dotyczy produktów, a nie ofert.

Przy integracji z Base Centrum Pomocy wymienia atrybuty, które najczęściej trzeba uzupełnić: EAN, SKU, dane podmiotu odpowiedzialnego, opis do feedu Google, markę, gwarancję liczoną w dniach oraz stan oferty. Warto przygotować te pola w katalogu Base przed włączeniem integracji. Szczegóły konfiguracji opisujemy w artykule o Media Expert w Base, a proces importu plikowego – w tekście o imporcie produktów na Media Expert.

Jednostki i wartości liczbowe

W elektronice największym źródłem błędów mapowania są jednostki. Pojemność powerbanka może być zapisana w mAh lub Wh, moc w W lub kW, przekątna w calach lub centymetrach, długość kabla w metrach lub centymetrach. Jeśli platforma oczekuje wartości w jednej jednostce, a system przekazuje w innej, produkt może przejść weryfikację z błędną wartością – a to gorsze niż odrzucenie, bo klient filtruje i kupuje na podstawie złych danych.

• Ujednolić jednostki w systemie źródłowym – jedna jednostka dla jednego parametru w całym katalogu.

• Przechowywać wartość liczbową i jednostkę w osobnych polach, zamiast w jednym tekście typu „65W”.

• Sprawdzić, jakiej jednostki oczekuje platforma w danym atrybucie, i przeliczać wartości przy eksporcie.

• Uważać na separator dziesiętny – przecinek i kropka bywają interpretowane różnie.

• Kontrolować wartości skrajne po imporcie, np. kabel o długości 100 m zamiast 1 m.

[#przyklad] Sprzedawca ma w systemie pole „Parametry” z tekstem „20000mAh, 22,5W, USB-C PD”. Przy mapowaniu na marketplace rozbija je na osobne pola: pojemność 20000 (mAh), moc maksymalna 22,5 (W), typ złącza USB-C, standard szybkiego ładowania Power Delivery. Dopiero tak przygotowane dane zasilają filtry, a klient szukający powerbanka o pojemności co najmniej 20000 mAh znajduje ten produkt.

Listy wartości – tabela przekształceń

Atrybuty z zamkniętą listą wartości wymagają tabeli przekształceń: wartość w systemie sprzedawcy, wartość docelowa na platformie. Typowe przykłady to kolor, typ złącza, system operacyjny, rodzaj łączności. W systemie sprzedawcy kolorów może być kilkadziesiąt – „grafitowy”, „space grey”, „ciemnoszary” – a na platformie lista jest krótsza. Każdą wartość trzeba przypisać do jednej z dostępnych.

Tabelę przekształceń warto prowadzić w jednym miejscu i aktualizować przy każdym nowym produkcie, którego wartość nie ma jeszcze odpowiednika. W systemach do sprzedaży wielokanałowej często da się zdefiniować takie przekształcenia w ustawieniach integracji. Spójne parametry techniczne omawiamy w artykule o parametrach technicznych elektroniki na marketplace.

Identyfikatory i warianty

EAN to identyfikator, po którym marketplace łączy ofertę z kartą produktu, a integratorzy – na przykład Apilo – domyślnie łączą oferty właśnie po EAN. Błędny lub powielony EAN oznacza, że oferta trafi na niewłaściwą kartę. Przed mapowaniem warto sprawdzić unikalność EAN w katalogu i ich zgodność z bazą GS1. Szczegóły w artykule o EAN i kodach producenta na Media Expert.

Przy wariantach mapowanie ma dodatkową warstwę. Na Media Expert warianty łączy się wspólnym kodem grupy (VARIANT_GROUP_CODE), a atrybuty wariantujące – na przykład kolor czy pojemność – ustala platforma dla danej kategorii i są one wymagane. Wszystkie warianty grupy muszą być w tej samej kategorii, a kombinacje wartości atrybutów wariantujących nie mogą się powtarzać. Mapowanie wariantów warto przygotować razem z mapowaniem atrybutów, a nie po fakcie. Więcej w artykule o wariantach produktów na Media Expert.

Test mapowania przed pełnym importem

Wykres – najczęstsze błędy mapowania i sposoby ich naprawy [#chart:me83b]

Nawet najstaranniej przygotowane mapowanie trzeba przetestować na małej partii. Wybierz po kilka produktów z każdej kategorii, którą planujesz wystawić, zaimportuj je i przeanalizuj raport błędów. W panelu produkty mogą mieć statusy: Opublikowany, W toku, Nieprawidłowe dane, Odrzucony, Wymagane zmiany lub Błąd publikacji. Dla integracji przez API Mirakl udostępnia raporty błędów importu produktów (P44) i raport integracji (P45). Pamiętaj, że weryfikacja zmian może potrwać do 72 godzin.

Po imporcie testowym nie ograniczaj się do sprawdzenia, czy produkty przeszły. Otwórz kilka kart na stronie i sprawdź, czy wartości atrybutów są poprawne, czy filtry działają i czy jednostki się zgadzają. Błędna wartość, która przeszła weryfikację, jest trudniejsza do wykrycia niż odrzucony produkt.

[#tip] Prowadź dziennik mapowania: data, kategoria, zmiana w tabeli przekształceń, powód. Gdy po kilku miesiącach pojawi się problem z grupą produktów, dziennik pozwoli szybko ustalić, czy przyczyną jest zmiana mapowania, zmiana danych źródłowych, czy zmiana wymagań platformy.

Utrzymanie mapowania w czasie

Mapowanie nie jest jednorazowym projektem. Platforma dodaje nowe atrybuty i wartości, zmienia kategorie, a sprzedawca wprowadza nowe produkty i marki. Przy każdej większej zmianie warto sprawdzić, czy mapowanie nadal działa. Szczególnie ważne są trzy momenty: dodanie nowej kategorii produktów, zmiana drzewa kategorii lub konfiguracji atrybutów na platformie oraz zmiana struktury danych w systemie źródłowym, na przykład po migracji na nowy system.

Przy dużym katalogu mapowanie jest jednym z elementów, które decydują o tym, czy rozbudowa przebiega bez problemów. Szerzej o kontroli nad rosnącym katalogiem piszemy w artykule o skalowaniu na Media Expert. Podobne wyzwania pojawiają się na innych platformach – opisujemy je na przykład w tekście o mapowaniu parametrów przy integracji z Erli.

Dane o bezpieczeństwie produktu i opis

Poza atrybutami technicznymi mapowanie obejmuje też pola, które wynikają z przepisów. Regulamin Media Expert wymaga, żeby w opisie produktu znalazły się informacje wymagane przez ogólne rozporządzenie o bezpieczeństwie produktów: dane producenta, osoby odpowiedzialnej w UE, identyfikacja produktu i ostrzeżenia po polsku. Przy integracji z Base Centrum Pomocy wymienia wprost dane podmiotu odpowiedzialnego jako jeden z najczęściej wymaganych atrybutów.

Te dane warto przechowywać w systemie źródłowym w osobnych polach – producent, adres, osoba odpowiedzialna, ostrzeżenia – a nie w treści opisu. Wtedy można je zmapować do pól platformy i jednocześnie automatycznie dołączyć do opisu, a przy zmianie danych producenta zaktualizować wszystkie produkty jednym ruchem. Obowiązki dotyczące dokumentacji elektroniki omawiamy w artykule o GPSR i oznakowaniu elektroniki.

Kto powinien przygotować mapowanie

Mapowanie łączy wiedzę techniczną o integracji z wiedzą o produktach. Osoba, która zna strukturę danych i narzędzia, nie zawsze wie, czy „USB-C PD 3.0” i „Power Delivery” to ten sam standard, a osoba znająca produkty nie zawsze wie, jak działa kreator mapowania. Najlepsze efekty daje praca w parze: specjalista od danych lub integracji przygotowuje strukturę i narzędzia, a osoba z działu produktowego weryfikuje tabele przekształceń i wartości na próbnych kartach. Przy dużych katalogach warto też ustalić, kto po wdrożeniu odpowiada za utrzymanie mapowania – bez wyznaczonej osoby tabele szybko się dezaktualizują.

[#checklista] Przed pełnym importem: każda kategoria sklepu ma przypisaną kategorię docelową najniższego poziomu; dla każdej kategorii są zmapowane wszystkie atrybuty wymagane; wartości słownikowe mają tabelę przekształceń; jednostki są ujednolicone; EAN są unikalne i zgodne z GS1; warianty mają kod grupy i komplet atrybutów wariantujących; partia testowa przeszła bez błędów, a wartości na kartach zostały sprawdzone.

Kompatybilność jako atrybut

W akcesoriach elektronicznych osobnym wyzwaniem jest kompatybilność. W systemie sprzedawcy często jest zapisana w opisie jako tekst, a na marketplace może mieć postać atrybutów – kompatybilna marka, model, standard. Mapowanie takiej informacji wymaga uporządkowania danych źródłowych: lista modeli powinna być przechowywana w ustrukturyzowanej formie, a nie w akapicie tekstu. Metodę opisywania kompatybilności przedstawiamy w artykule o kompatybilności akcesoriów.

Najczęściej zadawane pytania

Gdzie w panelu Media Expert znajduje się kreator mapowania?

Według Centrum Pomocy w zakładce Ustawienia > Mapowanie katalogu. Kreator ma siedem etapów i dotyczy produktów, a nie ofert.

Skąd wziąć listę wymaganych atrybutów dla kategorii?

Z panelu i szablonów importu dla danej kategorii. Przy integracji przez API platforma Mirakl udostępnia konfigurację atrybutów (PM11) i listy wartości (VL11), które można pobierać automatycznie.

Co zrobić, gdy w liście wartości brakuje potrzebnej pozycji?

Centrum Pomocy wskazuje kontakt z opiekunem lub adres pomoc.marketplace@me.pl. Do czasu dodania wartości informację można podać w opisie, ale nie należy wybierać wartości niezgodnej z rzeczywistością.

Jakie atrybuty najczęściej trzeba uzupełnić przy integracji z Base?

Centrum Pomocy wymienia EAN, SKU, dane podmiotu odpowiedzialnego, opis do feedu Google, markę, gwarancję w dniach i stan oferty. Warto przygotować je w katalogu przed włączeniem integracji.

Dlaczego kategoria jest tak ważna przy mapowaniu?

Kategoria wyznacza zestaw atrybutów i stawkę prowizji. Przypisanie do niewłaściwej kategorii oznacza inne wymagane pola, a przy niższej stawce niż właściwa platforma może doliczyć różnicę także wstecz.

Jak sprawdzić, czy mapowanie działa poprawnie?

Zaimportuj małą partię produktów z każdej kategorii, przeanalizuj raport błędów i statusy, a potem otwórz kilka kart na stronie i sprawdź wartości atrybutów oraz działanie filtrów.

Czy błędna wartość atrybutu jest groźniejsza niż odrzucony produkt?

Często tak. Odrzucony produkt od razu widać w raporcie, a błędna wartość, która przeszła weryfikację, trafia do filtrów i na kartę. Klient kupuje na podstawie złych danych, co kończy się zwrotem lub incydentem.

Podsumowanie

Mapowanie atrybutów elektroniki przy integracji z marketplace zaczyna się od kategorii najniższego poziomu, które wyznaczają zestaw atrybutów i stawkę prowizji. Kolejne kroki to wskazanie pól źródłowych, przekształcenie wartości do list słownikowych, ujednolicenie jednostek i przygotowanie wariantów. Na Media Expert pomagają w tym kreator mapowania, szablony, integracje i zasoby API Mirakl. Każde mapowanie warto przetestować na małej partii, sprawdzić nie tylko raport błędów, ale też wartości na kartach produktów, i regularnie aktualizować wraz ze zmianami katalogu i wymagań platformy. Podstawowe informacje o platformie znajdziesz na stronie marketplace Media Expert.

Wdrażamy i obsługujemy sprzedaż na marketplace’ach, w tym na Media Expert – przygotowujemy mapowanie kategorii i atrybutów, tabele przekształceń wartości i integracje dla katalogów elektroniki. Jeśli chcesz, żeby Twoje produkty przechodziły weryfikację za pierwszym razem, umów bezpłatną konsultację.