Caroselli

Puoi utilizzare i dati strutturati per rendere i risultati multimediali idonei per una visualizzazione tipo elenco, chiamata carosello. In genere i caroselli vengono visualizzati solo sui dispositivi mobili e solo per determinati tipi di contenuti, come descritto di seguito. Utilizzare il markup carosello per un tipo di contenuto non attualmente supportato nel formato carosello non è un errore: l'informazione può ancora essere visualizzata, ma non in formato carosello.

In alcuni casi, la Ricerca Google può visualizzare i risultati multimediali all'interno di un carosello anche se la pagina non include i dati strutturati per un elenco: ad esempio, una ricetta potrebbe essere visualizzata in un carosello di risultati di diversi siti web.

Esempio

Ecco un elenco di ricette per cucinare il pollo tratte da un singolo sito web mostrate in un carosello:

Carosello di risultati multimediali di ricette

Linee guida

Oltre alle linee guida standard per i dati strutturati, le seguenti linee guida si applicano al markup di tutti gli elenchi:

  • Tutti gli elementi nell'elenco devono essere dello stesso tipo, ad esempio: Article o Recipe.
  • Il testo visibile all'utente deve essere simile alle informazioni contenute nei dati strutturati sulla pagina.
  • Gli elementi mostrati in formato elenco verranno mostrati nell'ordine specificato dalla proprietà position.
  • Il formato elenco è attualmente supportato per i seguenti tipi di contenuti: Recipe, Course, Article, Restaurant.

Esistono due modi per implementare un formato elenco per i dati strutturati:

  • Pagina di riepilogo + diverse pagine dei dettagli completi
  • Un'unica pagina elenco

Pagina di riepilogo + diverse pagine dei dettagli completi

La pagina di riepilogo contiene una breve descrizione di ciascun elemento dell'elenco e ogni descrizione punta a una pagina di dettagli separata, focalizzata interamente su un elemento.

Pagina di riepilogo Pagina dei dettagli
Definisce un ItemList, dove ogni ListItem ha solo tre proprietà: @type (impostato su "ListItem"), position (la posizione in elenco) e url (l'URL di una pagina con i dettagli completi dell'elemento). Definisce un elemento di dati strutturati appropriato per quel tipo di elenco.
Pseudocodice per best_dessert_recipes.html:

ItemList
  itemListElement: [
    {
      @type: ListItem
      position: 1
      url: http://example.com/coffee_cake.html
    },
    {
      @type: ListItem
      position:2
      url: http://example.com/apple_pie.html,
    },
    ... more recipes ...
  ]
Pseudocodice per coffee_cake.html:

@type: Recipe
name: Party Coffee Cake
author: George Smith
.... more properties ...

Codice di esempio:

Codice di esempio:

Un'unica pagina elenco

Un'unica pagina elenco ospita tutte le informazioni dell'elenco, incluso il testo completo di ciascun elemento: ad esempio, una galleria di ricette per vari tipi di muffin, contenute tutte in un'unica pagina.

Pagina singola
Consente di definire un valore ItemList, in cui ogni elemento è un valore ListItem la cui proprietà item è compilata con i dati strutturati del tipo di elemento schema.org specifico (ad esempio, Movie o Course). La pagina deve contenere testo visibile dall'utente e un ancoraggio per abbinare ogni elemento ListItem.

Pseudocodice per best_dessert_recipes.html:


ItemList
  itemListElement: [
    {
      @type: ListItem
      position: 1
      item: {
        @type: Recipe
        url: http://example.com/big_list_of_recipes#recipe_1
        name: George's Cherry Pie
        author: George Smith
        ... all other required Recipe type properties ...}
    },
    {
      @type: ListItem
      position: 2
      item: {
        @type: Recipe
        url: http://example.com/big_list_of_recipes#recipe_2
        name: Party Coffee Cake
        author: Mary Stone
        ... all other required Recipe type properties ...}
    },
    ... more recipes ...
  ]
Codice di esempio:

Definizioni dei tipi di dati strutturati

Per specificare un elenco, è necessario definire un ItemList contenente almeno due ListItems. Affinché i tuoi contenuti siano idonei per essere visualizzati come risultato multimediale, 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

ItemList è l'elemento contenitore che contiene tutti gli elementi nell'elenco. Se utilizzato in una pagina di riepilogo, tutti gli URL nell'elenco devono puntare a pagine diverse dello stesso dominio. Se utilizzato in un'unica pagina elenco, tutti gli URL devono puntare alla pagina che ospita i dati strutturati dell'elenco.

La definizione completa di ItemList è disponibile all'indirizzo schema.org/ItemList.

Proprietà obbligatorie
itemListElement

ListItem

Elenco di elementi. Tutti gli elementi devono essere dello stesso tipo. Vedi ListItem per i dettagli.

ListItem

ListItem contiene dettagli su un singolo elemento nell'elenco.

  • Se si tratta di una pagina di riepilogo, ListItem dovrebbe includere solo le proprietà type, position e url.
  • Se si tratta di un'unica pagina elenco, ListItem dovrebbe includere tutte le proprietà schema.org aggiuntive per il tipo di dati che descrive (ad esempio, oggetti Recipe o Course).

La definizione completa di ListItem è disponibile all'indirizzo schema.org/ListItem.

Esempio di articolo in un semplice elenco di riepilogo (JSON-LD):

{
  "@type":"ListItem",
  "position":1,
  "url":"http://example.com/desserts/apple-pie"
}

Elemento di esempio in un'unica pagina elenco (JSON-LD):

{
  "@type": "ListItem",
  "position": 1,
  "item": {
    "@type": "Recipe",
    "url": "http://example.com/desserts/pies/#apple-pie",
    "name": "Apple Pie",
    "image": "https://example.com/300px-Apple_pie.jpg",
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": "6",
      "reviewCount": "32"
    },
    "recipeYield": "8 servings",
    "recipeIngredient": [
      "Pastry crust for bottom and top",
      "1/2 cup unsalted butter",
      "3 tablespoons all-purpose flour",
      "1/4 cup water",
      "1/4 cup white sugar",
      "1/2 cup brown sugar",
      "10 cups peeled, chopped green apples"
    ], ... snip ...
  }
}
Proprietà obbligatorie
item

Thing

Utilizzata solamente per le pagine elenco uniche. Questa proprietà è obbligatoria per le pagine elenco uniche. Non includerla nelle pagine di riepilogo. Compila questo oggetto con i seguenti valori, oltre a tutti i componenti del tipo specifico di dati strutturati da descrivere:

  • item.name
  • item.url
  • Qualsiasi altra proprietà obbligatoria per questo tipo di dati, come descritto in schema.org, e le regole descritte in questi documenti per il tipo di contenuti (ad esempio Article o Book). Ad esempio, per un libro in un elenco, dovresti fornire le proprietà bookFormat e isbn; per una ricetta, le proprietà prepTime e image.
item.name

Text

Nome della stringa dell'elemento, mostrato nella galleria visualizzata. La formattazione HTML viene ignorata. Questa proprietà è obbligatoria per le pagine elenco uniche. Non includerla nelle pagine di riepilogo.

item.url

URL

URL valido + ancoraggio pagina a questo elemento nella pagina. Questa proprietà è obbligatoria per le pagine elenco uniche. Non includerla nelle pagine di riepilogo. L'URL deve essere la pagina corrente e devi includere un ancoraggio HTML (tag <a> o name o valore id) nella tua pagina accanto al testo visibile dall'utente. Esempio: https://example.org/recipes/pies#apple_pie.

position

Integer

La posizione dell'elemento nel carosello. È un numero in base uno.

url

URL

Utilizzata solamente per le pagine di riepilogo. Questa proprietà è obbligatoria per le pagine di riepilogo. Non includerla per le pagine elenco. L'URL canonico della pagina dei dettagli elemento. Tutti gli URL nell'elenco devono essere univoci, ma attivi nello stesso dominio (lo stesso dominio, dominio secondario o superdominio della pagina corrente).

Invia feedback per...