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
Costo: 10 crediti per ricetta

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 delle raccomandazioni di questo prodotto per l'ingrediente, dove il valore più basso indica la corrispondenza migliore e la classifica inizia da 1. La classifica segue innanzitutto la priorità della categoria di prodotto dell'alimento abbinato; all'interno di una categoria, i prodotti sono classificati in base alla spesa necessaria per coprire la ricetta, ovvero il numero di confezioni necessarie moltiplicato per il prezzo intero. Questa spesa combina entrambi i punteggi: formatScore moltiplicato per unitPriceScore, diviso per 100, rappresenta la spesa minima possibile come percentuale della spesa per questo prodotto. Pertanto, nessuno dei due punteggi è monotono lungo l'elenco preso singolarmente. Le posizioni possono non essere consecutive, 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

unitPriceScore?

Punteggio del prezzo al chilogrammo, da 0,01 a 100: il prezzo al chilogrammo più basso tra i prodotti considerati per questo ingrediente, diviso per il prezzo al chilogrammo di questo prodotto. 100 significa che questo è il prodotto più economico al chilogrammo, 50 significa che costa il doppio al chilogrammo. I prezzi sono prezzi interi, prima di qualsiasi sconto, e i volumi sono trattati come 1 ml = 1 g. Ogni prodotto considerato per l'ingrediente partecipa al confronto, quindi quello con punteggio 100 potrebbe non essere tra quelli restituiti. Nullo quando l'associazione precede l'introduzione di questo campo e non è ancora stata ricalcolata.

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

netQuantityGrams?

Quantità netta del prodotto in grammi, ricavata esclusivamente dal formato della confezione dichiarato dal commerciante (i volumi contano come 1 ml = 1 g); null quando il formato non indica un peso o un volume

number<double> | null

weightGrams?

Obsoleto: usa netQuantityGrams, che ha lo stesso valore

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

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