- API
- Punkty końcowe
- /recipes/{recipeId}/sponsored-products/ingredients
Get ingredient sponsored products for a recipe
Pobierz wszystkie sponsorowane produkty wyraźnie powiązane ze składnikami konkretnego przepisu. Kierując zapytanie do pojedynczego przepisu, możesz natychmiast ustalić, które markowe SKU powinny zostać natywnie umieszczone, gdy użytkownik przegląda dane danie. To idealne narzędzie do precyzyjnie dopasowanych czasowo emisji reklam handlowych. Przypadki użycia: KONTEKSTOWE UMIESZCZANIE PRODUKTÓW • Użytkownik przegląda przepis „Klasyczne tiramisu” → obok listy składników pojawia się „Mascarpone marki Y” jako sponsorowana sugestia. Wysoka konwersja w momencie największej gotowości do zakupu. RESTAURACJE — WSPÓŁPRACA Z DOSTAWCAMI • Restauracja pokazuje produkty dostawców obok składników przepisu w cyfrowym menu. Przychody reklamowe od dostawców. „KUP PRZEPIS” JEDNYM KLIKNIĘCIEM • Zasil przycisk „Dodaj wszystko do koszyka” sponsorowanymi SKU skonfigurowanymi w panelu administracyjnym. Dochodowy koszyk dopasowany do przepisu.
Odpowiedź
IngredientSponsoredProductArray
object[]
IngredientSponsoredProductArray
IngredientSponsoredProduct
Składnik przepisu powiązany ze sponsorowanym produktem
object
IngredientSponsoredProduct
Składnik przepisu powiązany ze sponsorowanym produktem
recipeIngredientId
Unikalny identyfikator tego wpisu składnika
recipeId
Identyfikator przepisu, do którego należy ten składnik
name
Nazwa składnika wyświetlana użytkownikowi
quantity?
Ilość użytego składnika
measureUnitId?
Identyfikator jednostki miary ilości; można go rozwiązać za pomocą GET /definitions/measure-units
unitQuantity
Liczba jednostek sponsorowanego produktu
priority
Pozycja rekomendacji tego produktu dla składnika, gdzie najniższa wartość oznacza najlepsze dopasowanie, a numeracja zaczyna się od 1. Ranking uwzględnia w pierwszej kolejności priorytet kategorii produktu dopasowanego jedzenia; w ramach kategorii produkty są szeregowane według kosztu potrzebnego do pokrycia przepisu, czyli liczby potrzebnych opakowań pomnożonej przez pełną cenę. Koszt ten łączy obie oceny: formatScore pomnożone przez unitPriceScore i podzielone przez 100 oznacza najniższy możliwy koszt jako procent kosztu tego produktu. Żadna z tych ocen nie jest więc sama w sobie monotoniczna na całej liście. Pozycje mogą pomijać niektóre wartości, ponieważ produkt, dla którego nie ma danych w żądanym języku, jest pomijany w odpowiedzi.
formatScore?
Wynik zgodności formatu od 0,01 do 100: procent kupowanej ilości, który przepis faktycznie wykorzystuje. Wartość 100 oznacza, że rozmiar opakowania dokładnie odpowiada wymaganej ilości, a 50 oznacza, że kupujesz dwa razy więcej, niż potrzebujesz. Produkty z takim samym wynikiem są równie zgodne pod względem formatu, więc do wyboru spośród nich użyj priorytetu — z wyjątkiem wartości 0,01, przy której skala osiąga limit i informuje jedynie, że opakowanie jest zdecydowanie za duże. Wartość null, gdy nie można ocenić zgodności: masa produktu jest nieznana, ilość składnika nie ma odpowiednika w gramach (np. do smaku) albo powiązanie powstało przed wprowadzeniem tego pola i nie zostało jeszcze ponownie obliczone. Objętości są traktowane jako 1 ml = 1 g.
unitPriceScore?
Ocena ceny za kilogram, od 0,01 do 100: najniższa cena za kilogram wśród produktów uwzględnionych dla tego składnika podzielona przez cenę za kilogram tego produktu. Wartość 100 oznacza, że jest to najtańszy produkt w przeliczeniu na kilogram, a 50 oznacza, że kosztuje dwa razy więcej za kilogram. Ceny są pełnymi cenami, przed uwzględnieniem wszelkich rabatów, a objętości są traktowane tak, jakby 1 ml = 1 g. Każdy produkt uwzględniony dla tego składnika bierze udział w porównaniu, więc produkt z oceną 100 może nie znajdować się wśród zwróconych produktów. Wartość null, gdy powiązanie utworzono przed dodaniem tego pola i nie zostało ono jeszcze ponownie obliczone.
productId
Identyfikator sponsorowanego produktu
shopProductId?
Identyfikator produktu właściwy dla danego sklepu
productName
Nazwa sponsorowanego produktu
brand
Marka sponsorowanego produktu
ean?
Kod kreskowy EAN produktu
format?
Format opakowania produktu
netQuantityGrams?
Ilość netto produktu w gramach, odczytywana wyłącznie z formatu opakowania zadeklarowanego przez sprzedawcę (objętości liczone jako 1 ml = 1 g); null, gdy format nie podaje masy ani objętości
weightGrams?
Wycofane: użyj netQuantityGrams, które ma tę samą wartość
imageUrl?
Adres URL obrazu produktu
Unauthorized
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Forbidden
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Not Acceptable
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Unprocessable Entity
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Zbyt wiele żądań
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Internal Server Error
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?