Get ingredient sponsored products for a recipe

Recupera todos los productos patrocinados vinculados explícitamente a los ingredientes de una receta específica. Al dirigirte a una sola receta, puedes resolver al instante qué SKU de marca deben colocarse de forma nativa cuando el usuario está viendo ese plato concreto. La herramienta perfecta para emplazamientos de medios minoristas programados con precisión. Casos de uso: INSERCIÓN CONTEXTUAL DE PRODUCTOS • El usuario consulta la receta «Classic Tiramisu» → «Brand Y Mascarpone» aparece junto a la lista de ingredientes como sugerencia patrocinada. Alta conversión en el momento de máxima intención de compra. RESTAURANTES — COLABORACIONES CON PROVEEDORES • El restaurante muestra productos de proveedores junto a los ingredientes de la receta en el menú digital. Ingresos publicitarios de los proveedores. «COMPRA LA RECETA» CON UN CLIC • Activa el botón «Añadir todo al carrito» con los SKU patrocinados configurados en el panel de administración. Un carrito rentable y alineado con la receta.

GET
/recipes/{recipeId}/sponsored-products/ingredients
Recipes
Coste: 10 créditos por receta

Respuesta

200
application/json
object[]

IngredientSponsoredProductArray

object[]

IngredientSponsoredProduct

Ingrediente de una receta vinculado a un producto patrocinado

object

recipeIngredientId

Identificador único de esta entrada de ingrediente

integer<int32>

recipeId

Identificador de la receta a la que pertenece este ingrediente

integer<int32>

name

Nombre que se muestra para el ingrediente

string

quantity?

Cantidad de ingrediente utilizada

number<double> | null

measureUnitId?

Identificador de la unidad de medida de la cantidad; se puede resolver mediante GET /definitions/measure-units

integer<int32> | null

unitQuantity

Cantidad de unidades del producto patrocinado

integer<int32>

priority

Rango de recomendación de este producto para el ingrediente, donde el valor más bajo es la mejor coincidencia y la clasificación empieza en 1. La clasificación sigue primero la prioridad de la categoría de producto del alimento coincidente; dentro de una categoría, los productos se clasifican según lo que gastas para cubrir la receta, es decir, los envases necesarios multiplicados por el precio total. Ese gasto combina ambas puntuaciones: formatScore multiplicado por unitPriceScore y dividido entre 100 representa el gasto mínimo posible como porcentaje del gasto de este producto. Por tanto, ninguna de las dos puntuaciones es monotónica por sí sola a lo largo de la lista. Los rangos pueden omitir valores, porque los productos que no tienen datos en el idioma solicitado se excluyen de la respuesta.

integer<int16>

formatScore?

Puntuación de compatibilidad del formato, de 0,01 a 100: el porcentaje de lo que compras que realmente utiliza la receta. 100 significa que el tamaño del envase coincide exactamente con la cantidad necesaria; 50 significa que compras el doble de lo que necesitas. Los productos con la misma puntuación son igualmente compatibles en cuanto al formato, así que usa la prioridad para elegir entre ellos, excepto en 0,01, donde la escala se satura y solo indica que el envase es demasiado grande. Nulo cuando no se puede evaluar la compatibilidad: se desconoce el peso del producto, la cantidad del ingrediente no tiene un equivalente en gramos, como «al gusto», o la asociación es anterior a este campo y aún no se ha recalculado. Los volúmenes se tratan como 1 ml = 1 g.

number<double> | null

unitPriceScore?

Puntuación del precio por kilogramo, de 0,01 a 100: el precio más bajo por kilogramo entre los productos considerados para este ingrediente, dividido por el precio por kilogramo de este producto. 100 significa que este es el producto más barato por kilogramo; 50 significa que cuesta el doble por kilogramo. Los precios son completos, antes de cualquier descuento, y los volúmenes se tratan como 1 ml = 1 g. Todos los productos considerados para el ingrediente participan en la comparación, por lo que el que obtiene una puntuación de 100 puede no estar entre los que se devuelven. Nulo cuando la asociación es anterior a este campo y todavía no se ha vuelto a calcular.

number<double> | null

productId

Identificador del producto patrocinado

integer<int32>

shopProductId?

Identificador específico de la tienda para el producto

string | null

productName

Nombre del producto patrocinado

string

brand

Marca del producto patrocinado

string

ean?

Código de barras EAN del producto

string | null

format?

Formato del envase del producto

string | null

netQuantityGrams?

Cantidad neta del producto en gramos, leída únicamente del formato del envase que declara el comerciante (los volúmenes cuentan como 1 ml = 1 g); null cuando el formato no indica un peso ni un volumen

number<double> | null

weightGrams?

Obsoleto: usa netQuantityGrams, que tiene el mismo valor

number<double> | null

imageUrl?

URL de la imagen del producto

string | null
401
application/json
object

No autorizado

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
403
application/json
object

Prohibido

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
406
application/json
object

No aceptable

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
422
application/json
object

Entidad no procesable

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
429
application/json
object

Demasiadas solicitudes

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
500
application/json
object

Error interno del servidor

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string