Fragmento de opinión

Un fragmento de opinión es un extracto breve de una opinión o una calificación de un sitio web de opiniones; por lo general, es un promedio de las puntuaciones combinadas de las opiniones que dejan los usuarios. Si Google encuentra lenguaje de marcado válido de opiniones o calificaciones, es posible que se muestre un fragmento enriquecido que incluya estrellas y otra información resumida de opiniones o calificaciones. Una calificación, además de contener el texto de la opinión, es una evaluación que se describe en una escala numérica (por ejemplo, del 1 al 5). Los fragmentos de opinión pueden aparecer en los resultados enriquecidos o en los Paneles de conocimiento de Google. Puedes proporcionar calificaciones para los siguientes tipos (y subtipos) de contenido:

Google también admite opiniones para los siguientes tipos de schema.org (y sus subtipos):

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

Existen varias formas de agregar datos estructurados de Review a una página, entre las que se incluyen las siguientes:

  • Agrega una opinión simple.
  • Incorpora una opinión a otro tipo de schema.org mediante su propiedad review.
  • Incluye calificaciones agregadas. Puedes omitir la calificación de una opinión individual si tu contenido con lenguaje de marcado incluye el autor y la fecha de la opinión. En el caso de las opiniones agregadas, debes proporcionar la calificación promedio para que se muestre el fragmento enriquecido.
  • Anida calificaciones agregadas en otro tipo de schema.org con su propiedad aggregateRating.

Opinión simple

A continuación, se muestra un ejemplo de una opinión simple que puedes copiar y pegar en tu propia página HTML.

JSON-LD


<html>
  <head>
  <title>Legal Seafood</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Review",
      "itemReviewed": {
        "@type": "Restaurant",
        "image": "http://www.example.com/seafood-restaurant.jpg",
        "name": "Legal Seafood",
        "servesCuisine": "Seafood",
        "priceRange": "$$$",
        "telephone": "1234567",
        "address" :{
          "@type": "PostalAddress",
          "streetAddress": "123 William St",
          "addressLocality": "New York",
          "addressRegion": "NY",
          "postalCode": "10038",
          "addressCountry": "US"
        }
      },
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "4"
      },
      "name": "A good seafood place.",
      "author": {
        "@type": "Person",
        "name": "Bob Smith"
      },
      "reviewBody": "The seafood is great.",
      "publisher": {
        "@type": "Organization",
        "name": "Washington Times"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

RDFa


 <html>
  <head>
    <title>Legal Seafood</title>
  </head>
  <body>
    <div vocab="https://schema.org/" typeof="Review">
      <div property="itemReviewed" typeof="Restaurant">
        <img property="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/>
        <span property="name">Legal Seafood</span>
        <span property="servesCuisine">Seafood</span>
        <span property="priceRange">$$$</span>
        <span property="telephone">1234567</span>
        <span property="address">123 William St, New York</span>
      </div>
      <span property="reviewRating" typeof="Rating">
        <span property="ratingValue">4</span>
      </span> stars -
      <b>"<span property="name">A good seafood place.</span>" </b>
      <span property="author" typeof="Person">
        <span property="name">Bob Smith</span>
      </span>
      <span property="reviewBody">The seafood is great.</span>
      <div property="publisher" typeof="Organization">
        <meta property="name" content="Washington Times">
      </div>
    </div>
  </body>
</html>

Microdatos


 <html>
  <head>
  <title>Legal Seafood</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/Review">
      <div itemprop="itemReviewed" itemscope itemtype="https://schema.org/Restaurant">
        <img itemprop="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/>
        <span itemprop="name">Legal Seafood</span>
        <span itemprop="servesCuisine">Seafood</span>
        <span itemprop="priceRange">$$$</span>
        <span itemprop="telephone">1234567</span>
        <span itemprop="address">123 William St, New York</span>
      </div>
      <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
        <span itemprop="ratingValue">4</span>
      </span> stars -
      <b>"<span itemprop="name">A good seafood place.</span>" </b>
      <span itemprop="author" itemscope itemtype="https://schema.org/Person">
        <span itemprop="name">Bob Smith</span>
      </span>
      <span itemprop="reviewBody">The seafood is great.</span>
      <div itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
        <meta itemprop="name" content="Washington Times">
      </div>
    </div>
  </body>
</html>

Opinión anidada

Este es un ejemplo de una opinión anidada en un elemento Product. Puedes copiar y pegar el ejemplo en tu propia página HTML.

JSON-LD

<html>
  <head>
    <title>The Catcher in the Rye</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Product",
      "brand": {
        "@type": "Brand",
        "name": "Penguin Books"
      },
      "description": "The Catcher in the Rye is a classic coming-of-age story: an story of teenage alienation, capturing the human need for connection and the bewildering sense of loss as we leave childhood behind.",
      "sku": "9780241984758",
      "mpn": "925872",
      "image": "http://www.example.com/catcher-in-the-rye-book-cover.jpg",
      "name": "The Catcher in the Rye",
      "review": {
        "@type": "Review",
        "reviewRating": {
          "@type": "Rating",
          "ratingValue": "5"
        },
        "author": {
          "@type": "Person",
          "name": "John Doe"
        },
        "reviewBody": "I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood."
      },
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": "88",
        "bestRating": "100",
        "ratingCount": "20"
      },
      "offers": {
        "@type": "Offer",
        "url": "https://example.com/offers/catcher-in-the-rye",
        "priceCurrency": "USD",
        "price": "5.99",
        "priceValidUntil": "2020-11-05",
        "itemCondition": "https://schema.org/UsedCondition",
        "availability": "https://schema.org/InStock",
        "seller": {
          "@type": "Organization",
          "name": "eBay"
        }
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

RDFa

 <html>
  <head>
    <title>The Catcher in the Rye</title>
  </head>
  <body>
    <div vocab="https://schema.org/" typeof="Product">
      <img property="image" src="https://example.com/photos/1x1/catcher-in-the-rye-book-cover.jpg" alt="Catcher in the Rye"/>
      <span property="name">The Catcher in the Rye</span>
      <div property="review" typeof="Review"> Review:
        <span property="reviewRating" typeof="Rating">
            <span property="ratingValue">5</span> -
        </span>
        <b>"<span property="name">A masterpiece of literature</span>" </b> by
        <span property="author" typeof="Person">
          <span property="name">John Doe</span></span>, written on
        <meta property="datePublished" content="2006-05-04">May 4, 2006
        <div property="reviewBody">I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood.</div>
        <span property="publisher" typeof="Organization">
            <meta property="name" content="Washington Times">
        </span>
      </div>
    </div>
  </body>
</html>

Microdatos

 <html>
  <head>
    <title>The Catcher in the Rye</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/Product">
      <img itemprop="image" src="https://example.com/photos/1x1/catcher-in-the-rye-book-cover.jpg" alt="Catcher in the Rye"/>
      <span itemprop="name">The Catcher in the Rye</span>
      <div itemprop="review" itemscope itemtype="https://schema.org/Review"> Review:
        <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
            <span itemprop="ratingValue">5</span> -
        </span>
        <b>"<span itemprop="name">A masterpiece of literature</span>" </b> by
        <span itemprop="author" itemscope itemtype="https://schema.org/Person">
          <span itemprop="name">John Doe</span></span>, written on
        <meta itemprop="datePublished" content="2006-05-04">May 4, 2006
        <div itemprop="reviewBody">I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood.</div>
        <span itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
            <meta itemprop="name" content="Washington Times">
        </span>
      </div>
    </div>
  </body>
</html>

Calificación agregada

Este es un ejemplo de una calificación agregada que puedes copiar y pegar en tu propia página HTML.

JSON-LD

<html>
  <head>
    <title>Legal Seafood</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "AggregateRating",
      "itemReviewed": {
        "@type": "Restaurant",
        "image": "http://www.example.com/seafood-restaurant.jpg",
        "name": "Legal Seafood",
        "servesCuisine": "Seafood",
        "telephone": "1234567",
        "address" : {
          "@type": "PostalAddress",
          "streetAddress": "123 William St",
          "addressLocality": "New York",
          "addressRegion": "NY",
          "postalCode": "10038",
          "addressCountry": "US"
        }
      },
      "ratingValue": "88",
      "bestRating": "100",
      "ratingCount": "20"
    }
    </script>
  </head>
  <body>
  </body>
</html>

RDFa

 <html>
  <head>
    <title>Legal Seafood</title>
  </head>
  <body>
    <div vocab="https://schema.org/" typeof="AggregateRating">
      <div property="itemReviewed" typeof="Restaurant">
        <img property="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/>
        <span property="name">Legal Seafood</span>
        <span property="servesCuisine">Seafood</span>
        <span property="telephone">1234567</span>
        <span property="address">123 William St, New York</span>
      </div>
      <span property="ratingValue">4.2</span> out of <span property="bestRating">5</span> stars -
      <span property="ratingCount">123</span> votes
    </div>
  </body>
</html>

Microdatos

 <html>
  <head>
    <title>Legal Seafood</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/AggregateRating">
      <div itemprop="itemReviewed" itemscope itemtype="https://schema.org/Restaurant">
        <img itemprop="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/>
        <span itemprop="name">Legal Seafood</span>
        <span itemprop="servesCuisine">Seafood</span>
        <span itemprop="telephone">1234567</span>
        <span itemprop="address">123 William St, New York</span>
      </div>
      <span itemprop="ratingValue">4.2</span> out of <span itemprop="bestRating">5</span> stars -
      <span itemprop="ratingCount">123</span> votes
    </div>
  </body>
</html>

Calificación agregada anidada

Este es un ejemplo de una calificación agregada anidada en un elemento Product. Puedes copiar y pegar el ejemplo en tu propia página HTML.

JSON-LD

<html>
  <head>
  <title>Executive Anvil</title>
  <script type="application/ld+json">
  {
    "@context": "https://schema.org/",
    "@type": "Product",
    "name": "Executive Anvil",
    "image": [
      "https://example.com/photos/1x1/photo.jpg",
      "https://example.com/photos/4x3/photo.jpg",
      "https://example.com/photos/16x9/photo.jpg"
     ],
    "brand": {
      "@type": "Thing",
      "name": "ACME"
    },
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": "4.4",
      "ratingCount": "89"
    },
    "offers": {
      "@type": "AggregateOffer",
      "lowPrice": "119.99",
      "highPrice": "199.99",
      "priceCurrency": "USD"
    }
  }
  </script>
  </head>
  <body>
  </body>
</html>

RDFa

 <html>
  <head>
    <title>Executive Anvil</title>
  </head>
  <body>
    <div vocab="https://schema.org/" typeof="Product">
     <span property="brand">ACME</span> <span property="name">Executive Anvil</span>
     <img property="image" src="https://example.com/photos/1x1/anvil_executive.jpg" alt="Executive Anvil logo" />
     <span property="aggregateRating"
           typeof="AggregateRating">
      Average rating: <span property="ratingValue">4.4</span>, based on
      <span property="ratingCount">89</span> reviews
     </span>
     <span property="offers" typeof="AggregateOffer">
      from $<span property="lowPrice">119.99</span> to
      $<span property="highPrice">199.99</span>
      <meta property="priceCurrency" content="USD" />
     </span>
    </div>
  </body>
</html>

Microdatos

 <html>
  <head>
    <title>Executive Anvil</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/Product">
      <span itemprop="brand">ACME</span> <span itemprop="name">Executive Anvil</span>
      <img itemprop="image" src="https://example.com/photos/1x1/anvil_executive.jpg" />
      <span itemprop="aggregateRating" itemscope itemtype="https://schema.org/AggregateRating">
        Average rating: <span itemprop="ratingValue">4.4</span>, based on
        <span itemprop="ratingCount">89</span> reviews
      </span>
      <span itemprop="offers" itemscope itemtype="https://schema.org/AggregateOffer">
        from $<span itemprop="lowPrice">119.99</span> to
        $<span itemprop="highPrice">199.99</span>
        <meta itemprop="priceCurrency" content="USD" />
      </span>
    </div>
  </body>
</html>

Lineamientos

Tu contenido debe seguir estos lineamientos a fin de que sea apto para aparecer como resultado enriquecido.

Lineamientos técnicos

  • Asegúrate de marcar una evaluación agregada de un elemento realizada por muchos usuarios con schema.org/AggregateRating. Google podría mostrar calificaciones agregadas como fragmentos enriquecidos o, en el caso de tipos de elementos específicos, como respuestas en los resultados de la búsqueda.
  • Haz una referencia clara a un producto o servicio específico. Para ello, anida la opinión dentro del lenguaje de marcado de otro tipo de schema.org, como schema.org/Book o schema.org/Recipe, o bien usa un tipo de schema.org como valor para la propiedad itemReviewed.
  • Asegúrate de que las opiniones y calificaciones que marques estén disponibles para los usuarios desde la página marcada. Debe resultar obvio de manera inmediata para los usuarios que la página tiene contenido de opinión.
  • Proporciona información sobre las opiniones de un elemento específico, no sobre categorías ni listas de elementos. Para ver ejemplos, consulta los errores comunes asociados con los elementos de listas.
  • Si el fragmento de opinión es para una empresa u organización local, debes seguir estos lineamientos adicionales:
    • Las páginas que usan LocalBusiness o cualquier otro tipo de datos estructurados de Organization no son aptas para la función de opiniones en estrellas si la entidad en cuestión controla las opiniones sobre sí misma. Por ejemplo, una opinión sobre la entidad A se coloca en el sitio web de la entidad A, ya sea directamente en sus datos estructurados o a través de un widget de terceros incorporado.
    • Las calificaciones deben obtenerse directamente de los usuarios.
    • No dependas de editores humanos para crear, seleccionar o compilar información de calificaciones de empresas locales. En su lugar, usa los datos estructurados de opiniones de críticos.
    • Los sitios deben recopilar información de calificaciones directamente de los usuarios, no de otros sitios.

Definiciones de tipos de datos estructurados

Para que tus datos estructurados se muestren en los resultados de búsqueda, debes incluir las propiedades obligatorias. También puedes incluir las propiedades recomendadas para agregar más información a tus datos estructurados; esto podría mejorar la experiencia del usuario.

Review

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

Propiedades obligatorias
author

Person o Organization

Corresponde al autor de la opinión. El nombre del usuario que deja la opinión debe ser un nombre válido. Por ejemplo, "50% de descuento hasta el sábado" no es un nombre válido para un usuario que deja una opinión.

itemReviewed

Thing

Es el elemento sobre el que se escribe la opinión. Sin embargo, si la opinión está anidada en otro tipo de schema.org con la propiedad review, puedes omitir la propiedad itemReviewed. Los tipos válidos para el elemento sobre el que se opina son los siguientes:

itemReviewed.name

Text

Es el nombre del elemento sobre el que se escribe la opinión. Si la opinión está anidada en otro tipo de schema.org mediante la propiedad review, aún así debes proporcionar el objeto name del elemento sobre el que se escribe la opinión. Por ejemplo:

{
  "@context": "https://schema.org/",
  "@type": "Game",
  "name": "Firefly",
  "review": {
    "@type": "Review",
    "reviewRating": {
      "@type": "Rating",
      "ratingValue": "5"
    },
    "author": {
      "@type": "Person",
      "name": "John Doe"
    },
    "reviewBody": "I really enjoyed this game. You
    get to capture fireflies and put them in jars."
  }
}
reviewRating

Rating

Corresponde a la calificación que se otorga en esta opinión. La calificación puede ser una propiedad Rating anidada o un subtipo más específico. El subtipo más común es AggregateRating.

reviewRating.ratingValue

Number o Text

Corresponde a una calificación de calidad numérica para el elemento, ya sea un número, una fracción o un porcentaje (por ejemplo, "4", "60%" o "6/10"). Si la escala no está implícita (por ejemplo, "4"), se supone una escala del 1 al 5. Si prefieres otra escala, usa bestRating y worstRating.

Propiedades recomendadas
datePublished

Date

Corresponde a la fecha en la que se publicó la opinión. Debe mostrarse en formato de fecha ISO 8601.

reviewRating.bestRating

Number

Es el valor más alto permitido en este sistema de calificación. La propiedad bestRating solo es obligatoria si el sistema de calificación no es una escala de 5 puntos. Si se omite bestRating, se supone que es 5.

reviewRating.worstRating

Number

Es el valor más bajo permitido en este sistema de calificación. La propiedad worstRating solo es obligatoria si el sistema de calificación no es una escala de 5 puntos. Si se omite worstRating, se supone que es 1.

AggregateRating

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

Propiedades obligatorias
itemReviewed

Thing

Corresponde al elemento que se está calificando. Sin embargo, si la calificación agregada está anidada en otro tipo de schema.org con la propiedad aggregateRating, puedes omitir la propiedad itemReviewed. Los tipos válidos para el elemento sobre el que se opina son los siguientes:

itemReviewed.name

Text

Es el nombre del elemento sobre el que se escribe la opinión. Si la opinión está anidada en otro tipo de schema.org mediante la propiedad review, aún así debes proporcionar el objeto name del elemento sobre el que se escribe la opinión. Por ejemplo:

{
  "@context": "https://schema.org/",
  "@type": "Game",
  "name": "Firefly",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "88",
    "bestRating": "100",
    "ratingCount": "20"
  }
}
ratingCount

Number

Corresponde a la cantidad total de calificaciones que hay para este elemento en tu sitio. Se requiere al menos uno de los siguientes valores: ratingCount o reviewCount.

reviewCount

Number

Especifica la cantidad de usuarios que proporcionó una opinión con o sin una calificación. Se requiere al menos uno de los siguientes valores: ratingCount o reviewCount.

ratingValue

Number o Text

Corresponde a una calificación de calidad numérica para el elemento, ya sea un número, una fracción o un porcentaje (por ejemplo, "4", "60%" o "6/10"). Si la escala no está implícita (por ejemplo, "4"), se supone una escala del 1 al 5. Si deseas usar otra escala, usa bestRating y worstRating.

Propiedades recomendadas
bestRating

Number

Es el valor más alto permitido en este sistema de calificación. La propiedad bestRating solo es obligatoria si el sistema de calificación no es una escala de 5 puntos. Si se omite bestRating, se asume que es 5.

worstRating

Number

Es el valor más bajo permitido en este sistema de calificación. La propiedad worstRating solo es obligatoria si el sistema de calificación no es una escala de 5 puntos. Si se omite worstRating, se asume que es 1.

Cómo supervisar resultados enriquecidos con Search Console

Search Console es una herramienta que te ayuda a supervisar el rendimiento de tus páginas en la Búsqueda de Google. Si bien no es necesario que te registres en Search Console para que se incluya tu contenido en los resultados de la Búsqueda de Google, te puede ayudar a comprender y mejorar la forma en que Google ve tu sitio. Te recomendamos que revises Search Console en los siguientes casos:

  1. Después de implementar datos estructurados por primera vez
  2. Después de lanzar plantillas nuevas o actualizar código
  3. Para analizar tráfico periódicamente

Después de implementar datos estructurados por primera vez

Después de que Google haya indexado tus páginas, busca problemas con el informe de estado de resultados enriquecidos relevante. Lo ideal sería ver que hayan aumentado las páginas válidas, y no los errores ni las advertencias. Si encuentras problemas en los datos estructurados, haz lo siguiente:

  1. Corrige los errores.
  2. Inspecciona una URL publicada para verificar si el problema persiste.
  3. Solicitar una validación mediante el informe de estado.

Después de lanzar plantillas nuevas o actualizar código

Cuando realices cambios significativos en tu sitio web, supervisa los aumentos en las advertencias y los errores de los datos estructurados.
  • Si notas un aumento en la cantidad de errores, tal vez se deba a que implementaste una plantilla que no funciona o a que tu sitio interactúa con la plantilla actual de una forma diferente e incorrecta.
  • Si notas una disminución total de los datos estructurados (que no coincide con un aumento en la cantidad de errores), es posible que ya no estés incorporando datos estructurados en tus páginas. Usa la Herramienta de inspección de URL para saber cuál es la causa del problema.

Para analizar tráfico periódicamente

Analiza el tráfico de la Búsqueda de Google con el Informe de rendimiento. Los datos te mostrarán con qué frecuencia tu página aparece como resultado enriquecido en la Búsqueda, con qué frecuencia los usuarios hacen clic en ella y cuál es la posición promedio en la que apareces en los resultados de la búsqueda. También puedes extraer esos resultados automáticamente con la API de Search Console.

Solución de problemas

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