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
Költség: 10 kredit receptenként

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 ehhez az összetevőhöz: a legalacsonyabb érték a legjobb egyezést jelenti, a rangsorolás pedig 1-től kezdődik. A rangsor elsősorban az egyező élelmiszer termékkategória-prioritását követi; egy kategórián belül a termékeket az alapján rangsorolja, hogy mennyit kell elkölteni a recept elkészítéséhez, vagyis a szükséges csomagok számának és a teljes árnak a szorzata alapján. Ez a ráfordítás mindkét pontszámot kombinálja: a formatScore és a unitPriceScore szorzata 100-zal osztva azt mutatja, hogy a lehető legalacsonyabb ráfordítás ennek a terméknek a ráfordításához képest hány százalék. Ezért egyik pontszám sem monoton önmagában a listán. A rangsorszámokban lehetnek kihagyások, mert a kért nyelven adatokkal nem rendelkező termékek kimaradnak 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

unitPriceScore?

Kilogrammonkénti ár pontszáma 0,01 és 100 között: az ehhez az összetevőhöz figyelembe vett termékek közül a legalacsonyabb kilogrammonkénti ár osztva a termék kilogrammonkénti árával. A 100 azt jelenti, hogy ez a legolcsóbb kilogrammonként, az 50 pedig azt, hogy kilogrammonként kétszer annyiba kerül. Az árak teljes árak, minden kedvezmény előtt, a térfogatokat pedig úgy kell kezelni, mintha 1 ml = 1 g lenne. Az összetevőhöz figyelembe vett minden termék részt vesz az összehasonlításban, ezért a 100-as pontszámot elérő termék nem feltétlenül szerepel a visszaadott termékek között. Null, ha a társítás megelőzi ennek a mezőnek a bevezetését, és még nem számították újra.

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

netQuantityGrams?

A termék nettó mennyisége grammban, kizárólag a kereskedő által megadott csomagolási formátumból kiolvasva (a térfogatoknál 1 ml = 1 g); null, ha a forma nem ad meg tömeget vagy térfogatot

number<double> | null

weightGrams?

Elavult: használd a netQuantityGrams mezőt, amely ugyanazt az értéket tartalmazza

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

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