Get ingredient sponsored products for a recipe

특정 레시피의 재료에 명시적으로 연결된 모든 후원 상품을 조회합니다. 단일 레시피를 대상으로 하면 사용자가 해당 요리를 보고 있을 때 기본적으로 배치해야 하는 브랜드 SKU를 즉시 확인할 수 있습니다. 정밀한 타이밍의 리테일 미디어 배치를 위한 완벽한 도구입니다. 사용 사례: 맥락 기반 상품 배치 • 사용자가 '클래식 티라미수' 레시피를 봅니다 → 재료 목록 옆에 '브랜드 Y 마스카르포네'가 후원 추천 상품으로 표시됩니다. 구매 의도가 가장 높은 순간에 높은 전환율을 달성할 수 있습니다. 레스토랑 — 공급업체 파트너십 • 레스토랑이 디지털 메뉴에서 레시피 재료 옆에 공급업체 상품을 표시합니다. 공급업체로부터 광고 수익을 얻을 수 있습니다. 원클릭 '레시피 구매' • 백오피스에서 설정한 후원 SKU로 '모두 장바구니에 추가' 버튼을 구현합니다. 레시피와 연계된 수익성 있는 장바구니를 만들 수 있습니다.

GET
/recipes/{recipeId}/sponsored-products/ingredients
Recipes
필요한 크레딧 없음

응답

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는 목록 전체에서 단조롭게 변하지 않으며, 한 카테고리 안에서는 낮아지다가 다음 카테고리가 시작되면 다시 높아질 수 있습니다. 요청한 언어로 데이터가 없는 제품은 응답에서 제외되므로 순위가 일부 건너뛸 수 있습니다.

integer<int16>

formatScore?

0.01부터 100까지의 형식 호환성 점수입니다. 구매하는 양 중 레시피에서 실제로 사용하는 양의 백분율을 나타냅니다. 100은 포장 크기가 필요한 양과 정확히 일치함을, 50은 필요한 양의 두 배를 구매함을 의미합니다. 점수가 같은 제품은 형식 측면에서 동일하게 호환되므로 priority를 사용해 그중에서 선택하세요. 단, 0.01에서는 척도가 포화되어 포장이 지나치게 크다는 것만 알려 줍니다. 호환성을 평가할 수 없을 때는 Null입니다. 제품 중량을 알 수 없거나, 재료 수량을 그램으로 환산할 수 없거나, 해당 필드가 도입되기 전에 연결되었으며 아직 다시 계산되지 않은 경우가 이에 해당합니다. 부피는 1 ml = 1 g으로 처리합니다.

number<double> | null

productId

후원 제품의 식별자

integer<int32>

shopProductId?

제품의 매장별 식별자

string | null

productName

후원 제품의 이름

string

brand

후원 제품의 브랜드

string

ean?

제품의 EAN 바코드

string | null

format?

제품의 포장 형식

string | null

weightGrams?

그램 단위의 제품 중량

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

요청이 너무 많음(APIM)

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
502
application/json
object

잘못된 게이트웨이(APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
504
application/json
object

게이트웨이 시간 초과(APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string