Dados estruturados de carrossel de filmes (Movie)

Ilustração de como uma pesquisa aprimorada de filme pode aparecer na Pesquisa Google. Ela mostra três filmes diferentes do mesmo site em um formato de carrossel que os usuários podem explorar e selecionar um filme específico.

Marque suas listas de filmes com dados estruturados para que os usuários encontrem novas maneiras de navegar pelas obras na Pesquisa Google. Você pode fornecer detalhes como o título, o diretor e uma imagem do filme. O carrossel de filmes está disponível apenas em dispositivos móveis.

Como adicionar dados estruturados

Os dados estruturados são um formato padronizado para fornecer informações sobre uma página e classificar o conteúdo dela. Caso você não saiba muito sobre o assunto, veja como os dados estruturados funcionam.

Esta é uma visão geral de como criar, testar e lançar dados estruturados.

  1. Adicione as propriedades obrigatórias. Com base no formato que você está usando, saiba onde inserir dados estruturados na página.
  2. Siga as diretrizes.
  3. Valide o código com o Teste de pesquisa aprimorada e corrija os erros críticos. Corrija também os problemas não críticos que possam ser sinalizados na ferramenta, porque eles podem melhorar a qualidade dos dados estruturados, mas isso não é necessário para se qualificar para pesquisas aprimoradas.
  4. Implante algumas páginas que incluam os dados estruturados e use a Ferramenta de inspeção de URL para testar como o Google vê a página. Verifique se a página está acessível ao Google e se não está bloqueada por um arquivo robots.txt, pela tag noindex ou por requisitos de login. Se estiver tudo certo, peça ao Google para rastrear novamente seus URLs.
  5. Para informar o Google sobre mudanças futuras, recomendamos que você envie um sitemap. É possível automatizar isso com a API Search Console Sitemap.

Exemplos

Página de resumo e várias páginas de detalhes completos

A página de resumo tem uma breve descrição de cada item da lista, e cada descrição leva a uma página de detalhes independente voltada a um item específico. Veja um exemplo da lista resumida de filmes em 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 em uma única página

Uma lista em uma única página exibe todas as informações, incluindo o texto completo de cada item. Veja um exemplo de uma dessas listas em 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>

Diretrizes

Siga estas diretrizes e qualifique seu conteúdo para exibição em um carrossel de filmes.

Definições de tipos de dados estruturados

É necessário incluir as propriedades obrigatórias para que seu conteúdo seja qualificado para exibição como uma pesquisa aprimorada. Também é possível incluir as propriedades recomendadas para dar mais informações sobre o conteúdo, o que pode melhorar a experiência do usuário.

Movie

Além das propriedades do carrossel, defina estas informações no objeto.

A definição completa de Movie está disponível em schema.org/Movie (em inglês).

Veja as propriedades aceitas pelo Google:

Propriedades obrigatórias
image URL ou ImageObject

É uma imagem que representa o filme. Veja outras diretrizes relacionadas:

  • Os URLs das imagens precisam ser rastreáveis e indexáveis.
  • As imagens precisam representar o conteúdo marcado.
  • Elas precisam estar em formato .jpg, .png ou .gif.
  • As imagens precisam ser de alta resolução e ter uma proporção de 6:9. O Google pode cortar imagens com proporção próxima a 6:9, mas aquelas com proporção muito diferente não se qualificam para o recurso.
name Text

É o título do filme.

Propriedades recomendadas

aggregateRating

AggregateRating

É a anotação da avaliação média atribuída ao filme. Siga as diretrizes de snippet de avaliação e a lista de propriedades AggregateRating obrigatórias e recomendadas.

dateCreated Date ou DateTime

É a data de lançamento do filme.

director Person

É quem dirigiu o filme. Exemplo:

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

review

Review

É uma avaliação (Review) aninhada do filme. Siga as diretrizes de snippet de avaliação e a lista de propriedades de avaliação obrigatórias e recomendadas.

Solução de problemas

Se você tiver problemas para implementar ou depurar dados estruturados, veja alguns recursos que podem ajudar.