- API
- Uç noktalar
- /recipes/{recipeId}/sponsored-products/ingredients
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.
Yanıt
IngredientSponsoredProductArray
object[]
IngredientSponsoredProductArray
IngredientSponsoredProduct
Sponsorlu ürüne bağlanan bir tarif malzemesi
object
IngredientSponsoredProduct
Sponsorlu ürüne bağlanan bir tarif malzemesi
recipeIngredientId
Bu malzeme kaydının benzersiz tanımlayıcısı
recipeId
Bu malzemenin ait olduğu tarifin tanımlayıcısı
name
Malzemenin görünen adı
quantity?
Kullanılan malzeme miktarı
measureUnitId?
Miktarın ölçü birimi tanımlayıcısı; GET /definitions/measure-units aracılığıyla çözümlenebilir
unitQuantity
Sponsorlu ürünün birim miktarı
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.
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.
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.
productId
Sponsorlu ürünün tanımlayıcısı
shopProductId?
Ürünün mağazaya özgü tanımlayıcısı
productName
Sponsorlu ürünün adı
brand
Sponsorlu ürünün markası
ean?
Ürünün EAN barkodu
format?
Ürünün ambalaj formatı
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
weightGrams?
Kullanımdan kaldırıldı: aynı değere sahip netQuantityGrams alanını kullan
imageUrl?
Ürün görselinin URL'si
Yetkisiz
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Yasaklandı
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Kabul Edilemez
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
İşlenemeyen Varlık
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Çok Fazla İstek
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Dahili Sunucu Hatası
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?