- API
- Eindpunten
- /recipes/{recipeId}/sponsored-products/ingredients
Get ingredient sponsored products for a recipe
Haal alle gesponsorde producten op die expliciet aan de ingrediënten van een specifiek recept zijn gekoppeld. Door je op één recept te richten, kun je direct bepalen welke merk-SKU's native moeten worden geplaatst wanneer de gebruiker dat specifieke gerecht bekijkt. De ideale tool voor nauwkeurig getimede retailmediaplaatsingen. Gebruiksscenario's: CONTEXTUELE PRODUCTPLAATSING • De gebruiker bekijkt het recept 'Classic Tiramisu' → 'Brand Y Mascarpone' verschijnt naast de ingrediëntenlijst als gesponsorde suggestie. Hoge conversie op het moment van maximale koopintentie. RESTAURANTS — LEVERANCIERSPARTNERSCHAPPEN • Het restaurant toont producten van leveranciers naast de receptingrediënten in het digitale menu. Advertentie-inkomsten van leveranciers. RECEPT IN ÉÉN KLIK KOPEN • Voorzie de knop 'Alles aan winkelwagen toevoegen' van gesponsorde SKU's die in de backoffice zijn geconfigureerd. Een winstgevende winkelwagen die aansluit op het recept.
Antwoord
IngredientSponsoredProductArray
object[]
IngredientSponsoredProductArray
IngredientSponsoredProduct
Een receptingrediënt dat aan een gesponsord product is gekoppeld
object
IngredientSponsoredProduct
Een receptingrediënt dat aan een gesponsord product is gekoppeld
recipeIngredientId
Unieke identificatie van deze ingrediëntvermelding
recipeId
Identificatie van het recept waartoe dit ingrediënt behoort
name
Weergavenaam van het ingrediënt
quantity?
Hoeveelheid van het gebruikte ingrediënt
measureUnitId?
Identificatie van de maateenheid voor de hoeveelheid; kan worden opgezocht via GET /definitions/measure-units
unitQuantity
Eenheidshoeveelheid van het gesponsorde product
priority
Aanbevelingsrang van dit product voor het ingrediënt, waarbij de laagste waarde de beste match is en de rangschikking begint bij 1. De rangschikking volgt eerst de prioriteit van de productcategorie van het gematchte voedingsmiddel; binnen een categorie worden producten gerangschikt op basis van wat je uitgeeft om het recept te dekken, dus het aantal benodigde verpakkingen vermenigvuldigd met de volledige prijs. Die uitgave combineert beide scores: formatScore vermenigvuldigd met unitPriceScore, gedeeld door 100, is de goedkoopst mogelijke uitgave als percentage van de uitgave voor dit product. Geen van beide scores is daarom op zichzelf monotoon in de lijst. Rangen kunnen waarden overslaan, omdat een product waarvoor geen gegevens beschikbaar zijn in de gevraagde taal, uit het antwoord wordt weggelaten.
formatScore?
Compatibiliteitsscore van de verpakking, van 0,01 tot 100: het percentage van wat je koopt dat het recept daadwerkelijk gebruikt. 100 betekent dat de verpakkingsgrootte exact overeenkomt met de benodigde hoeveelheid, 50 betekent dat je tweemaal zoveel koopt als je nodig hebt. Producten met dezelfde score zijn even compatibel wat de verpakking betreft, dus gebruik de prioriteit om daartussen te kiezen — behalve bij 0,01, waar de schaal verzadigd is en alleen aangeeft dat de verpakking veel te groot is. Null wanneer de compatibiliteit niet kan worden beoordeeld: het productgewicht is onbekend, de hoeveelheid van het ingrediënt heeft geen gramequivalent (zoals naar smaak), of de koppeling dateert van vóór dit veld en is nog niet opnieuw berekend. Volumes worden behandeld als 1 ml = 1 g.
unitPriceScore?
Score voor de prijs per kilogram, van 0,01 tot 100: de laagste prijs per kilogram van de producten die voor dit ingrediënt in aanmerking komen, gedeeld door de prijs per kilogram van dit product. 100 betekent dat dit product de goedkoopste prijs per kilogram heeft, 50 betekent dat het per kilogram twee keer zo duur is. Prijzen zijn volledige prijzen, vóór eventuele korting, en volumes worden behandeld als 1 ml = 1 g. Elk product dat voor het ingrediënt in aanmerking komt, doet mee aan de vergelijking, dus het product met een score van 100 hoeft niet bij de geretourneerde producten te staan. Null wanneer de koppeling dateert van vóór dit veld en nog niet opnieuw is berekend.
productId
Identificatie van het gesponsorde product
shopProductId?
Winkelspecifieke identificatie van het product
productName
Naam van het gesponsorde product
brand
Merk van het gesponsorde product
ean?
EAN-streepjescode van het product
format?
Verpakkingsvorm van het product
netQuantityGrams?
Nettohoeveelheid van het product in gram, uitsluitend afgelezen uit het verpakkingsformaat dat de handelaar opgeeft (volumes tellen als 1 ml = 1 g); null wanneer het formaat geen gewicht of volume vermeldt
weightGrams?
Verouderd: gebruik netQuantityGrams, dat dezelfde waarde heeft
imageUrl?
Afbeeldings-URL van het product
Onbevoegd
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Verboden
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Niet acceptabel
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Niet-verwerkbare entiteit
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Te veel verzoeken
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Interne serverfout
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?