[NEWS] Uzupełnij w ofertach własną nazwę marki lub zasugeruj własne parametry / Complete your own brand in the offers or suggest your own parameters

Wprowadziliśmy zmianę, dzięki której w trakcie wystawiania lub edycji oferty możesz zasugerować własne parametry wraz z wartościami we wszystkich kategoriach serwisu. Dodatkowo, możesz dodać własne wartości wybranych parametrów, które wyświetlimy na stronie oferty. Tę opcję udostępniamy dla wybranych parametrów, których listę znajdziesz [tutaj](https://assets.allegrostatic.com/popart-attachments/att-d057ea80-e872-42da-bfaa-749aee9173d9).

**Zadbaj o obsługę własnych parametrów i wartości w swojej aplikacji - będzie to mieć istotny wpływ na kształt filtrów w Allegro.** Propozycje własnych parametrów zbierzemy i zweryfikujemy, a w wybranych przypadkach przeniesiemy je do standardowych parametrów, które są widoczne na filtrach. Sprzedającym często zależy też, aby ich marki były widoczne w filtrach wyszukiwania, dlatego najbardziej popularne **własne wartości dodamy do listy dostępnych wartości w filtrze.**

### Własne parametry
\

**Własne parametry, wraz z określoną wartością, dodasz, gdy wystawiasz lub edytujesz ofertę.** Funkcjonalność udostępniliśmy we wszystkich kategoriach.

\
**Przykładowa struktura, jak dodać własny parametr:**

```
{
...
"parameters": [...],
"customParameters": [
{
"name": "Nazwa twojego własnego parametru",
"values": [
"Wartość własnego parametru"
]
}
],
"description": {...},
...
}
```

### Własne wartości
\

**Własne wartości wprowadzisz dla wybranych parametrów posiadających wartość niejednoznaczną.** Wartości niejednoznaczne parametru to np. “inne”, “pozostałe”. Identyfikator takiej wartości zwracamy w polu **ambiguousValueId** w sekcji **options** w odpowiedzi dla [GET /sale/categories/{categoryId}/parameters.](https://developer.allegro.pl/documentation/#operation/getFlatParametersUsingGET_2)

Na ten moment możesz wprowadzić własną wartość w [wybranych parametrach](https://assets.allegrostatic.com/popart-attachments/att-5fee661e-0712-4187-904b-aa3b20362839). Informację o tym, czy dany parametr obsługuje tę funkcjonalność, sprawdzisz za pomocą [GET /sale/categories/{categoryId}/parameters](https://developer.allegro.pl/documentation/#operation/getFlatParametersUsingGET_2) w polu **customValuesEnabled** w sekcji **options**.

Skorzystaj z tej opcji, gdy wystawiasz lub edytujesz ofertę i jako wartość parametru wybierasz np. “Inny”. Dzięki temu na ofercie (w nawiasie) widoczna będzie prawidłowa, wpisana przez Ciebie wartość parametru, która – jeśli zyska popularność – będzie mogła znaleźć się też na filtrach.

**W przyszłości uzupełnienie wartości będzie obowiązkowe, jeśli wybierzesz wartość niejednoznaczną w ramach danego parametru**. W przypadku, gdy [tworzysz nowy produkt](https://developer.allegro.pl/productization/#add) i wybierzesz wartość niejednoznaczną zawsze wymagamy wprowadzenia własnej wartości.

\
**Przykładowa struktura, jak dodać własną wartość parametru:**

```
{
...
{
"id": "129033", -- ID parametru
"valuesIds": [
"129033_13" -- ID wartości niejednoznacznej
],
"values": [ "Nazwa brakującej marki" ], -- wartość, którą chcesz przekazać,
uzupełnij to pole.
"rangeValue": null
}
...
}
```

Więcej informacji o własnych parametrach i wartościach znajdziesz w naszym poradniku:
- [jak dodać własny parametr](https://developer.allegro.pl/sale/#w%c5%82asne-parametry),
- [jak dodać własną wartość parametru](https://developer.allegro.pl/sale/#w%c5%82asna-warto%c5%9b%c4%87-parametru),

oraz na [stronie dla sprzedających](https://allegro.pl/dla-sprzedajacych/uzupelnij-w-ofercie-wlasna-nazwe-marki-i-zasugeruj-nowe-parametry-O39En1lEohM).

-----

We have introduced a change that allows you to suggest your own (custom) parameters along with values in all categories when you list or edit an offer. Additionally, you can add your own values to selected parameters and we will show them on the offer page. This option is available only for certain parameters which you can find [here](https://assets.allegrostatic.com/popart-attachments/att-d057ea80-e872-42da-bfaa-749aee9173d9).

**Take care of handling your own parameters and values in your application - this will have a significant impact on the shape of Allegro filters.** We will collect suggestions of custom parameters and after the verification, we will add them to the standard list of parameters, which are visible on filters. Sellers often want their brands to be visible in search filters, so **we will add the most popular own values to the list of available values in the filter**.

### Custom parameters
\

**You can add your own parameters, along with a specific value when you list or edit an offer.** The functionality is available in all categories.

\
**Sample structure, how to add your own parameter:**

```
{
...
"parameters": [...],
"customParameters": [
{
"name": "Name of your own parameter",
"values": [
"Value of your own parameter"
]
}
],
"description": {...},
...
}
```

### Custom values
\
\

**You can add your own values for selected parameters with ambiguous values**. Ambiguous value can be a value such as ”other”, “different pattern”, etc. You can retrieve its identifier via [GET /sale/categories/{categoryId}/parameters](https://developer.allegro.pl/en/documentation/#operation/getFlatParametersUsingGET_2) in **options** section - field **ambiguousValueId**.

For now, you can provide your own value only for [selected parameters](https://assets.allegrostatic.com/popart-attachments/att-5fee661e-0712-4187-904b-aa3b20362839). Information whether a parameter supports this functionality can be checked via [GET /sale/categories/{categoryId}/parameters](https://developer.allegro.pl/en/documentation/#operation/getFlatParametersUsingGET_2) in the **customValuesEnabled** field in the **options** section.

Use this option when you list or edit an offer and choose “Other” as a parameter value. Owing to it, your value will be visible in brackets on the offer page. If it becomes popular, we will move it to the filters.

**In the future, it will be necessary to provide your own value, if you choose an ambiguous parameter value.** When you [create a new product](https://developer.allegro.pl/en/productization/#add) and select an ambiguous value, we always require you to provide your own value.

\
**Sample structure, how to add your own parameter value:**

```
{
...
{
"id": "129033", -- parameter ID
"valuesIds": [
"129033_13" -- ambiguous value ID
],
"values": [ "Missing brand name" ], -- value, which you want to provide.
Complete this field.
"rangeValue": null
}
...
}
```

You can find more information about your own parameters and values in our tutorial:

- [how to add your own parameter](https://developer.allegro.pl/en/sale/#custom-parameters),
- [how to add your own parameter value](https://developer.allegro.pl/en/sale/#custom-parameter-values).