Get ingredient sponsored products for a recipe
특정 레시피의 재료에 명시적으로 연결된 모든 후원 상품을 조회합니다. 단일 레시피를 대상으로 하면 사용자가 해당 요리를 보고 있을 때 기본적으로 배치해야 하는 브랜드 SKU를 즉시 확인할 수 있습니다. 정밀한 타이밍의 리테일 미디어 배치를 위한 완벽한 도구입니다. 사용 사례: 맥락 기반 상품 배치 • 사용자가 '클래식 티라미수' 레시피를 봅니다 → 재료 목록 옆에 '브랜드 Y 마스카르포네'가 후원 추천 상품으로 표시됩니다. 구매 의도가 가장 높은 순간에 높은 전환율을 달성할 수 있습니다. 레스토랑 — 공급업체 파트너십 • 레스토랑이 디지털 메뉴에서 레시피 재료 옆에 공급업체 상품을 표시합니다. 공급업체로부터 광고 수익을 얻을 수 있습니다. 원클릭 '레시피 구매' • 백오피스에서 설정한 후원 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은 필요한 양의 두 배를 구매함을 의미합니다. 점수가 같은 제품은 형식 측면에서 동일하게 호환되므로 priority를 사용해 그중에서 선택하세요. 단, 0.01에서는 척도가 포화되어 포장이 지나치게 크다는 것만 알려 줍니다. 호환성을 평가할 수 없을 때는 Null입니다. 제품 중량을 알 수 없거나, 재료 수량을 그램으로 환산할 수 없거나, 해당 필드가 도입되기 전에 연결되었으며 아직 다시 계산되지 않은 경우가 이에 해당합니다. 부피는 1 ml = 1 g으로 처리합니다.
unitPriceScore?
킬로그램당 가격 점수입니다. 범위는 0.01에서 100까지이며, 이 식재료에 대해 고려된 제품 중 킬로그램당 최저 가격을 이 제품의 킬로그램당 가격으로 나눈 값입니다. 100은 킬로그램당 가격이 가장 저렴하다는 뜻이고, 50은 킬로그램당 가격이 두 배 비싸다는 뜻입니다. 가격은 할인 전 정가이며, 부피는 1밀리리터를 1그램으로 간주합니다. 해당 식재료에 대해 고려된 모든 제품이 비교에 포함되므로, 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?