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
No se requieren créditos
Obtener clave de APIVer precios

Get a recipe

GET /recipes/{recipeId}

Get suggestion sponsored products for a recipe

GET /recipes/{recipeId}/sponsored-products/suggestions

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 comienza en 1. Coherente con formatScore: a medida que aumenta la prioridad, la puntuación nunca aumenta, y los productos sin puntuación quedan al final. 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

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

weightGrams?

Peso del producto en gramos

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 (APIM)

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

Puerta de enlace incorrecta (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
504
application/json
object

Tiempo de espera de la puerta de enlace agotado (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string

Get a recipe

GET /recipes/{recipeId}

Get suggestion sponsored products for a recipe

GET /recipes/{recipeId}/sponsored-products/suggestions