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.

GET
/recipes/{recipeId}/sponsored-products/ingredients
Recipes
Kosten: 10 credits per recept

Antwoord

200
application/json
object[]

IngredientSponsoredProductArray

object[]

IngredientSponsoredProduct

Een receptingrediënt dat aan een gesponsord product is gekoppeld

object

recipeIngredientId

Unieke identificatie van deze ingrediëntvermelding

integer<int32>

recipeId

Identificatie van het recept waartoe dit ingrediënt behoort

integer<int32>

name

Weergavenaam van het ingrediënt

string

quantity?

Hoeveelheid van het gebruikte ingrediënt

number<double> | null

measureUnitId?

Identificatie van de maateenheid voor de hoeveelheid; kan worden opgezocht via GET /definitions/measure-units

integer<int32> | null

unitQuantity

Eenheidshoeveelheid van het gesponsorde product

integer<int32>

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.

integer<int16>

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.

number<double> | null

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.

number<double> | null

productId

Identificatie van het gesponsorde product

integer<int32>

shopProductId?

Winkelspecifieke identificatie van het product

string | null

productName

Naam van het gesponsorde product

string

brand

Merk van het gesponsorde product

string

ean?

EAN-streepjescode van het product

string | null

format?

Verpakkingsvorm van het product

string | null

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

number<double> | null

weightGrams?

Verouderd: gebruik netQuantityGrams, dat dezelfde waarde heeft

number<double> | null

imageUrl?

Afbeeldings-URL van het product

string | null
401
application/json
object

Onbevoegd

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
403
application/json
object

Verboden

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
406
application/json
object

Niet acceptabel

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
422
application/json
object

Niet-verwerkbare entiteit

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
429
application/json
object

Te veel verzoeken

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
500
application/json
object

Interne serverfout

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string