Get ingredient sponsored products for a recipe

Recupera tutti i prodotti sponsorizzati collegati esplicitamente agli ingredienti di una ricetta specifica. Concentrandoti su una singola ricetta, puoi determinare istantaneamente quali SKU di marca devono essere inseriti nativamente quando l'utente visualizza quel piatto specifico. Lo strumento ideale per posizionamenti pubblicitari al dettaglio con tempistiche precise. Casi d'uso: POSIZIONAMENTO CONTESTUALE DEI PRODOTTI • L'utente visualizza la ricetta «Classic Tiramisu» → «Brand Y Mascarpone» appare accanto all'elenco degli ingredienti come suggerimento sponsorizzato. Alta probabilità di conversione nel momento di massima intenzione d'acquisto. RISTORANTI — PARTNERSHIP CON I FORNITORI • Il ristorante mostra i prodotti dei fornitori accanto agli ingredienti della ricetta nel menu digitale. Ricavi pubblicitari dai fornitori. «ACQUISTA LA RICETTA» CON UN CLIC • Alimenta il pulsante «Aggiungi tutto al carrello» con gli SKU sponsorizzati configurati nel backoffice. Un carrello redditizio e in linea con la ricetta.

GET
/recipes/{recipeId}/sponsored-products/ingredients
Recipes
Non sono richiesti crediti

Risposta

200
application/json
object[]

IngredientSponsoredProductArray

object[]

IngredientSponsoredProduct

Ingrediente di una ricetta collegato a un prodotto sponsorizzato

object

recipeIngredientId

Identificatore univoco di questa voce dell'ingrediente

integer<int32>

recipeId

Identificatore della ricetta a cui appartiene questo ingrediente

integer<int32>

name

Nome visualizzato dell'ingrediente

string

quantity?

Quantità utilizzata dell'ingrediente

number<double> | null

measureUnitId?

Identificatore dell'unità di misura della quantità; risolvibile tramite GET /definitions/measure-units

integer<int32> | null

unitQuantity

Quantità in unità del prodotto sponsorizzato

integer<int32>

priority

Posizione nella classifica di raccomandazione di questo prodotto per l'ingrediente, dove il valore più basso indica la corrispondenza migliore e la classifica inizia da 1. Coerente con formatScore: all'aumentare della priorità, il punteggio non aumenta mai e i prodotti senza punteggio vengono per ultimi. Le posizioni possono saltare dei valori, perché un prodotto privo di dati nella lingua richiesta viene escluso dalla risposta.

integer<int16>

formatScore?

Punteggio di compatibilità del formato, da 0,01 a 100: la percentuale di ciò che acquisti che la ricetta utilizza effettivamente. 100 indica che il formato della confezione corrisponde esattamente alla quantità richiesta, 50 indica che acquisti il doppio di ciò che ti serve. I prodotti con lo stesso punteggio sono ugualmente compatibili in termini di formato, quindi usa la priorità per scegliere tra loro, tranne nel caso di 0,01, in cui la scala raggiunge il limite e indica solo che la confezione è molto più grande del necessario. Null quando la compatibilità non può essere valutata: il peso del prodotto è sconosciuto, la quantità dell'ingrediente non ha un equivalente in grammi, come nel caso di "quanto basta", oppure l'associazione precede questo campo e non è stata ancora ricalcolata. I volumi vengono trattati come 1 ml = 1 g.

number<double> | null

productId

Identificativo del prodotto sponsorizzato

integer<int32>

shopProductId?

Identificatore del prodotto specifico del negozio

string | null

productName

Nome del prodotto sponsorizzato

string

brand

Marca del prodotto sponsorizzato

string

ean?

Codice a barre EAN del prodotto

string | null

format?

Formato della confezione del prodotto

string | null

weightGrams?

Peso del prodotto in grammi

number<double> | null

imageUrl?

URL dell'immagine del prodotto

string | null
401
application/json
object

Non autorizzato

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
403
application/json
object

Vietato

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
406
application/json
object

Non accettabile

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
422
application/json
object

Entità non elaborabile

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
429
application/json
object

Troppe richieste (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
500
application/json
object

Errore interno del server

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
502
application/json
object

Gateway non valido (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
504
application/json
object

Timeout del gateway (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string