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.

GET
/recipes/{recipeId}/sponsored-products/ingredients
Recipes
Koszt: 10 kredytów za przepis

Odpowiedź

200
application/json
object[]

IngredientSponsoredProductArray

object[]

IngredientSponsoredProduct

Składnik przepisu powiązany ze sponsorowanym produktem

object

recipeIngredientId

Unikalny identyfikator tego wpisu składnika

integer<int32>

recipeId

Identyfikator przepisu, do którego należy ten składnik

integer<int32>

name

Nazwa składnika wyświetlana użytkownikowi

string

quantity?

Ilość użytego składnika

number<double> | null

measureUnitId?

Identyfikator jednostki miary ilości; można go rozwiązać za pomocą GET /definitions/measure-units

integer<int32> | null

unitQuantity

Liczba jednostek sponsorowanego produktu

integer<int32>

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.

integer<int16>

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.

number<double> | null

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.

number<double> | null

productId

Identyfikator sponsorowanego produktu

integer<int32>

shopProductId?

Identyfikator produktu właściwy dla danego sklepu

string | null

productName

Nazwa sponsorowanego produktu

string

brand

Marka sponsorowanego produktu

string

ean?

Kod kreskowy EAN produktu

string | null

format?

Format opakowania produktu

string | null

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

number<double> | null

weightGrams?

Wycofane: użyj netQuantityGrams, które ma tę samą wartość

number<double> | null

imageUrl?

Adres URL obrazu produktu

string | null
401
application/json
object

Unauthorized

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
403
application/json
object

Forbidden

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
406
application/json
object

Not Acceptable

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
422
application/json
object

Unprocessable Entity

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
429
application/json
object

Zbyt wiele żądań

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
500
application/json
object

Internal Server Error

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string