Get ingredient sponsored products for a recipe

Az adott recept hozzávalóihoz kifejezetten kapcsolt összes szponzorált termék lekérése. Egyetlen recept célzásával azonnal meghatározhatod, mely márkázott cikkszámokat kell natívan elhelyezni, amikor a felhasználó az adott ételt nézi. Ideális eszköz a pontosan időzített kiskereskedelmi médiamegjelenésekhez. Felhasználási esetek: KONTEXTUSALAPÚ TERMÉKELHELYEZÉS • A felhasználó megtekinti a „Klasszikus tiramisu” receptjét → a „Y márkájú mascarpone” szponzorált ajánlatként jelenik meg a hozzávalók listája mellett. Magas konverzió a vásárlási szándék csúcspontján. ÉTTERMEK — BESZÁLLÍTÓI PARTNERSÉGEK • Az étterem a beszállítók termékeit a recept hozzávalói mellett jeleníti meg a digitális étlapon. A beszállítóktól származó hirdetési bevétel. „A RECEPT MEGVÁSÁRLÁSA” EGY KATTINTÁSSAL • A „Mindet a kosárba” gombot a háttérirodában beállított szponzorált cikkszámokkal működtetheted. Nyereséges, a recepthez igazodó kosár.

GET
/recipes/{recipeId}/sponsored-products/ingredients
Recipes
Nincs szükség kreditre

Válasz

200
application/json
object[]

IngredientSponsoredProductArray

object[]

IngredientSponsoredProduct

Egy szponzorált termékhez kapcsolt recept-hozzávaló

object

recipeIngredientId

A hozzávaló-bejegyzés egyedi azonosítója

integer<int32>

recipeId

A recept azonosítója, amelyhez ez a hozzávaló tartozik

integer<int32>

name

A hozzávaló megjelenítési neve

string

quantity?

A felhasznált hozzávaló mennyisége

number<double> | null

measureUnitId?

A mennyiség mértékegységének azonosítója; a GET /definitions/measure-units segítségével oldható fel

integer<int32> | null

unitQuantity

A szponzorált termék mennyiségi egysége

integer<int32>

priority

A termék ajánlási rangsora az összetevőhöz, ahol az alacsonyabb érték jelent jobb egyezést, a rangsorolás pedig 1-től kezdődik. Összhangban a formatScore értékkel: a prioritás növekedésével a pontszám soha nem nő, és a pontszám nélküli termékek kerülnek a lista végére. A rangsorban lehetnek kihagyott értékek, mert azokat a termékeket, amelyekhez nincs adat a kért nyelven, a rendszer kihagyja a válaszból.

integer<int16>

formatScore?

Formátumkompatibilitási pontszám 0,01 és 100 között: a megvásárolt mennyiség azon százaléka, amelyet a recept ténylegesen felhasznál. A 100 azt jelenti, hogy a csomag mérete pontosan megegyezik a szükséges mennyiséggel, az 50 pedig azt, hogy a szükséges mennyiség kétszeresét vásárolod meg. Az azonos pontszámú termékek formátum szempontjából egyformán kompatibilisek, ezért közülük a prioritás alapján válassz — kivéve 0,01 esetén, amikor a skála telítődése csak azt jelzi, hogy a csomag sokkal nagyobb a szükségesnél. Null érték, ha a kompatibilitás nem állapítható meg: a termék tömege ismeretlen, az összetevő mennyiségének nincs grammra átszámítható megfelelője (például ízlés szerint), vagy a hozzárendelés megelőzi ennek a mezőnek a bevezetését, és még nem számították újra. A térfogatokat úgy kezeljük, hogy 1 ml = 1 g.

number<double> | null

productId

A támogatott termék azonosítója

integer<int32>

shopProductId?

A termék üzletspecifikus azonosítója

string | null

productName

A támogatott termék neve

string

brand

A támogatott termék márkája

string

ean?

A termék EAN-vonalkódja

string | null

format?

A termék csomagolási formátuma

string | null

weightGrams?

A termék tömege grammban

number<double> | null

imageUrl?

A termék képének URL-je

string | null
401
application/json
object

Nem hitelesített

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
403
application/json
object

Tilos

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
406
application/json
object

Nem elfogadható

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
422
application/json
object

Feldolgozhatatlan entitás

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
429
application/json
object

Túl sok kérés (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
500
application/json
object

Belső szerverhiba

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
502
application/json
object

Hibás átjáró (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
504
application/json
object

Átjáró-időtúllépés (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string