Recipe

Esempio di ricerca di immagini su un dispositivo mobile ed esempio di un risultato multimediale

Esegui il markup dei contenuti di ricette con dati strutturati per fornire risultati completi ed elenchi specifici dell'host per le tue ricette, come valutazioni dei recensori, tempi di cottura e di preparazione e informazioni nutrizionali. La tua pagina è idonea a funzionalità diverse a seconda di come aggiungi dati strutturati alla tua pagina:

  • Ricerca: aggiungi i dati strutturati della ricetta per migliorare il coinvolgimento nella ricerca con risultati multimediali.
  • Indicazioni: attiva l'Assistente Google per guidare gli utenti attraverso le tue ricette su Google Home e su smart display.
  • Carosello: aggiungi dati strutturati di carosello per consentire alla tua ricetta di apparire in un carosello di risultati multimediali. Questi possono comprendere immagini, loghi di pagina e altre interessanti funzionalità dei risultati di ricerca.
  • AMP: crea le tue pagine di ricette con AMP per fornire ricette a caricamento istantaneo.

Strutturando i tuoi contenuti in base a questa guida, questi potrebbero attivare automaticamente le seguenti funzionalità:

  • Badge di ricetta nei risultati di ricerca delle immagini per dispositivi mobili
  • Azione di contenuto nell'Assistente Google

Esempi

Ecco alcuni esempi di ricette con codice JSON-LD nello Strumento di test per i dati strutturati.

Esempio di ricetta

Ecco un esempio di una pagina con recipe e indicazioni per i dati strutturati. Questi contenuti possono essere idonei per essere visualizzati come un risultato multimediale nei risultati di ricerca e nelle indicazioni con l'Assistente Google su Google Home e smart display.

Ecco un esempio di una pagina di riepilogo della ricetta (una pagina con un elenco di ricette) con dati strutturati itemList. Questi contenuti possono essere idonei a essere visualizzati in un carosello nei risultati di ricerca.

Linee guida

Devi rispettare le linee guida generali sui dati strutturati affinché la tua ricetta sia idonea a essere mostrata nei risultati di ricerca. Per poter attivare le indicazioni della ricetta tramite l'Assistente Google su Google Home e smart display, assicurati che i tuoi contenuti rispettino le norme sulle restrizioni dei contenuti per Actions on Google.

Le seguenti linee guida valgono per i dati strutturati delle ricette.

  • Utilizza i dati strutturati della ricetta per i contenuti sulla preparazione di un determinato piatto. Ad esempio, "scrub viso" o "idee per feste" non sono nomi validi per un piatto.
  • Per far sì che le tue ricette compaiano in un elenco specifico dell'host, devi seguire queste linee guida:
    • Fornisci dati strutturati ItemList per riepilogare le ricette per il tuo elenco. Puoi fornire i dati strutturati ItemList separatamente o insieme ai dati strutturati della ricetta.
    • Il tuo sito deve avere una pagina di riepilogo che mostra tutte le ricette nella raccolta. Ad esempio, quando un utente fa clic sul link di riepilogo dai risultati di ricerca, viene reindirizzato correttamente a una pagina sul sito che elenca le ricette correlate alla sua ricerca.

Definizioni dei tipi di dati strutturati

Affinché i tuoi contenuti siano idonei per essere visualizzati come risultato multimediale o in altre esperienze Google, devi includere le proprietà obbligatorie. Puoi anche includere le proprietà consigliate per aggiungere ulteriori informazioni sui tuoi contenuti, fornendo così un'esperienza utente migliore.

ItemList

La definizione completa di ItemList è disponibile su schema.org/ItemList.

Oltre alle proprietà della ricetta, aggiungi le seguenti proprietà per gli elenchi specifici dell'host. Sebbene ItemList non sia richiesto, è necessario aggiungere le seguenti proprietà se vuoi che la ricetta sia idonea per un carosello host. Per ulteriori informazioni sugli elenchi specifici dell'host, vedi Carosello.

Proprietà obbligatorie
itemListElement

ListItem

Annotazione per una singola pagina elemento.

ListItem.position

Integer

Posizione ordinale della pagina elemento nell'elenco. Ad esempio:


"itemListElement": [
  {
    "@type": "ListItem",
    "position": 1,
  }, {
    "@type": "ListItem",
    "position": 2,
  }
]
ListItem.url

URL

L'URL canonico della pagina elemento. Ogni elemento deve avere un URL univoco.

Recipe

La definizione completa di Recipe è disponibile su schema.org/Recipe. Esegui il markup dei contenuti della tua ricetta con le seguenti proprietà del tipo Recipe di schema.org. Oltre ai campi obbligatori, esegui il markup per il maggior numero di campi possibile al fine di migliorare il coinvolgimento in Ricerca.

Per poter attivare le indicazioni della ricetta tramite l'Assistente Google su Google Home e sugli smart display, assicurati di aggiungere la recipeIngredient e la recipeInstructions. Se la tua ricetta non dispone di queste proprietà, non è idonea per le indicazioni, ma potrebbe comunque essere idonea a comparire nei risultati di ricerca.

Proprietà obbligatorie
image

URL o ImageObject

Immagine del piatto completato.

Ulteriori linee guida per le immagini:

  • Ogni pagina deve contenere almeno un'immagine (indipendentemente dal fatto che includa markup o meno). Google sceglierà l'immagine migliore da visualizzare nei risultati di ricerca in base alle proporzioni e alla risoluzione.
  • Gli URL immagine devono poter essere sottoposti a scansione e indicizzati.
  • Le immagini devono rappresentare i contenuti sottoposti a markup.
  • Le immagini devono essere in formato .JPG, .PNG o .GIF.
  • Per ottenere i migliori risultati, fornisci più immagini ad alta risoluzione (minimo 50 K pixel moltiplicando larghezza e altezza) con le seguenti proporzioni: 4x3, 16x9 e 1x1.

Ad esempio:

"image": [
  "https://example.com/photos/1x1/photo.jpg",
  "https://example.com/photos/4x3/photo.jpg",
  "https://example.com/photos/16x9/photo.jpg"
]
name

Text

Il nome del piatto.

Proprietà consigliate
aggregateRating

AggregateRating

Annotazione per il punteggio di recensione medio assegnato all'elemento. Segui le linee guida sugli snippet recensione e l'elenco di proprietà AggregateRating obbligatorie e consigliate.

Se i dati strutturati della ricetta contengono un'unica recensione, il nome del recensore deve essere una persona o un'organizzazione valida. Ad esempio, "50% di sconto sugli ingredienti" non è un nome valido per un recensore.

author

Person

La persona che ha ideato la ricetta.

cookTime

Duration

Il tempo necessario per cucinare effettivamente il piatto in formato ISO 8601. Puoi usare min e max come elementi secondari per specificare un intervallo di tempo.

Usali sempre in combinazione con prepTime.

datePublished

Date

La data in cui la ricetta è stata pubblicata in formato ISO 8601.

description

Text

Un breve riassunto che descrive il piatto.

keywords

Text

Altri termini per la ricetta, come la stagione ("estate"), il periodo ("Halloween") o altri descrittori validi ("veloce", "facile", "originale").

Linee guida aggiuntive

  • Separa più voci in un elenco di parole chiave con virgole.
  • Non utilizzare tag che dovrebbero essere in recipeCategory o recipeCuisine.

    Non consigliato

    "keywords": "dessert, American"

    Consigliato

    "keywords": "winter apple pie, nutmeg crust"
nutrition.calories

Energy

Il numero di calorie in ogni porzione.

prepTime

Duration

Il tempo necessario per preparare il piatto, in formato ISO 8601. Puoi usare min e max come elementi secondari per specificare un intervallo di tempo.

Usali sempre in combinazione con cookTime.

recipeCategory

Text

Il tipo di piatto o la portata della tua ricetta. Ad esempio: "cena", "antipasto" o "dessert, merenda".

recipeCuisine

Text

La regione associata alla tua ricetta. Ad esempio, "francese", "mediterraneo" o "americano".

recipeIngredient

Text

Un ingrediente usato nella ricetta. Questa proprietà è consigliata per le ricette su Ricerca Google, ma è richiesta per le indicazioni dell'Assistente Google su Google Home e smart display.

Ad esempio:

"recipeIngredient": [
  "1 box Pillsbury dough",
  "6 cups thinly sliced, peeled apples (6 medium)",
  "3/4 cup sugar",
  "2 tablespoons all-purpose flour",
  "3/4 teaspoon ground cinnamon",
  "1/4 teaspoon salt",
  "1/8 teaspoon ground nutmeg",
  "1 tablespoon lemon juice"
]

Linee guida aggiuntive:

  • Includi solo il testo dell'ingrediente necessario per preparare la ricetta.
  • Non includere informazioni inutili, come le definizioni degli ingredienti.
recipeInstructions

Text

I passaggi per preparare il piatto. Questa proprietà è consigliata per le ricette su Ricerca Google, ma è richiesta per le indicazioni dell'Assistente Google su Google Home e smart display.

Esistono diverse opzioni per impostare il valore di recipeInstructions. Ti consigliamo di utilizzare HowToStep o HowToSection:

  • HowToStep: puoi specificare il testo esatto per ogni passaggio, impostando il valore di ogni HowToStep. Questa fornisce suggerimenti all'Assistente Google, ma tieni presente che può raggruppare i passaggi della ricetta in modo diverso in base al contesto.
  • HowToSection (solo se una ricetta ha più sezioni): utilizzala per raggruppare i passaggi in più sezioni. Fornisci il nome della sezione nel relativo campo del nome (ad esempio, "Preparare la base") e specifica ogni HowToStep come itemListElement. Imposta il campo di testo di ogni HowToStep.

    Ad esempio, una ricetta per la pizza può avere una sezione di passaggi per la preparazione della base, una per la preparazione dei condimenti e una per la disposizione e la cottura. Se non indichi più sezioni, l'Assistente Google potrebbe erroneamente presentare il nome della sezione come un altro passaggio (ad esempio, un passaggio denominato "Preparare la base" seguito da un passaggio "Mescola il lievito alla farina").

  • Campo di testo singolo o ripetuto: un blocco di testo che include uno o più passaggi. Google considera tutti i passaggi come una singola sezione. I valori dei campi ripetuti sono concatenati in un singolo blocco di testo. Google quindi tenta di suddividere automaticamente il singolo blocco di testo in singoli passaggi. Google cerca di trovare e rimuovere nomi di sezioni, numeri di passaggio, parole chiave e qualsiasi altra cosa che possa apparire in modo non corretto nel testo del passaggio della ricetta. Per un risultato migliore, ti consigliamo di specificare in modo univoco le singole frasi dei passaggi con HowToStep, come descritto sopra.

Linee guida aggiuntive

  • Non includere metadati che appartengono ad altri posti. In particolare, utilizza il campo author per specificare l'autore, recipeCuisine per la cucina, recipeCategory per la categoria e keywords per le altre parole chiave.
  • Includi solo testo su come eseguire la ricetta e non includere altro testo, ad esempio "Indicazioni", "Guarda il video", "Passaggio 1". Queste frasi devono essere specificate al di fuori dei dati strutturati.

    Non consigliato

    "recipeInstructions": [{
      "@type": "HowToStep",
      "text": "Step 1. Heat oven to 425°F."
    }]

    Consigliato

    "recipeInstructions": [{
      "@type": "HowToStep",
      "text": "Heat oven to 425°F."
    }]
recipeYield

Text

La quantità prodotta con la ricetta. Ad esempio: il numero di persone servite o il numero di porzioni.

review

Review

Una recensione del piatto. Segui le linee guida sugli snippet recensione e l'elenco di proprietà della recensione obbligatorie e consigliate.

totalTime

Duration

Il tempo totale necessario per preparare il piatto, in formato ISO 8601. Puoi usare min e max come elementi secondari per specificare un intervallo di tempo.

Usa totalTime o una combinazione di cookTime e prepTime.

video

VideoObject

Un array di proprietà video che descrivono la ricetta sulla pagina. Consulta l'elenco delle proprietà video obbligatorie e consigliate.

Ad esempio:

{
  "@context": "https://schema.org/",
  "@type": "Recipe",
  "video": [
    {
      "name": "Party Coffee Cake",
      "description": "How to make Party Coffee Cake.",
      "thumbnailUrl": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
      ],
      "contentUrl": "http://www.example.com/videos/123_600x400.mp4",
      "embedUrl": "http://www.example.com/videoplayer?id=123",
      "uploadDate": "2018-02-05T08:00:00+08:00"
    }
  ]
}

Invia feedback per...