Libro

Las acciones de libros no solo convierten a la Búsqueda de Google en un punto de entrada para descubrir obras y autores, sino que también permiten a los usuarios comprar los libros que encuentran directamente desde los resultados de la Búsqueda. Como proveedor de libros electrónicos, puedes brindar una fuente de datos a Google usando el siguiente esquema de datos estructurados.

Una acción de book en los resultados de la Búsqueda

Cómo agregar datos estructurados

Los datos estructurados son un formato estandarizado para proporcionar información sobre una página y clasificar su contenido. Si aún no estás familiarizado con los datos estructurados, obtén más información sobre cómo funcionan.

A continuación, presentamos una descripción general de cómo generar, probar y actualizar datos estructurados. Si quieres obtener una guía paso a paso para agregar datos estructurados a una página web, consulta el codelab de datos estructurados.

  1. Agrega las propiedades obligatorias. Para obtener información sobre dónde colocar los datos estructurados en la página, mira el video JSON-LD Structured Data: Where to insert in a page?.
  2. Sigue los lineamientos.
  3. Valida tu código con la Prueba de resultados enriquecidos.
  4. Implementa algunas páginas que incluyan tus datos estructurados y utiliza la Herramienta de inspección de URL para probar el modo en el que Google ve la página. Asegúrate de que Google pueda acceder a la página y que no esté bloqueada por un archivo robots.txt, una etiqueta noindex ni requisitos de acceso. Si la página se ve bien, puedes pedirle a Google que vuelva a rastrear tus URL.
  5. Para mantener informado a Google sobre los cambios futuros, te recomendamos que envíes un mapa del sitio. Puedes automatizar este proceso con la API del mapa del sitio de Search Console.

Ejemplos

La consulta del usuario puede indicar la intención de encontrar un título específico (por ejemplo, El cazador oculto o los libros de JD Salinger). Para algunas consultas relevantes, es posible que mostremos la tarjeta del Gráfico de conocimiento del libro. Obtén más información para administrar tus datos del Gráfico de conocimiento. Las acciones de lectura, que están incorporadas en las tarjetas, muestran opciones para adquirir el libro. Mediante los vínculos que incluyas, las acciones de lectura enviarán a los usuarios directamente desde la tarjeta del Gráfico de conocimiento a la página de un libro en tu sitio o app.


<html>
  <head>
    <title>The Catcher in the Rye</title>
    <script type="application/ld+json">
    {
      "@context":"https://schema.org",
      "@type":"Book",
      "name" : "The Catcher in the Rye",
      "author": {
        "@type":"Person",
        "name":"J.D. Salinger"
      },
      "url" : "http://www.barnesandnoble.com/store/info/offer/JDSalinger",
      "workExample" : [{
        "@type": "Book",
        "isbn": "031676948",
        "bookEdition": "2nd Edition",
        "bookFormat": "https://schema.org/Hardcover",
        "potentialAction":{
        "@type":"ReadAction",
        "target":
          {
            "@type":"EntryPoint",
            "urlTemplate":"http://www.barnesandnoble.com/store/info/offer/0316769487?purchase=true",
            "actionPlatform":[
              "http://schema.org/DesktopWebPlatform",
              "http://schema.org/IOSPlatform",
              "http://schema.org/AndroidPlatform"
            ]
          },
          "expectsAcceptanceOf":{
            "@type":"Offer",
            "Price":6.99,
            "priceCurrency":"USD",
            "eligibleRegion" : {
              "@type":"Country",
              "name":"US"
            },
            "availability": "https://schema.org/InStock"
          }
        }
      },{
        "@type": "Book",
        "isbn": "031676947",
        "bookEdition": "1st Edition",
        "bookFormat": "https://schema.org/EBook",
        "potentialAction":{
        "@type":"ReadAction",
        "target":
          {
            "@type":"EntryPoint",
            "urlTemplate":"http://www.barnesandnoble.com/store/info/offer/031676947?purchase=true",
            "actionPlatform":[
              "http://schema.org/DesktopWebPlatform",
              "http://schema.org/IOSPlatform",
              "http://schema.org/AndroidPlatform"
            ]
          },
          "expectsAcceptanceOf":{
            "@type":"Offer",
            "Price":1.99,
            "priceCurrency":"USD",
            "eligibleRegion" : {
              "@type":"Country",
              "name":"UK"
            },
            "availability": "https://schema.org/InStock"
          }
        }
      }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Lineamientos

Además de los lineamientos generales para datos estructurados, sigue estas pautas específicas para libros y acciones de lectura:

  • Si tienes páginas duplicadas para el mismo contenido, el vínculo debe ser la URL canónica con el título del libro y la información relacionada.
  • Una vez que el usuario haga clic en el vínculo de una acción de lectura, se lo debería enviar a una página que permita adquirir el libro de forma directa.
  • Los vínculos de las acciones de lectura deben dirigir a una página en la que los usuarios puedan adquirir el contenido. No deben redireccionar a sitios en los que sea necesario hacer clic en más páginas para adquirir el contenido o ver más detalles, como una de resultados de la búsqueda o resumen de un producto.

Definiciones de tipos de datos estructurados

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 del usuario.

Book

Si bien la definición completa de Book está disponible en schema.org/Book, solo es necesario definir las propiedades que se indican a continuación. Debes establecer las siguientes propiedades obligatorias para cada libro de tu sitio.

Propiedades obligatorias

author

Person

Corresponde al autor del libro. Si hay varios, deberás proporcionar una entidad "Person" específica para cada uno. Consulta la sección Person.

name

Text

Corresponde al título del libro. Si proporcionas varias ediciones, usa el título de la edición del libro.

url

URL

Corresponde a la URL de tu sitio en la que se encuentra la página del libro. Ten en cuenta que la página puede incluir todas las ediciones disponibles.

workExample

Book

Corresponde a las ediciones de este libro. Consulta las subpropiedades de workExample.

Propiedades recomendadas

@id

URL

Corresponde al ID único global de la obra en forma de URL. El ID debe ser fijo y mantener el mismo formato con el paso del tiempo. Se considera que la URL es una string opaca que no necesariamente debe dirigir a una página web real.

sameAs

URL

Corresponde a una página de referencia que indica, inequívocamente, la identidad del libro. Por ejemplo, puede ser la URL del artículo de Wikipedia, la página de Freebase o el sitio web oficial del libro.

Country

Este subconjunto del objeto Offer define el código de país de dos letras en el que el objeto Offer es apto.

Propiedades obligatorias

name

Text

Corresponde al nombre del país según el estándar alpha-2 3166.

EntryPoint

El atributo EntryPoint funciona como mecanismo para que proporciones los vínculos directos a tus libros. Puedes especificarlos según el tipo de plataforma a donde deben dirigir.

Propiedades obligatorias

actionPlatform

Text

Corresponde a las plataformas en las que funciona el vínculo. Corresponde a una o varias de estas opciones:

  • http://schema.org/DesktopWebPlatform: Funciona en navegadores web o de escritorio.
  • http://schema.org/MobileWebPlatform: Funciona en navegador web para dispositivos móviles.
  • http://schema.org/AndroidPlatform: Funciona en apps nativas de Android.
  • http://schema.org/IOSPlatform: Funciona en apps nativas de iOS.

Se puede omitir esta propiedad para los vínculos directos que tengan un esquema personalizado de Android.

urlTemplate

URL

Corresponde a los vínculos que dirigen al contenido.

Offer

Define los Términos y Condiciones de una compra.

Propiedades obligatorias

price

Number

Corresponde al precio de oferta de un producto. Se designará la moneda en la propiedad priceCurrency.

priceCurrency

Text

Corresponde a la moneda (en formato ISO 4217 de 3 letras).

Propiedades recomendadas
@id URL

Corresponde al ID único global de la oferta.

availability

ItemAvailability

Corresponde a la disponibilidad de este artículo (por ejemplo, InStock, OutOfStock o PreOrder).

eligibleRegion

Country

Corresponde a los países donde es válida la oferta.

ineligibleRegion

Country

Corresponde a los países en los que no es válida la oferta. Es posible que se anulen regiones aptas si se incluye un país tanto en el conjunto de regiones aptas como en el de las que no son aptas.

Person

Google utiliza el parámetro del tipo Person para indicar el autor.

Propiedades obligatorias

name

Text

Corresponde al nombre de la persona.

Propiedades recomendadas

sameAs

URL

Corresponde a una página de referencia que indica, inequívocamente, la identidad del elemento. Por ejemplo, la URL del artículo de Wikipedia, la página de Freebase o el sitio web oficial del elemento en cuestión.

ReadAction

Las propiedades del objeto ReadAction determinan tanto la plataforma para el contenido como las condiciones en las que se puede producir la acción (por ejemplo, la compra del contenido antes de que se pueda comenzar la lectura).

Propiedades obligatorias

expectsAcceptanceOf

Offer

Corresponde al elemento que contiene las condiciones de la acción.

target

EntryPoint

Corresponde al elemento que contiene el objetivo de la acción.

workExample

Corresponde a una edición específica de la obra escrita o al volumen de esta.

Propiedades obligatorias

bookFormat

BookFormatType

Corresponde al formato del libro. Usa uno o más de los siguientes valores:

  • EBook
  • Hardcover
  • Paperback
  • AudioBook

isbn

Text

Corresponde al código ISBN del tomo, que puede tener 10 o 13 dígitos, pero recomendamos 13 dígitos si están disponibles. Usa el ISBN del libro impreso si la edición que se describe no tiene uno (por ejemplo, para la versión de Kindle).

potentialAction

ReadAction

Corresponde a las acciones de lectura disponibles.

Propiedades recomendadas

@id

URL

ID único global del volumen con formato de una URL. El ID debe ser fijo y mantener el mismo formato con el paso del tiempo. También debe ser distinto del ID usado para el libro. Se considera que la URL es una string opaca que no necesariamente debe ser un vínculo activo.

author

Person

Corresponde a los autores del tomo. Solo se debe usar esta propiedad si los autores de este elemento difieren de los del libro relacionado. Proporciona una entidad Person por autor.

bookEdition

Text

Corresponde a la edición del libro.

datePublished

Date

Corresponde a la fecha de la primera publicación de este tomo.

name

Text

Corresponde al título del tomo. Solo se debe usar esta propiedad para el título si difiere del libro relacionado.

sameAs

URL

Corresponde a una página de referencia que indica, inequívocamente, la identidad del elemento. Por ejemplo, la URL del artículo de Wikipedia, la página de Freebase o el sitio web oficial del elemento en cuestión.

url

URL

Corresponde a la URL específica de esta edición (si se estableció una).

Solución de problemas

Si tienes problemas para implementar datos estructurados, aquí tienes algunos recursos que pueden ayudarte.