- 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 overeenkomst is en de rangschikking begint bij 1. Consistent met formatScore: naarmate de prioriteit toeneemt, neemt de score nooit toe, en producten zonder score komen als laatste. Rangen kunnen waarden overslaan, omdat een product zonder gegevens in de gevraagde taal uit de respons 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.
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
weightGrams?
Gewicht van het product in gram
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 (APIM)
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Interne serverfout
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Slechte gateway (APIM)
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Time-out van gateway (APIM)
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?