- 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. Zgodne z formatScore: wraz ze wzrostem priorytetu wynik nigdy nie rośnie, a produkty bez wyniku są umieszczane na końcu. Pozycje mogą pomijać wartości, ponieważ produkt, który 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.
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
weightGrams?
Waga produktu w gramach
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?
Too Many Requests (APIM)
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Internal Server Error
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Bad Gateway (APIM)
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Gateway Timeout (APIM)
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?