Get ingredient sponsored products for a recipe

Belirli bir tarifin malzemelerine açıkça bağlanmış tüm sponsorlu ürünleri alın. Tek bir tarifi hedefleyerek, kullanıcı o yemeği görüntülerken hangi markalı SKU'ların doğal biçimde yerleştirilmesi gerektiğini anında belirleyebilirsiniz. Zamanlaması hassas perakende medya yerleşimleri için ideal araçtır. Kullanım alanları: BAĞLAMA DAYALI ÜRÜN YERLEŞTİRME • Kullanıcı "Klasik Tiramisu" tarifini görüntüler → malzeme listesinin yanında sponsorlu öneri olarak "Brand Y Mascarpone" görünür. Satın alma niyetinin en yüksek olduğu anda yüksek dönüşüm. RESTORANLAR — TEDARİKÇİ ORTAKLIKLARI • Restoran, dijital menüde tarif malzemelerinin yanında tedarikçi ürünlerini gösterir. Tedarikçilerden reklam geliri. 1 TIKLA "TARİFİ SATIN AL" • "Tümünü sepete ekle" düğmesini arka ofiste yapılandırılmış sponsorlu SKU'larla destekleyin. Tarifle uyumlu, kârlı sepet.

GET
/recipes/{recipeId}/sponsored-products/ingredients
Recipes
Maliyet: tarif başına 10 kredi

Yanıt

200
application/json
object[]

IngredientSponsoredProductArray

object[]

IngredientSponsoredProduct

Sponsorlu ürüne bağlanan bir tarif malzemesi

object

recipeIngredientId

Bu malzeme kaydının benzersiz tanımlayıcısı

integer<int32>

recipeId

Bu malzemenin ait olduğu tarifin tanımlayıcısı

integer<int32>

name

Malzemenin görünen adı

string

quantity?

Kullanılan malzeme miktarı

number<double> | null

measureUnitId?

Miktarın ölçü birimi tanımlayıcısı; GET /definitions/measure-units aracılığıyla çözümlenebilir

integer<int32> | null

unitQuantity

Sponsorlu ürünün birim miktarı

integer<int32>

priority

Bu ürünün bu malzeme için öneri sıralaması; en düşük değer en iyi eşleşmedir ve sıralama 1'den başlar. Sıralama, öncelikle eşleşen gıdanın ürün kategorisi önceliğini izler; bir kategori içinde ürünler, tarifi karşılamak için harcadığınız tutara, yani gereken paket sayısı ile tam fiyatın çarpımına göre sıralanır. Bu harcama her iki puanı birleştirir: formatScore ile unitPriceScore çarpımının 100'e bölünmesi, mümkün olan en ucuz harcamanın bu ürünün harcamasının yüzde kaçı olduğunu gösterir. Bu nedenle puanların hiçbiri tek başına liste boyunca monoton değildir. İstenen dilde verisi olmayan bir ürün yanıt dışında bırakıldığı için sıralamalar bazı değerleri atlayabilir.

integer<int16>

formatScore?

0,01 ile 100 arasındaki format uyumluluğu puanı: satın aldığınız miktarın tarifte gerçekten kullanılan yüzdesi. 100, ambalaj boyutunun gereken miktarla tam olarak eşleştiği; 50 ise ihtiyacınızın iki katını satın aldığınız anlamına gelir. Aynı puana sahip ürünler format açısından eşit derecede uyumludur; bu nedenle aralarında seçim yapmak için priority değerini kullanın — ancak ölçeğin doygunluğa ulaştığı 0,01 değeri, yalnızca ambalajın çok büyük olduğunu gösterir. Uyumluluk değerlendirilemiyorsa null değerini alır: ürün ağırlığı bilinmiyorsa, bileşen miktarının gram karşılığı yoksa (örneğin damak tadına göre) veya ilişkilendirme bu alandan önce oluşturulmuş ve henüz yeniden hesaplanmamışsa. Hacimler 1 ml = 1 g olarak değerlendirilir.

number<double> | null

unitPriceScore?

Kilogram başına fiyat puanı, 0,01 ile 100 arasında: bu malzeme için değerlendirilen ürünler arasındaki en düşük kilogram başına fiyatın, bu ürünün kilogram başına fiyatına bölümü. 100, bunun kilogram başına en ucuz ürün olduğu; 50 ise kilogram başına iki kat daha pahalı olduğu anlamına gelir. Fiyatlar herhangi bir indirim uygulanmadan önceki tam fiyatlardır ve hacimler 1 ml = 1 g olarak değerlendirilir. Malzeme için değerlendirilen her ürün karşılaştırmaya dahil edilir; bu nedenle 100 puan alan ürün, döndürülen ürünler arasında bulunmayabilir. İlişkilendirme bu alan eklenmeden önce oluşturulmuş ve henüz yeniden hesaplanmamışsa null döner.

number<double> | null

productId

Sponsorlu ürünün tanımlayıcısı

integer<int32>

shopProductId?

Ürünün mağazaya özgü tanımlayıcısı

string | null

productName

Sponsorlu ürünün adı

string

brand

Sponsorlu ürünün markası

string

ean?

Ürünün EAN barkodu

string | null

format?

Ürünün ambalaj formatı

string | null

netQuantityGrams?

Ürünün, yalnızca satıcının beyan ettiği ambalaj formatından alınan gram cinsinden net miktarı (hacimler 1 ml = 1 g olarak kabul edilir); formatta ağırlık veya hacim belirtilmediğinde null

number<double> | null

weightGrams?

Kullanımdan kaldırıldı: aynı değere sahip netQuantityGrams alanını kullan

number<double> | null

imageUrl?

Ürün görselinin URL'si

string | null
401
application/json
object

Yetkisiz

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
403
application/json
object

Yasaklandı

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
406
application/json
object

Kabul Edilemez

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
422
application/json
object

İşlenemeyen Varlık

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
429
application/json
object

Çok Fazla İstek

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
500
application/json
object

Dahili Sunucu Hatası

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string