Dati strutturati per carosello di film (Movie)

Illustrazione di come un risultato avanzato di film può apparire nella Ricerca Google. Mostra 3 film dello stesso sito web in un formato carosello che gli utenti possono esplorare e selezionare un film specifico

Esegui il markup dei tuoi elenchi di film con i dati strutturati per consentire agli utenti di esplorare i film nella Ricerca Google in nuovi modi. Puoi fornire informazioni dettagliate sui film, ad esempio il titolo, il regista e un'immagine del film. Il carosello di film è disponibile soltanto sui dispositivi mobili.

Come aggiungere dati strutturati

I dati strutturati sono un formato standardizzato per fornire informazioni su una pagina e classificarne i contenuti. Se non li hai mai utilizzati, scopri di più su come funzionano i dati strutturati.

Ecco una panoramica su come creare, testare e rilasciare i dati strutturati. Per una guida passo per passo su come aggiungere dati strutturati a una pagina web, consulta il codelab sui dati strutturati.

  1. Aggiungi le proprietà obbligatorie. In base al formato che utilizzi, scopri dove inserire i dati strutturati nella pagina.
  2. Segui le linee guida.
  3. Convalida il codice utilizzando lo strumento di Test dei risultati avanzati e correggi eventuali errori critici. Prendi in considerazione anche la possibilità di correggere eventuali problemi non critici che potrebbero essere segnalati nello strumento, in quanto possono contribuire a migliorare la qualità dei tuoi dati strutturati (tuttavia, questo non è necessario per l'idoneità per i risultati avanzati).
  4. Implementa alcune pagine che includono dati strutturati e utilizza lo strumento Controllo URL per verificare come Google vede la pagina. Assicurati che la pagina sia accessibile per Google e che non venga bloccata da file robots.txt, tag noindex o requisiti di accesso. Se la pagina non presenta problemi, puoi chiedere a Google di ripetere la scansione degli URL.
  5. Per tenere Google informata delle future modifiche, ti consigliamo di inviare una Sitemap. Puoi automatizzare questa operazione con l'API Search Console Sitemap.

Esempi

Pagina di riepilogo + diverse pagine dei dettagli completi

La pagina di riepilogo contiene una breve descrizione di ogni elemento dell'elenco e ogni descrizione rimanda a una pagina dei dettagli separata dedicata interamente a un elemento. Ecco un esempio di elenco di riepilogo di film in formato JSON-LD:

<html>
  <head>
    <title>The Best Movies from the Oscars - 2024</title>
    <script type="application/ld+json">
    {
      "@context":"https://schema.org",
      "@type":"ItemList",
      "itemListElement":[
        {
          "@type":"ListItem",
          "position":1,
          "url":"https://example.com/a-star-is-born.html"
        },
        {
          "@type":"ListItem",
          "position":2,
          "url":"https://example.com/bohemian-rhapsody.html"
        },
        {
          "@type":"ListItem",
          "position":3,
          "url":"https://example.com/black-panther.html"
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Un'unica pagina elenco

Un'unica pagina elenco ospita tutte le informazioni dell'elenco, incluso il testo completo di ogni elemento. Ecco un esempio di unico elenco di film in formato JSON-LD:

<html>
  <head>
    <title>The Best Movies from the Oscars - 2024</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "ItemList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "item": {
            "@type": "Movie",
            "url": "https://example.com/2024-best-picture-noms#a-star-is-born",
            "name": "A Star Is Born",
            "image": "https://example.com/photos/6x9/photo.jpg",
            "dateCreated": "2024-10-05",
            "director": {
                "@type": "Person",
                "name": "Bradley Cooper"
              },
            "review": {
              "@type": "Review",
              "reviewRating": {
                "@type": "Rating",
                "ratingValue": 5
              },
              "author": {
                "@type": "Person",
                "name": "John D."
              }
            },
              "aggregateRating": {
                "@type": "AggregateRating",
                "ratingValue": 90,
                "bestRating": 100,
                "ratingCount": 19141
              }
            }
          },
        {
          "@type": "ListItem",
          "position": 2,
          "item": {
            "@type": "Movie",
            "name": "Bohemian Rhapsody",
            "url": "https://example.com/2024-best-picture-noms#bohemian-rhapsody",
            "image": "https://example.com/photos/6x9/photo.jpg",
            "dateCreated": "2024-11-02",
            "director": {
                "@type": "Person",
                "name": "Bryan Singer"
              },
            "review": {
              "@type": "Review",
              "reviewRating": {
                "@type": "Rating",
                "ratingValue": 3
              },
              "author": {
                "@type": "Person",
                "name": "Vin S."
              }
            },
              "aggregateRating": {
                "@type": "AggregateRating",
                "ratingValue": 61,
                "bestRating": 100,
                "ratingCount": 21985
              }
            }
          },
        {
          "@type": "ListItem",
          "position": 3,
          "item": {
            "@type": "Movie",
            "name": "Black Panther",
            "url": "https://example.com/2024-best-picture-noms#black-panther",
            "image": "https://example.com/photos/6x9/photo.jpg",
            "dateCreated": "2024-02-16",
            "director": {
                "@type": "Person",
                "name": "Ryan Coogler"
              },
            "review": {
              "@type": "Review",
              "reviewRating": {
                "@type": "Rating",
                "ratingValue": 2
              },
              "author": {
                "@type": "Person",
                "name": "Trevor R."
              }
            },
              "aggregateRating": {
                "@type": "AggregateRating",
                "ratingValue": 96,
                "bestRating": 100,
                "ratingCount": 88211
              }
            }
          }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Linee guida

Devi seguire queste linee guida affinché i tuoi contenuti siano idonei per la visualizzazione in un carosello di film.

Definizioni dei tipi di dati strutturati

Affinché i tuoi contenuti siano idonei per essere visualizzati come risultato avanzato, devi includere le proprietà obbligatorie. Puoi anche includere le proprietà consigliate per aggiungere maggiori informazioni sui tuoi contenuti, fornendo così un'esperienza utente migliore.

Movie

Oltre alle proprietà Carosello standard, definisci le seguenti proprietà nell'oggetto Carosello.

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

Le proprietà supportate da Google sono le seguenti:

Proprietà obbligatorie
image URL o ImageObject

Un'immagine che rappresenta il film. Ulteriori linee guida per le immagini:

  • Gli URL delle immagini devono poter essere sottoposti a scansione e indicizzazione.
  • Le immagini devono rappresentare i contenuti di cui è stato effettuato il markup.
  • Le immagini devono essere in formato .jpg, .png o .gif.
  • Le immagini devono essere ad alta risoluzione e avere proporzioni pari a 6:9. Google può ritagliare le immagini con proporzioni molto simili a 6:9, ma le immagini con proporzioni molto diverse da quelle richieste non sono idonee per la funzionalità.
name Text

Il titolo del film.

Proprietà consigliate

aggregateRating

AggregateRating

Annotazione relativa al punteggio medio delle recensioni del film. Segui le linee guida sugli snippet recensione e l'elenco di proprietà AggregateRating obbligatorie e consigliate.

dateCreated Date o DateTime

La data di uscita del film.

director Person

Il regista del film. Ad esempio:

"director": {
  "@type": "Person",
  "name": "Bradley Cooper"
}

review

Review

Un elemento Review nidificato del film. Segui le linee guida sugli snippet recensione e l'elenco di proprietà Recensione obbligatorie e consigliate.

Risoluzione dei problemi

Se hai difficoltà con l'implementazione o il debug dei dati strutturati, ecco alcune risorse che potrebbero esserti utili.