Carrosséis

Você pode usar dados estruturados para que sua pesquisa aprimorada seja qualificada para uma exibição semelhante a uma lista chamada de carrossel. Os carrosséis geralmente são exibidos apenas em dispositivos móveis e para determinados tipos de conteúdo, conforme descrito abaixo. Se você usar marcação de carrossel para um tipo de conteúdo não compatível com esse formato, isso não será um erro. As informações ainda poderão ser exibidas, mas não em um carrossel.

Em alguns casos, a Pesquisa Google pode exibir a pesquisa aprimorada dentro de um carrossel, mesmo que a página não inclua dados estruturados para uma lista: por exemplo, uma receita pode aparecer em um carrossel de resultados de vários sites diferentes.

Exemplo

Veja uma lista de receitas com frango de um único site mostrada em um carrossel:

Carrossel da pesquisa aprimorada de receitas

Diretrizes

Além das diretrizes padrão de dados estruturados, as seguintes diretrizes se aplicam a todas as marcações de lista:

  • Todos os itens da lista devem ser do mesmo tipo, por exemplo: Article ou Recipe.
  • O texto visível para o usuário precisa ser semelhante às informações contidas nos dados estruturados da página.
  • Os itens mostrados em formato de lista aparecerão na ordem especificada pela propriedade position.
  • No momento, o formato de lista é compatível com os seguintes tipos de conteúdo: receita, curso, artigo e restaurante.

Existem duas maneiras de implementar um formato de lista para os dados estruturados:

  • Página de resumo + várias páginas de detalhes completos
  • Uma lista em uma única página

Página de resumo + 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 aponta para uma página de detalhes separada, inteiramente focada em um item.

Página de resumo Página de detalhes
Define um ItemList, em que cada ListItem tem apenas três propriedades: @type (definida como "ListItem"), position (a posição na lista) e url (o URL de uma página com detalhes completos sobre esse item). Define um elemento de dados estruturados apropriado para esse tipo de lista.
Pseudocódigo para 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 ...
  ]
Pseudocódigo para coffee_cake.html:

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

Exemplo de código:

Exemplo de código:

Lista em uma única página

Uma lista em uma única página hospeda todas as informações da lista, incluindo o texto completo de cada item: por exemplo, uma galeria de receitas para vários tipos de muffin, tudo em uma só página.

Uma só página
Define um ItemList, em que cada elemento é um ListItem com a propriedade item preenchida com os dados estruturados desse tipo de elemento do schema.org (por exemplo, filme ou curso). A página precisa conter texto visível para o usuário e uma âncora para corresponder a cada elemento ListItem.

Pseudocódigo para 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 ...
  ]
Exemplo de código:

Definições de tipos de dados estruturados

Para especificar uma lista, você precisa definir um ItemList que contenha pelo menos dois ListItems. É necessário incluir as propriedades obrigatórias para que seu conteúdo seja qualificado para exibição como uma pesquisa aprimorada. Você também pode incluir as propriedades recomendadas para acrescentar mais informações sobre o conteúdo, o que pode proporcionar uma melhor experiência do usuário.

ItemList

ItemList é o item de contêiner que contém todos os elementos da lista. Se usado em uma página de resumo, todos os URLs na lista precisarão apontar para páginas diferentes no mesmo domínio. Se usado em uma lista em uma única página, todos os URLs precisarão apontar para a página que hospeda os dados estruturados da lista.

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

Propriedades obrigatórias
itemListElement

ListItem

É uma lista de itens. Todos os itens precisam ser do mesmo tipo. Confira ListItem para ver detalhes.

ListItem

ListItem contém detalhes sobre um item individual na lista.

  • No caso de uma página de resumo, o ListItem precisa incluir somente as propriedades type, position e url.
  • No caso de uma lista em uma única página, o ListItem precisa incluir todas as demais propriedades de schema.org referentes ao tipo de dados que ele descreve (por exemplo, objetos Recipe ou Course).

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

Exemplo de item na lista de resumo simples (JSON-LD):

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

Exemplo de item na lista em uma única página (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 ...
  }
}
Propriedades obrigatórias
item

Thing

É usada apenas para listas em uma única página. Essa propriedade é obrigatória para listas em uma única página. Não incluir nas páginas de resumo. Preencha esse objeto com os seguintes valores, além de todos os membros do tipo específico de dado estruturado que está sendo descrito:

  • item.name
  • item.url
  • Qualquer outra propriedade necessária para esse tipo de dado, conforme descrito no schema.org, e as regras definidas nesses documentos para o tipo de conteúdo (por exemplo, artigo ou livro) Como exemplo, para um livro em uma lista, você forneceria propriedades bookFormat e isbn. Para uma receita, você forneceria propriedades prepTime e image.
item.name

Text

É o nome de string do item, exibido na galeria renderizada. A formatação HTML é ignorada. Essa propriedade é obrigatória para listas em uma única página. Não incluir nas páginas de resumo.

item.url

URL

É o URL totalmente qualificado + âncora de página para esse item na página. Essa propriedade é obrigatória para listas em uma única página. Não incluir nas páginas de resumo. O URL precisa ser a página atual, e você precisa incluir uma âncora HTML (tag <a> ou valor name ou id) na sua página, perto do texto visível para o usuário. Exemplo: https://example.org/recipes/pies#apple_pie.

position

Integer

É a posição do item no carrossel. Trata-se de um número baseado em 1.

url

URL

É usada apenas para listas de páginas de resumo. Essa propriedade é obrigatória para páginas de resumo. Não incluir nas listas em uma única página. É o URL canônico da página de detalhes do item. Todos os URLs da lista precisam ser exclusivos, mas têm que estar no mesmo domínio (o mesmo domínio ou sub/superdomínio da página atual).

Enviar comentários sobre…