Carruseles

Puedes usar datos estructurados para hacer que tus resultados enriquecidos (antes llamados "tarjetas enriquecidas") 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ándar 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, artículo o receta.
  • 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.
  • Por el momento, el formato de lista es compatible con los siguientes tipos de contenido. Este número está creciendo, por lo que puedes crear una lista para otros tipos a medida que estén disponibles: receta, película, 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 los detalles completos
  • Una lista única con todo el contenido en una página

Página de resumen + múltiples páginas con los 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_pie_recipes.html:
ItemList
  itemListElement: [
    {
      @type: ListItem
      position: 1
      url: http://example.com/cherry_pie_recipe.html
    },
    {
      @type: ListItem
      position:2
      url: http://example.com/appple_pie_recipe.html,
    },
    ... more recipes ...
  ]
Pseudocódigo para cherry_pie_recipe.html:
@type: Recipe
name: George's Cherry Pie
author: George Smith
.... more properties ...

Código de muestra:

Código de muestra:

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

Una lista única con todo el contenido en una página contiene 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_pie_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: Martha's Apple Pie
        author: Martha Smith
        ... 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.

ItemList

ItemList es el elemento contenedor que incluye todos los elementos en 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 que aloja los datos estructurados de la lista.

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

Propiedades
@type

Obligatoria

Debe ser "ItemList".

itemListElement

ListItem (obligatoria)

Lista de elementos. Todos los elementos deben ser del mismo tipo. Consulta ListItem a continuación para obtener más detalles.

ListItem

ListItem contiene detalles sobre un elemento individual en la lista.

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

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

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 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"
    ],
  }
}
Propiedades
@type

Obligatoria

Debe ser "ListItem".

position

Integer (obligatoria)

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

url

URL (obligatoria para las páginas de resumen; no incluir para las listas con todo el contenido en una página)

Se usa solo para listas de páginas de resumen. 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/inferior a la página actual).

item

Thing (obligatoria para todas las listas con todo el contenido en una página; no incluir para las páginas de resumen)

Se usa solo para listas con todo el contenido en una página. Completa los valores de este objeto como se indica a continuación; además, agrega todos los miembros del tipo de dato estructurado específico que describes:

  • @type: Es el nombre del tipo de schema.org correspondiente al objeto que se describe. Ejemplo: "Receta".
  • url: Es la URL completa más el anclaje a este elemento en la página. 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".
  • name: Nombre de string del elemento, que se muestra en la galería procesada. El formato HTML se ignora.
  • Cualquier otra propiedad requerida para este tipo de datos, como se describe en schema.org y en 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 isbn y bookFormat; para una receta, debes agregar image y prepTime.

Enviar comentarios sobre…