[NEWS] Scalamy parametry i ich wartości / We merge parameters and their values

[PrzemyslawLukanowski]

Rozpoczęliśmy proces scalania parametrów i ich wartości w wybranych kategoriach:

• łączymy parametry - w przypadku, gdy kategoria zawiera parametry o różnym identyfikatorze, ale o takim samym lub podobnym znaczeniu, scalimy wtedy parametry i połączymy ich wartości. Przykładowo - w kategorii Uroda połączymy parametr Producent z parametrem Marka. W efekcie parametr Marka rozszerzymy o wszystkie wartości parametru Producent, a sam parametr Producent usuniemy.
• łączymy wartości parametrów - np. (przykład teoretyczny) w parametrze kolor łączymy wartości: czarny i odcienie czarnego. W efekcie mamy tylko jedną wartość - czarny.

Aktualnie istnieje wiele parametrów i ich wartości przypisanych do kategorii niższego rzędu, które mają podobne lub identyczne znaczenie. Dzięki scaleniu parametrów będziemy mogli je przenieść do kategorii wyższego poziomu i wykorzystać jako filtry - dzięki temu kupującym będzie łatwiej znaleźć interesującą ofertę.

Na przykład - w kategorii Opony ujednoliciliśmy dla wszystkich podkategorii identyfikatory parametrów Średnica. Wcześniej identyfikatory parametrów były różne w każdej z poniższych podkategorii:

• Do samochodów osobowych,
• Do samochodów 4x4/SUV,
• Do samochodów dostawczych,
• Do samochodów ciężarowych,
• Do motocykli i skuterów,
• Do maszyn rolniczych,
• Do maszyn budowlanych,
• Do quadów.

Identyfikatory parametrów scaliliśmy i ujednoliciliśmy zgodnie z podkategorią Do samochodów osobowych. Oznacza to, że dla parametru Średnica wspólnym identyfikatorem jest teraz 127088.

Zmiana nie ma wpływu na podkategorię Do samochodów osobowych (ponieważ do tego parametru scaliliśmy pozostałe). W efekcie parametr ma jeden identyfikator i zawiera wartości, które dotychczas były dostępne w każdej z dotychczasowych kategorii.

Ważne! Pamiętaj, że parametry aktualizujemy na bieżąco, dlatego aby pobrać najnowsze informacje na ich temat, korzystaj z zasobu GET /sale/categories/{categoryId}/parameters.

Jak zmiana wpłynie na oferty:

• Dane o parametrach w istniejących ofertach automatycznie zaktualizujemy.
• W przypadku, gdy wystawisz ofertę ze starym parametrem i wartością - dane automatycznie zmienimy na aktualne (automatyczną aktualizację będziemy wspierać przez rok od zmiany w parametrach).

---

We have started the process of merging parameters and their values in selected categories:

• merging parameters - in case, when category contains parameters with different id, but with identical or similar meaning, then we will merge these parameters and combine their values. For example - in Beauty category we will merge Manufacturer parameter with Brand parameter. As a result, we will expand Brand parameter by all values of the Manufacturer parameter, and Manufacturer parameter will be deleted.
• combining parameter values - e.g. (theoretical example) in color parameter we combine values: black and shades of black. As a result, we have only one value - black.

At present there are many parameters and their values assigned to lower level category, that have similar or identical meaning. By merging parameters, we will be able to move them to higher level category and use these parameters as filters. Owing to this approach buyers will be able to find interesting offer easier.

For example - we unified parameter id for Diameter in all subcategories belonging to the Tires category. Before change, parameter identifiers were different in each of the following subcategories:

• For passenger cars,
• For 4x4/SUV cars,
• For vans,
• For trucks,
• For motorcycles and scooters,
• For agricultural machines,
• For construction machinery,
• For quads.

Parameter identifiers were merged and unified with the subcategory For passenger cars. This means for Diameter common parameter identifier is now 127088.

The change does not affect the Tires for passenger cars subcategory (because we merged other parameters to this category). As a result, the parameter have one identifier and contain all values, that were previously available in each of the categories.

Note! Remember that parameters are updated on regular basis, therefore to retrieve the latest information about them, use GET /sale/categories/{categoryId}/parameters resource.

How the change will affect offers:

• We will automatically update parameters in existing offers.
• When you list a new offer using an old parameter and value - we will automatically update the parameter id and values. We will support automatic update for one year after the parameter was changed.

[dlis2010]

W przypadku, gdy wystawisz ofertę ze starym parametrem i wartością - dane automatycznie zmienimy na aktualne (automatyczną aktualizację będziemy wspierać przez rok od zmiany w parametrach).

Dobra robota! ;)

[hubertmichna]

Czyli rozumiem, że przeszukując średnicę R17 w oponach to parametr powinien wyglądać następująco:

"parameter.127088=127093_9"

Ponieważ w zapytaniu o opony 215/55R17 zwracane są opony z innymi średnicami.

"https://api.allegro.pl/offers/listing?category.id=257691&parameter.11323=1&parameter.15808=3&parameter.127088=127093_9&parameter.345=10&parameter.9300=5&parameter.344=64&parameter.1.from=2019&parameter.1.to=2019&offset=0&limit=100&sort=+price"

[PrzemyslawLukanowski]

@hubertmichna Parametr dla średnicy R17 to 127093_9, ale inaczej wygląda wyszukiwanie tej wartości parametru w GET /offers/listing. Na samym dole wywołania zobaczysz, jaką wartość musisz przekazać, aby wyszukać oferty z podaną średnicą. Żeby wyszukać opony ze średnicą 17’’, należałoby jako parametr przekazać parameter.127088=9.

Zauważyliśmy błędy w działaniu filtrów w tej kategorii, wobec czego powyższe wywołanie nie działa na tę chwilę poprawnie. Zgłosiłem to do odpowiedniego zespołu.

[yncki]

@PrzemyslawLukanowski czy mozecie nam wystawic liste tych scalen ? cos ala old_param_id => new_param_id ? nie chodzi o wartosci tylko o same identyfikatory parametrow ?

[PrzemyslawLukanowski]

Niestety nie generujemy raportu z takimi informacjami - parametry aktualizujemy na bieżąco, dlatego też najlepiej korzystać z zasobu GET /sale/categories/{categoryId}/parameters w celu pobrania aktualnych danych.

[kpodemski]

@PrzemyslawLukanowski

co z integratorami, które używają starego modelu danych? jak teraz zmapować stare dane do nowych bez utraty ustawień dla obecnych użytkowników? :-)

[PrzemyslawLukanowski]

Tak jak wspomnieliśmy w newsie:

Dane o parametrach w istniejących ofertach automatycznie zaktualizujemy. W przypadku, gdy wystawisz ofertę ze starym parametrem i wartością - dane automatycznie zmienimy na aktualne (automatyczną aktualizację będziemy wspierać przez rok od zmiany w parametrach)

Jeśli pobierzesz ofertę, będzie ona miała już nowe identyfikatory.