Get ingredient sponsored products for a recipe

Récupérez tous les produits sponsorisés explicitement associés aux ingrédients d’une recette spécifique. En ciblant une seule recette, vous pouvez déterminer instantanément quels SKU de marque doivent être placés nativement lorsque l’utilisateur consulte ce plat précis. L’outil idéal pour des placements de retail media parfaitement synchronisés. Cas d’utilisation : PLACEMENT DE PRODUITS CONTEXTUEL • L’utilisateur consulte la recette « Classic Tiramisu » → « Brand Y Mascarpone » apparaît à côté de la liste des ingrédients comme suggestion sponsorisée. Taux de conversion élevé au moment où l’intention d’achat est maximale. RESTAURANTS — PARTENARIATS AVEC DES FOURNISSEURS • Le restaurant affiche les produits des fournisseurs à côté des ingrédients de la recette dans le menu numérique. Les fournisseurs génèrent des revenus publicitaires. « ACHETER LA RECETTE » EN 1 CLIC • Alimentez le bouton « Tout ajouter au panier » avec les SKU sponsorisés configurés dans le back-office. Un panier rentable et cohérent avec la recette.

GET
/recipes/{recipeId}/sponsored-products/ingredients
Recipes
Aucun crédit requis

Réponse

200
application/json
object[]

IngredientSponsoredProductArray

object[]

IngredientSponsoredProduct

Ingrédient d’une recette associé à un produit sponsorisé

object

recipeIngredientId

Identifiant unique de cette entrée d’ingrédient

integer<int32>

recipeId

Identifiant de la recette à laquelle appartient cet ingrédient

integer<int32>

name

Nom d’affichage de l’ingrédient

string

quantity?

Quantité d’ingrédient utilisée

number<double> | null

measureUnitId?

Identifiant de l’unité de mesure de la quantité ; peut être résolu via GET /definitions/measure-units

integer<int32> | null

unitQuantity

Quantité unitaire du produit sponsorisé

integer<int32>

priority

Rang de recommandation de ce produit pour l'ingrédient : la valeur la plus basse correspond à la meilleure correspondance et le classement commence à 1. Cohérent avec formatScore : lorsque la priorité augmente, le score n'augmente jamais, et les produits sans score apparaissent en dernier. Les rangs peuvent sauter des valeurs, car un produit sans données dans la langue demandée est exclu de la réponse.

integer<int16>

formatScore?

Score de compatibilité du format, de 0,01 à 100 : pourcentage de ce que tu achètes réellement utilisé par la recette. 100 signifie que le format du paquet correspond exactement à la quantité requise, 50 signifie que tu achètes deux fois la quantité nécessaire. Les produits ayant le même score sont également compatibles en termes de format ; utilise donc la priorité pour les départager, sauf à 0,01, où l'échelle sature et indique seulement que le paquet est beaucoup trop grand. Null lorsque la compatibilité ne peut pas être évaluée : le poids du produit est inconnu, la quantité de l'ingrédient n'a pas d'équivalent en grammes, comme « à volonté », ou l'association est antérieure à l'introduction de ce champ et n'a pas encore été recalculée. Les volumes sont traités selon l'équivalence 1 ml = 1 g.

number<double> | null

productId

Identifiant du produit sponsorisé

integer<int32>

shopProductId?

Identifiant du produit propre au magasin

string | null

productName

Nom du produit sponsorisé

string

brand

Marque du produit sponsorisé

string

ean?

Code-barres EAN du produit

string | null

format?

Format d’emballage du produit

string | null

weightGrams?

Poids du produit en grammes

number<double> | null

imageUrl?

URL de l'image du produit

string | null
401
application/json
object

Non autorisé

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
403
application/json
object

Interdit

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
406
application/json
object

Non acceptable

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
422
application/json
object

Entité non traitable

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
429
application/json
object

Trop de requêtes (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
500
application/json
object

Erreur interne du serveur

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
502
application/json
object

Passerelle incorrecte (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
504
application/json
object

Délai d’expiration de la passerelle (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string