Carruseles

Puedes usar datos estructurados para hacer que tus resultados enriquecidos puedan mostrarse en un formato tipo lista llamado carrusel. Los carruseles suelen aparecer solo en dispositivos móviles, y solo para ciertos tipos de contenido, como se describe a continuación. Si usas el lenguaje de marcado de carrusel para un tipo de contenido que actualmente no admite ese formato, no es un error. La información se puede mostrar de todas formas, pero no en un carrusel.

En algunos casos, es posible que la Búsqueda de Google muestre tu resultado enriquecido dentro de un carrusel aunque la página no incluya datos estructurados para una lista; por ejemplo, una receta puede aparecer en un carrusel de recetas con resultados que provienen de una gran variedad de sitios web.

Ejemplo

Esta es una lista de recetas con pollo de un único sitio web que se muestra en un carrusel:

Carrusel de resultados enriquecidos de recetas

Lineamientos

Además de los lineamientos estándares para datos estructurados, los siguientes lineamientos se aplican a todo el lenguaje de marcado de listas:

  • Todos los elementos de la lista deben ser del mismo tipo; por ejemplo, Article o Recipe.
  • El texto visible para el usuario debe ser similar a la información que contienen los datos estructurados en la página.
  • Los elementos que aparecen en formato de lista se muestran en el orden que especifica la propiedad position.
  • El formato de lista actualmente es compatible con los siguientes tipos de contenido: receta, curso y artículo.

Existen dos maneras de implementar un formato de lista para tus datos estructurados:

  • Página de resumen + múltiples páginas con detalles completos
  • Una lista única con todo el contenido en una página

Página de resumen + múltiples páginas con detalles completos

La página de resumen tiene una breve descripción de cada elemento de la lista, y cada descripción dirige a una página de detalles independiente que se centra completamente en un elemento.

Página de resumen Página de detalles
Define un elemento ItemList, donde cada ListItem tiene solo tres propiedades: @type (establecida en "ListItem"), position (la posición en la lista) y url (la URL de una página con todos los detalles sobre ese elemento). Define un elemento de datos estructurados apropiado para ese 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 ...

Código de muestra:

Código de muestra:

Lista única con todo el contenido en una página

En una lista única con todo el contenido en una página se aloja toda la información de la lista, incluido el texto completo de cada elemento; por ejemplo, una galería de recetas para varios tipos de muffins, todas en una sola página.

Página única
Define un elemento ItemList, donde cada elemento es un ListItem con la propiedad item propagada con los datos estructurados para ese tipo de elemento de schema.org (por ejemplo, película o curso). La página debe contener texto visible para el usuario y un anclaje que coincida con 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 ...
  ]
Código de muestra:

Definiciones de tipos de datos estructurados

Para especificar una lista, debes definir un elemento ItemList que contenga al menos dos ListItems. Debes incluir las propiedades obligatorias a fin de que tu contenido sea apto para aparecer como resultado enriquecido. También puedes incluir las propiedades recomendadas para agregar más información sobre tu contenido, lo que podría brindar una mejor experiencia para el usuario.

ItemList

ItemList es el elemento contenedor que incluye todos los elementos de la lista. Si se usa en una página de resumen, todas las URL de la lista deben dirigir a diferentes páginas del mismo dominio. Si se usa en una lista con todo el contenido en una página, todas las URL deben dirigir a la página en la que se alojan los datos estructurados de la lista.

La definición completa de ItemList está disponible en schema.org/ItemList.

Propiedades obligatorias
itemListElement

ListItem

Lista de elementos. Todos deben ser del mismo tipo. Consulta ListItem para obtener más información.

ListItem

ListItem contiene detalles sobre un elemento individual de la lista.

  • Si se trata de una página de resumen, ListItem solo debe incluir las propiedades type, position y url.
  • Si se trata de una lista con todo el contenido en una página, ListItem debe incluir todas las propiedades adicionales de schema.org para el tipo de dato que describe (por ejemplo, objetos Recipe o Course).

La definición completa de ListItem está disponible en schema.org/ListItem.

Ejemplo de elemento en la lista de resumen simple (JSON-LD):

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

Ejemplo de elemento en la lista con todo el contenido en una 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 ...
  }
}
Propiedades obligatorias
item

Objeto

Se usa solo para listas con todo el contenido en una página. Esta propiedad es obligatoria para este tipo de lista. No se debe incluir para las páginas de resumen. Completa este objeto con los siguientes valores; además, agrega todos los miembros del tipo de dato estructurado específico que se describe:

  • item.name
  • item.url
  • Cualquier otra propiedad requerida para este tipo de datos, como se describe en schema.org y las reglas que se detallan en estos documentos para tu tipo de contenido (como artículo o libro). Por ejemplo, para un libro en una lista, debes agregar las propiedades bookFormat y isbn; para una receta, debes agregar prepTime y image.
item.name

Texto

Nombre de string del elemento, que se muestra en la galería procesada. El formato HTML se ignora. Esta propiedad es obligatoria para listas con todo el contenido en una página. No se debe incluir para las páginas de resumen.

item.url

URL

URL completa más el anclaje a este elemento en la página. Esta propiedad es obligatoria para listas con todo el contenido en una página. No se debe incluir para las páginas de resumen. La URL debe ser la página actual, y debes incluir un anclaje HTML (una etiqueta <a> o un valor name o id) en la página cerca del texto visible para el usuario. Ejemplo: https://example.org/recipes/pies#apple_pie.

position

Integer

Posición del elemento en el carrusel. Es un número basado en 1.

url

URL

Se usa solo para listas de páginas de resumen. Esta propiedad es obligatoria para páginas de resumen. No se debe incluir para las listas con todo el contenido en una página. La URL canónica de la página de detalles del elemento. Todas las URL de la lista deben ser únicas, pero estar activas en el mismo dominio (el mismo dominio o un dominio superior o inferior a la página actual).

Enviar comentarios sobre...