Get ingredient sponsored products for a recipe

Rufe alle gesponserten Produkte ab, die ausdrücklich mit den Zutaten eines bestimmten Rezepts verknüpft sind. Durch die Auswahl eines einzelnen Rezepts kannst du sofort ermitteln, welche Marken-SKUs nativ platziert werden sollten, wenn der Nutzer dieses bestimmte Gericht betrachtet. Das ideale Tool für präzise zeitlich abgestimmte Retail-Media-Platzierungen. Anwendungsfälle: KONTEXTUELLE PRODUKTPLATZIERUNG • Der Nutzer betrachtet das Rezept „Klassisches Tiramisu“ → „Mascarpone von Marke Y“ erscheint neben der Zutatenliste als gesponserter Vorschlag. Hohe Conversion bei maximaler Kaufabsicht. RESTAURANTS – LIEFERANTENPARTNERSCHAFTEN • Das Restaurant zeigt Lieferantenprodukte neben den Rezeptzutaten in der digitalen Speisekarte. Werbeerlöse von Lieferanten. „REZEPT MIT 1 KLICK KAUFEN“ • Statte die Schaltfläche „Alles zum Warenkorb hinzufügen“ mit im Backoffice konfigurierten gesponserten SKUs aus. Ein profitabler Warenkorb, der auf das Rezept abgestimmt ist.

GET
/recipes/{recipeId}/sponsored-products/ingredients
Recipes
Kosten: 10 Credits pro Rezept

Antwort

200
application/json
object[]

IngredientSponsoredProductArray

object[]

IngredientSponsoredProduct

Eine mit einem gesponserten Produkt verknüpfte Rezeptzutat

object

recipeIngredientId

Eindeutige Kennung für diesen Zutateneintrag

integer<int32>

recipeId

Kennung des Rezepts, zu dem diese Zutat gehört

integer<int32>

name

Anzeigename der Zutat

string

quantity?

Verwendete Menge der Zutat

number<double> | null

measureUnitId?

Kennung der Maßeinheit für die Menge; kann über GET /definitions/measure-units aufgelöst werden

integer<int32> | null

unitQuantity

Einheitenmenge des gesponserten Produkts

integer<int32>

priority

Empfehlungsrang dieses Produkts für die Zutat. Der niedrigste Wert entspricht der besten Übereinstimmung, und die Rangfolge beginnt bei 1. Zuerst richtet sich die Rangfolge nach der Priorität der Produktkategorie des passenden Lebensmittels; innerhalb einer Kategorie werden die Produkte danach geordnet, wie viel du ausgibst, um das Rezept abzudecken, also nach der Anzahl der benötigten Packungen multipliziert mit dem vollen Preis. Diese Ausgaben kombinieren beide Bewertungen: formatScore multipliziert mit unitPriceScore und geteilt durch 100 entspricht den günstigstmöglichen Ausgaben als Prozentsatz der Ausgaben für dieses Produkt. Keine der beiden Bewertungen ist daher für sich allein entlang der Liste monoton. Ränge können Werte überspringen, weil ein Produkt ohne Daten in der angeforderten Sprache aus der Antwort ausgeschlossen wird.

integer<int16>

formatScore?

Formatkompatibilitätswert von 0,01 bis 100: der Prozentsatz dessen, was du kaufst, den das Rezept tatsächlich verwendet. 100 bedeutet, dass die Packungsgröße genau der benötigten Menge entspricht, 50 bedeutet, dass du das Doppelte der benötigten Menge kaufst. Produkte mit demselben Wert sind hinsichtlich des Formats gleichermaßen kompatibel. Verwende daher die Priorität, um zwischen ihnen zu wählen – außer bei 0,01, wo die Skala gesättigt ist und nur angibt, dass die Packung viel zu groß ist. Null, wenn die Kompatibilität nicht bewertet werden kann: Das Produktgewicht ist unbekannt, die Zutatenmenge hat kein Grammäquivalent (z. B. nach Geschmack) oder die Zuordnung besteht bereits vor diesem Feld und wurde noch nicht neu berechnet. Volumen werden behandelt als 1 ml = 1 g.

number<double> | null

unitPriceScore?

Bewertung des Preises pro Kilogramm, von 0,01 bis 100: Der niedrigste Preis pro Kilogramm unter den für diese Zutat berücksichtigten Produkten, geteilt durch den Preis pro Kilogramm dieses Produkts. 100 bedeutet, dass dieses Produkt den niedrigsten Preis pro Kilogramm hat, 50 bedeutet, dass es pro Kilogramm doppelt so viel kostet. Die Preise sind volle Preise vor Abzug von Rabatten, und Volumen werden als 1 ml = 1 g behandelt. Jedes für die Zutat berücksichtigte Produkt fließt in den Vergleich ein, daher muss das Produkt mit der Bewertung 100 nicht unter den zurückgegebenen Produkten sein. Null, wenn die Zuordnung vor Einführung dieses Feldes erstellt und noch nicht neu berechnet wurde.

number<double> | null

productId

Kennung des gesponserten Produkts

integer<int32>

shopProductId?

Händlerspezifische Kennung des Produkts

string | null

productName

Name des gesponserten Produkts

string

brand

Marke des gesponserten Produkts

string

ean?

EAN-Barcode des Produkts

string | null

format?

Verpackungsformat des Produkts

string | null

netQuantityGrams?

Nettmenge des Produkts in Gramm, ausschließlich aus dem vom Händler angegebenen Verpackungsformat abgelesen (Volumen werden als 1 ml = 1 g gerechnet); null, wenn das Format weder ein Gewicht noch ein Volumen angibt

number<double> | null

weightGrams?

Veraltet: Verwende netQuantityGrams, das denselben Wert hat

number<double> | null

imageUrl?

Bild-URL des Produkts

string | null
401
application/json
object

Nicht autorisiert

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
403
application/json
object

Zugriff verweigert

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
406
application/json
object

Nicht akzeptabel

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
422
application/json
object

Nicht verarbeitbare Entität

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
429
application/json
object

Zu viele Anfragen

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
500
application/json
object

Interner Serverfehler

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string