Get ingredient sponsored products for a recipe

特定のレシピの材料に明示的に紐付けられた、スポンサー商品をすべて取得します。単一のレシピを対象にすることで、ユーザーがその料理を表示しているときに、どのブランドのSKUをネイティブに配置すべきかを即座に特定できます。タイミングを正確に合わせたリテールメディア掲載に最適なツールです。 利用例: コンテキストに応じた商品掲載 • ユーザーが「Classic Tiramisu」のレシピを表示 → 材料一覧の隣に「Brand Y Mascarpone」がスポンサー付きのおすすめとして表示されます。購入意欲が最高潮に達したタイミングで、高いコンバージョンが期待できます。 レストラン — サプライヤーとの提携 • レストランがデジタルメニューで、レシピの材料の隣にサプライヤーの商品を表示します。サプライヤーから広告収益を得られます。 ワンクリックで「レシピを購入」 • バックオフィスで設定したスポンサーSKUを使って「すべてカートに追加」ボタンを実現します。レシピに合った収益性の高いカートを作成できます。

GET
/recipes/{recipeId}/sponsored-products/ingredients
Recipes
料金: 10クレジット(レシピ1件あたり)

レスポンス

200
application/json
object[]

IngredientSponsoredProductArray

object[]

IngredientSponsoredProduct

スポンサー商品にリンクされたレシピ食材

object

recipeIngredientId

この食材エントリの一意識別子

integer<int32>

recipeId

この食材が属するレシピの識別子

integer<int32>

name

食材の表示名

string

quantity?

使用する食材の量

number<double> | null

measureUnitId?

数量の計量単位識別子。GET /definitions/measure-unitsで解決できます

integer<int32> | null

unitQuantity

スポンサー商品の単位数量

integer<int32>

priority

この食材に対するこの商品の推薦順位。値が最も低いほど最適な一致で、順位は1から始まります。順位は、まず一致した食品の商品カテゴリの優先度に従います。カテゴリ内では、レシピをまかなうために必要な支出、つまり必要なパック数に全額の価格を掛けた値によって商品を順位付けします。この支出は両方のスコアを組み合わせたもので、formatScoreにunitPriceScoreを掛けて100で割った値は、この商品の支出に対する、可能な限り安い支出の割合です。したがって、どちらのスコアも単独ではリストに沿って単調に増減しません。要求された言語のデータがない商品はレスポンスから除外されるため、順位の値が飛ぶことがあります。

integer<int16>

formatScore?

0.01から100までの形式適合性スコア。購入する量のうち、レシピが実際に使用する割合です。100はパックの容量と必要量が完全に一致することを示し、50は必要量の2倍を購入することを示します。同じスコアの商品は形式の適合性が同等であるため、優先度を使って選択します。ただし0.01の場合は尺度が飽和しており、パックが大きすぎることだけを示します。適合性を評価できない場合はヌルです。商品重量が不明、食材の量にグラム換算値がない(適量など)、またはこのフィールドが追加される前の関連付けで、まだ再計算されていない場合が該当します。容量は1ミリリットル=1グラムとして扱います。

number<double> | null

unitPriceScore?

キログラム当たり価格スコア。0.01から100までで、この食材について検討された商品の中で最も低いキログラム当たり価格を、この商品のキログラム当たり価格で割った値です。100はキログラム当たりで最も安いことを、50はキログラム当たりで2倍の費用がかかることを意味します。価格は割引前の全額で、容量は1 ml = 1 gとして扱います。この食材について検討されたすべての商品が比較対象となるため、スコアが100の商品が返却される商品の中に含まれない場合があります。このフィールドが追加される前の関連付けで、まだ再計算されていない場合はNullです。

number<double> | null

productId

スポンサー商品識別子

integer<int32>

shopProductId?

商品の店舗固有識別子

string | null

productName

スポンサー商品の名前

string

brand

スポンサー商品のブランド

string

ean?

商品のEANバーコード

string | null

format?

商品の包装形式

string | null

netQuantityGrams?

商品の正味量(グラム)。販売業者が申告した包装形式からのみ読み取られます(容量は1 ml = 1 gとして扱われます)。形式に重量または容量の記載がない場合はnull

number<double> | null

weightGrams?

非推奨: 同じ値を持つ netQuantityGrams を使用してください

number<double> | null

imageUrl?

商品の画像URL

string | null
401
application/json
object

認証されていません

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
403
application/json
object

アクセスが禁止されています

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
406
application/json
object

受け入れられません

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
422
application/json
object

処理できないエンティティ

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
429
application/json
object

リクエストが多すぎます

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
500
application/json
object

内部サーバーエラー

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string