Get ingredient sponsored products for a recipe
特定のレシピの材料に明示的に紐付けられた、スポンサー商品をすべて取得します。単一のレシピを対象にすることで、ユーザーがその料理を表示しているときに、どのブランドのSKUをネイティブに配置すべきかを即座に特定できます。タイミングを正確に合わせたリテールメディア掲載に最適なツールです。 利用例: コンテキストに応じた商品掲載 • ユーザーが「Classic Tiramisu」のレシピを表示 → 材料一覧の隣に「Brand Y Mascarpone」がスポンサー付きのおすすめとして表示されます。購入意欲が最高潮に達したタイミングで、高いコンバージョンが期待できます。 レストラン — サプライヤーとの提携 • レストランがデジタルメニューで、レシピの材料の隣にサプライヤーの商品を表示します。サプライヤーから広告収益を得られます。 ワンクリックで「レシピを購入」 • バックオフィスで設定したスポンサーSKUを使って「すべてカートに追加」ボタンを実現します。レシピに合った収益性の高いカートを作成できます。
レスポンス
IngredientSponsoredProductArray
object[]
IngredientSponsoredProductArray
IngredientSponsoredProduct
スポンサー商品にリンクされたレシピ食材
object
IngredientSponsoredProduct
スポンサー商品にリンクされたレシピ食材
recipeIngredientId
この食材エントリの一意識別子
recipeId
この食材が属するレシピの識別子
name
食材の表示名
quantity?
使用する食材の量
measureUnitId?
数量の計量単位識別子。GET /definitions/measure-unitsで解決できます
unitQuantity
スポンサー商品の単位数量
priority
この食材に対するこの商品の推薦順位。値が最も低いほど最適な一致で、順位は1から始まります。順位は、まず一致した食品の商品カテゴリの優先度に従います。カテゴリ内では、レシピをまかなうために必要な支出、つまり必要なパック数に全額の価格を掛けた値によって商品を順位付けします。この支出は両方のスコアを組み合わせたもので、formatScoreにunitPriceScoreを掛けて100で割った値は、この商品の支出に対する、可能な限り安い支出の割合です。したがって、どちらのスコアも単独ではリストに沿って単調に増減しません。要求された言語のデータがない商品はレスポンスから除外されるため、順位の値が飛ぶことがあります。
formatScore?
0.01から100までの形式適合性スコア。購入する量のうち、レシピが実際に使用する割合です。100はパックの容量と必要量が完全に一致することを示し、50は必要量の2倍を購入することを示します。同じスコアの商品は形式の適合性が同等であるため、優先度を使って選択します。ただし0.01の場合は尺度が飽和しており、パックが大きすぎることだけを示します。適合性を評価できない場合はヌルです。商品重量が不明、食材の量にグラム換算値がない(適量など)、またはこのフィールドが追加される前の関連付けで、まだ再計算されていない場合が該当します。容量は1ミリリットル=1グラムとして扱います。
unitPriceScore?
キログラム当たり価格スコア。0.01から100までで、この食材について検討された商品の中で最も低いキログラム当たり価格を、この商品のキログラム当たり価格で割った値です。100はキログラム当たりで最も安いことを、50はキログラム当たりで2倍の費用がかかることを意味します。価格は割引前の全額で、容量は1 ml = 1 gとして扱います。この食材について検討されたすべての商品が比較対象となるため、スコアが100の商品が返却される商品の中に含まれない場合があります。このフィールドが追加される前の関連付けで、まだ再計算されていない場合はNullです。
productId
スポンサー商品識別子
shopProductId?
商品の店舗固有識別子
productName
スポンサー商品の名前
brand
スポンサー商品のブランド
ean?
商品のEANバーコード
format?
商品の包装形式
netQuantityGrams?
商品の正味量(グラム)。販売業者が申告した包装形式からのみ読み取られます(容量は1 ml = 1 gとして扱われます)。形式に重量または容量の記載がない場合はnull
weightGrams?
非推奨: 同じ値を持つ netQuantityGrams を使用してください
imageUrl?
商品の画像URL
認証されていません
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
アクセスが禁止されています
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
受け入れられません
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
処理できないエンティティ
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
リクエストが多すぎます
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
内部サーバーエラー
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?