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
Geen credits vereist

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 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.

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

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

weightGrams?

Gewicht van het product in gram

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 (APIM)

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
502
application/json
object

Slechte gateway (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
504
application/json
object

Time-out van gateway (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string