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
Coût : 10 crédits par recette

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. Le classement suit d’abord la priorité des catégories de produits de l’aliment correspondant ; au sein d’une catégorie, les produits sont classés selon la dépense nécessaire pour couvrir la recette, c’est-à-dire le nombre de paquets nécessaires multiplié par le prix total. Cette dépense combine les deux scores : formatScore multiplié par unitPriceScore, divisé par 100, correspond à la dépense minimale possible exprimée en pourcentage de la dépense pour ce produit. Aucun des deux scores n’est donc monotone à lui seul dans la liste. 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

unitPriceScore?

Score du prix au kilogramme, de 0,01 à 100 : le prix au kilogramme le plus bas parmi les produits pris en compte pour cet ingrédient, divisé par le prix au kilogramme de ce produit. 100 signifie que c’est le produit le moins cher au kilogramme ; 50 signifie qu’il coûte deux fois plus cher au kilogramme. Les prix sont les prix totaux, avant toute remise, et les volumes sont considérés comme équivalant à 1 ml = 1 g. Tous les produits pris en compte pour l’ingrédient participent à la comparaison ; celui qui obtient un score de 100 peut donc ne pas figurer parmi ceux renvoyés. Null lorsque l’association est antérieure à l’ajout de ce champ et n’a pas encore été recalculée.

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

netQuantityGrams?

Quantité nette du produit en grammes, indiquée uniquement dans le format d’emballage déclaré par le commerçant (les volumes sont comptés comme 1 ml = 1 g) ; null lorsque le format n’indique ni poids ni volume

number<double> | null

weightGrams?

Obsolète : utilisez netQuantityGrams, qui a la même valeur

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

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