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