Uporządkowane dane karuzeli filmów (Movie)

Ilustracja pokazująca, jak wynik z elementami rozszerzonymi dotyczący filmu może wyglądać w wyszukiwarce Google. Pokazuje 3 różne filmy z tej samej witryny w formacie karuzeli, które użytkownicy mogą przeglądać i wybierać

Oznacz listy filmów uporządkowanymi danymi, by użytkownicy mogli odkrywać filmy w wyszukiwarce Google na nowe sposoby. Możesz w ten sposób podać informacje o filmach, np. tytuł, imię i nazwisko reżysera oraz plakat. Karuzela z filmami pokazuje się tylko na urządzeniach mobilnych.

How to add structured data

Structured data is a standardized format for providing information about a page and classifying the page content. If you're new to structured data, you can learn more about how structured data works.

Here's an overview of how to build, test, and release structured data.

  1. Add the required properties. Based on the format you're using, learn where to insert structured data on the page.
  2. Follow the guidelines.
  3. Validate your code using the Rich Results Test and fix any critical errors. Consider also fixing any non-critical issues that may be flagged in the tool, as they can help improve the quality of your structured data (however, this isn't necessary to be eligible for rich results).
  4. Deploy a few pages that include your structured data and use the URL Inspection tool to test how Google sees the page. Be sure that your page is accessible to Google and not blocked by a robots.txt file, the noindex tag, or login requirements. If the page looks okay, you can ask Google to recrawl your URLs.
  5. To keep Google informed of future changes, we recommend that you submit a sitemap. You can automate this with the Search Console Sitemap API.

Przykłady

Strona podsumowania + wiele stron z pełnymi informacjami

Strona podsumowania zawiera krótki opis poszczególnych elementów listy. Każdy opis kieruje na osobną stronę ze szczegółowymi informacjami poświęconą wyłącznie jednemu elementowi. Oto przykład listy z filmami i podsumowaniami w postaci kodu 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>

Lista zawierająca wszystkie informacje na jednej stronie

Na jednej stronie zawarte są wszystkie informacje dotyczące listy, m.in. pełny opis poszczególnych elementów. Oto przykład listy z filmami zawierającej wszystkie informacje na jednej stronie w postaci kodu 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>

Wytyczne

Aby filmy pojawiały się w karuzeli, zastosuj się do tych wskazówek.

Definicje typów uporządkowanych danych

Aby treści mogły się wyświetlać w wynikach z elementami rozszerzonymi, musisz w nich stosować właściwości wymagane. Możesz też dodawać do nich właściwości zalecane, by wzbogacać informacje o treściach i zwiększać w ten sposób komfort użytkowników.

Movie

Oprócz standardowych właściwości karuzeli określ w obiekcie karuzeli również te opisane poniżej.

Pełną definicję typu Movie znajdziesz na schema.org/Movie.

Właściwości obsługiwane przez Google:

Właściwości wymagane
image URL lub ImageObject

Obraz, który reprezentuje film. Dodatkowe wytyczne dotyczące obrazów:

  • Adresy URL obrazów muszą być dostępne do pobrania i zindeksowania.
  • Obrazy muszą symbolizować treści objęte znacznikami.
  • Obrazy muszą być w formacie JPG, PNG lub GIF.
  • Obrazy muszą być w wysokiej rozdzielczości i mieć proporcje 6:9. Google może przycinać obrazy, które mają zbliżone proporcje, ale te, które znacznie od nich odbiegają, nie mogą być używane przez tę funkcję.
name Text

Nazwa filmu.
Właściwości zalecane

aggregateRating

AggregateRating

Adnotacja ze średnią oceną filmu. Przestrzegaj wytycznych dotyczących fragmentów opinii i zapoznaj się z listą wymaganych i zalecanych właściwości AggregateRating.
dateCreated Date lub DateTime

Data premiery filmu.
director Person

Reżyser filmu. Przykład:

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

review

Review

Zagnieżdżony element Review filmu. Przestrzegaj wytycznych dotyczących fragmentów opinii i zapoznaj się z listą wymaganych i zalecanych właściwości Review.

Rozwiązywanie problemów

Jeśli masz problem z zastosowaniem lub debugowaniem uporządkowanych danych, skorzystaj z tych rozwiązań: