Fragmento de reseña

Un fragmento de reseña es un extracto breve de una reseña o puntuación de un sitio web de reseñas, que suele ser un promedio de las puntuaciones combinadas de muchos reseñadores. Cuando encontramos reseñas válidas o etiquetas de puntuación, podemos mostrar un fragmento enriquecido que incluye estrellas y otra información resumida de las reseñas o puntuaciones. Además del texto de la reseña, una puntuación es una evaluación representada con una escala numérica (por ejemplo, de 1 a 5). Los fragmentos de reseña pueden aparecer en resultados enriquecidos o en paneles de información de Google. Puedes proporcionar puntuaciones de los siguientes tipos y subtipos de contenido:

Google también admite reseñas de los siguientes tipos de schema.org (y de sus subtipos):

Integrar con fragmentos de reseñas

A continuación, se explica a grandes rasgos cómo integrar los fragmentos de reseñas en Google:

  1. Comprueba que el robot de Google puede rastrear tus páginas; es decir, que no están protegidas por archivos robots.txt ni por metaetiquetas "robots".
  2. Recuerda que debes seguir nuestras directrices.
  3. Añade datos estructurados a tus páginas con reseñas.
  4. Prueba y previsualiza tus datos estructurados.
  5. Comprueba el estado de indexación de tus URL y solicita que se rastreen con la herramienta de inspección de URLs en Search Console. Usa la función de prueba en tiempo real para confirmar que los rastreadores pueden acceder a los datos estructurados de tu página.
  6. Avisa a Google de las nuevas páginas o de los cambios que hayas hecho en otras páginas.
  7. Puedes monitorizar el rendimiento que tienen tus reseñas en la Búsqueda con las siguientes herramientas de Google:

Probarlo

Para añadir datos estructurados de reseña a una página, puedes seguir estos pasos:

  • Añadir una reseña sencilla.
  • Anidar una reseña en otro tipo de schema.org con su propiedad review.
  • Añadir puntuaciones totales. Puedes omitir la puntuación de una reseña concreta si tu contenido con etiquetas contiene tanto un autor como una fecha de reseña. En el caso de las reseñas totales, debes proporcionar la puntuación media para que se muestre el fragmento enriquecido.
  • Anidar puntuaciones totales en otro tipo de schema.org con su propiedad aggregateRating.

Reseña sencilla

A continuación, se muestra un ejemplo de una reseña sencilla 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>

Reseña anidada

A continuación, se muestra un ejemplo de una reseña anidada en un objeto Product. Puedes copiar y pegar el ejemplo en tu propia página HTML.

JSON-LD

RDFa

Microdatos

Puntuación total

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

JSON-LD

RDFa

Microdatos

Puntuación total anidada

A continuación, se muestra un ejemplo de una puntuación total anidada en un objeto Product. Puedes copiar y pegar el ejemplo en tu propia página HTML.

JSON-LD

RDFa

Microdatos

Directrices

Tu contenido debe seguir estas directrices para poder aparecer como un resultado enriquecido.

Directrices técnicas

  • Debes incluir etiquetas en una valoración total de un elemento hecha por muchas personas con schema.org/AggregateRating. En Google, podemos mostrar puntuaciones totales como fragmentos enriquecidos o, para ciertos tipos de elementos, como respuestas en los resultados de búsqueda.
  • Haz referencia claramente a productos o servicios concretos anidando la reseña dentro de etiquetas de otro tipo de schema.org, como schema.org/Book o schema.org/Recipe, o indicando un tipo de schema.org como valor de la propiedad itemReviewed.
  • Asegúrate de que las reseñas y puntuaciones que etiquetes estén disponibles para los usuarios de la página etiquetada. Estos usuarios deberían ver a primera vista que la página tiene contenido de reseña.
  • Proporciona información de reseñas sobre elementos específicos, no sobre categorías ni sobre listas de elementos. Por ejemplo, consulta los errores habituales asociados a los elementos de listas.
  • Si el fragmento de reseña es de una organización o empresa local, debes seguir estas directrices adicionales:
    • Las páginas que utilizan LocalBusiness o cualquier otro tipo de datos estructurados de Organization no son aptas para aprovechar la función de reseñas mediante estrellas si la entidad sobre las que tratan las reseñas controla las reseñas sobre sí misma. Por ejemplo, una reseña sobre la entidad A se publica en el sitio web de la entidad A, ya sea directamente en sus datos estructurados o mediante un widget de terceros insertado.
    • Las puntuaciones deben hacerlas directamente los usuarios.
    • No uses editores humanos para crear, seleccionar o compilar información de puntuaciones para empresas locales; en vez de eso, usa datos estructurados de reseñas de críticos.
    • Los sitios web deben recoger información de puntuaciones directamente de los usuarios y no de otros sitios web.

Definiciones de tipos de datos estructurados

Debes incluir las propiedades obligatorias para que los datos estructurados se muestren en los resultados de búsqueda. Si quieres, puedes especificar también las propiedades recomendadas para añadir más información estructurada a tus datos y, así, ofrecer una mejor experiencia a los usuarios.

Review

Puedes consultar la definición completa de Review en schema.org/Review.

Propiedades obligatorias
author

Person o Organization

Es el autor de la reseña, que debe tener un nombre válido. Por ejemplo, "50 % de descuento hasta el sábado" no puede ser un nombre de reseñador.

itemReviewed

Thing

Indica el elemento sobre el que trata la reseña. Sin embargo, si la reseña se anida en otro tipo de schema.org mediante la propiedad review, puedes omitir la propiedad itemReviewed. Los tipos válidos del artículo reseñado son:

itemReviewed.name

Text

Indica el artículo sobre el que trata la reseña. Si la reseña se anida en otro tipo de schema.org mediante la propiedad review, sigue siendo necesario proporcionar la name de lo que se está reseñando. 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

Indica la puntuación dada en esta reseña. La puntuación puede ser una puntuación anidada o un subtipo más específico. El subtipo más habitual es AggregateRating.

reviewRating.ratingValue

Number o Text

Indica la puntuación de la calidad del artículo en formato numérico, ya sea un número, una fracción o un porcentaje (como "4", "60 %" o "6/10"). Si con la puntuación por sí sola no se puede saber cuál es la escala usada (por ejemplo, "4"), se supone que será del 1 al 5. Si quieres utilizar otra escala, usa bestRating y worstRating.

Propiedades recomendadas
datePublished

Date

Indica la fecha en que se publicó la reseña, en formato de fecha ISO 8601.

reviewRating.bestRating

Number

Indica el valor más alto permitido en este sistema de puntuación. La propiedad bestRating solo debe especificarse si el sistema de puntuación no es una escala de 5 puntos. Si no se incluye ningún valor en bestRating, se supone que es 5.

reviewRating.worstRating

Number

Indica el valor más bajo permitido en este sistema de puntuación. La propiedad worstRating solo debe especificarse si el sistema de puntuación no es una escala de 5 puntos. Si no se incluye ningún valor en worstRating, se supone que es 1.

AggregateRating

Puedes consultar la definición completa de AggregateRating en schema.org/AggregateRating.

Propiedades obligatorias
itemReviewed

Thing

Es el artículo que se está valorando. Sin embargo, si la puntuación total se anida en otro tipo de schema.org mediante la propiedad aggregateRating, no hace falta que incluyas la propiedad itemReviewed. Los tipos válidos del artículo reseñado son:

itemReviewed.name

Text

Indica el artículo sobre el que trata la reseña. Si la reseña se anida en otro tipo de schema.org mediante la propiedad review, sigue siendo necesario proporcionar la name de lo que se está reseñando. Por ejemplo:


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

Number

Indica el número total de puntuaciones del artículo en tu sitio web. Se requiere por lo menos ratingCount o reviewCount.

reviewCount

Number

Especifica el número de personas que proporcionaron una reseña con o sin una puntuación. Se requiere por lo menos ratingCount o reviewCount.

ratingValue

Number o Text

Indica la puntuación de la calidad del artículo en formato numérico, ya sea un número, una fracción o un porcentaje (como "4", "60 %" o "6/10"). Si con la puntuación por sí sola no se puede saber cuál es la escala usada (por ejemplo, "4"), se supone que será del 1 al 5. Si quieres utilizar otra escala, usa bestRating y worstRating.

Propiedades recomendadas
bestRating

Number

Indica el valor más alto permitido en este sistema de puntuación. La propiedad bestRating solo debe especificarse si el sistema de puntuación no es una escala de 5 puntos. Si no se incluye ningún valor en bestRating, se supone que es 5.

worstRating

Number

Indica el valor más bajo permitido en este sistema de puntuación. La propiedad worstRating solo debe especificarse si el sistema de puntuación no es una escala de 5 puntos. Si no se incluye ningún valor en worstRating, se supone que es 5.

Solucionar problemas

Si tus reseñas no aparecen en los resultados de la Búsqueda o has recibido un mensaje en Search Console, a continuación se indican algunos recursos que pueden resultarte útiles.