Fragmento de reseña

Un fragmento de reseña es un extracto breve de una reseña o valoració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 valoración, podemos mostrar un fragmento enriquecido que incluye estrellas y otra información resumida de las reseñas o valoraciones. Además del texto de la reseña, una valoración es una evaluación representada con una escala numérica (como de 1 a 5). Los fragmentos de reseña pueden aparecer en resultados enriquecidos o en paneles de información de Google. Puedes proporcionar valoraciones de los siguientes tipos y subtipos de contenido:

Fragmento de reseña en la Búsqueda de Google

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

Ejemplos

Hay varias formas de añadir datos estructurados Review a una página:

  • 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 valoració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 valoració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.

JSON-LD


<html>
  <head>
  <title>Legal Seafood</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Review",
      "itemReviewed": {
        "@type": "Restaurant",
        "image": "https://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"
      },
      "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>
      <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>
      <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


<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": "https://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"
        }
       },
      {
        "@type": "Review",
        "reviewRating": {
          "@type": "Rating",
          "ratingValue": "1"
        },
        "author": {
          "@type": "Person",
          "name": "Jane Doe"
        }
      }],
      "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">
        <div rel="schema:brand">
          <div typeof="schema:Brand">
            <div property="schema:name" content="Penguin"></div>
          </div>
        </div>
        <div property="schema:description" content="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."></div>
        <div property="schema:sku" content="9780241984758"></div>
        <div property="schema:mpn" content="925872"></div>
        <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"> Reviews:
          <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">4 May 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 property="review" typeof="Review">
          <span property="reviewRating" typeof="Rating">
            <span property="ratingValue">1</span> -
          </span>
          <b>"<span property="name">The worst thing I've ever read</span>" </b> by
          <span property="author" typeof="Person">
            <span property="name">Jane Doe</span></span>, written on
          <meta property="datePublished" content="2006-05-10">10 May 2006
          <span property="publisher" typeof="Organization">
            <meta property="name" content="Washington Times">
          </span>
        </div>
        <div rel="schema:aggregateRating">
          <div typeof="schema:AggregateRating">
            <div property="schema:reviewCount" content="89"></div>
            <div property="schema:ratingValue" content="4.4">4,4</div> stars
          </div>
        </div>
        <div rel="schema:offers">
          <div typeof="schema:Offer">
            <div property="schema:price" content="4.99"></div>
            <div property="schema:availability" content="https://schema.org/InStock"></div>
            <div property="schema:priceCurrency" content="GBP"></div>
            <div property="schema:priceValidUntil" datatype="xsd:date" content="2020-11-21"></div>
            <div rel="schema:url" resource="https://example.com/catcher"></div>
            <div property="schema:itemCondition" content="https://schema.org/UsedCondition"></div>
          </div>
        </div>
    </div>
  </body>
</html>

Microdatos


 <html>
  <head>
    <title>The Catcher in the Rye</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/Product">
      <div itemprop="brand" itemtype="https://schema.org/Brand" itemscope>
        <meta itemprop="name" content="Penguin" />
      </div>
      <meta itemprop="description" content="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." />
      <meta itemprop="sku" content="0446310786" />
      <meta itemprop="mpn" content="925872" />
      <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"> Reviews:
        <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">4 May 2006
        <span itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
            <meta itemprop="name" content="Washington Times">
        </span>
      </div><div itemprop="review" itemscope itemtype="https://schema.org/Review">
        <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
            <span itemprop="ratingValue">1</span> -
        </span>
        <b>"<span itemprop="name">The worst thing I've ever read</span>" </b> by
        <span itemprop="author" itemscope itemtype="https://schema.org/Person">
          <span itemprop="name">Jane Doe</span></span>, written on
        <meta itemprop="datePublished" content="2006-05-10">10 May 2006
        <span itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
          <meta itemprop="name" content="Washington Times">
        </span>
      </div>
      <div itemprop="aggregateRating" itemtype="https://schema.org/AggregateRating" itemscope>
        <meta itemprop="reviewCount" content="89" />
        <span itemprop="ratingValue" content="4.4">4,4</span> stars
      </div>
      <div itemprop="offers" itemtype="https://schema.org/Offer" itemscope>
        <link itemprop="url" href="https://example.com/catcher" />
        <meta itemprop="availability" content="https://schema.org/InStock" />
        <meta itemprop="priceCurrency" content="GBP" />
        <meta itemprop="itemCondition" content="https://schema.org/UsedCondition" />
        <meta itemprop="price" content="4.99" />
        <meta itemprop="priceValidUntil" content="2020-11-21" />
      </div>
    </div>
  </body>
</html>

Puntuación total

A continuación se muestra un ejemplo de puntuación total.

JSON-LD


<html>
  <head>
    <title>Legal Seafood</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "AggregateRating",
      "itemReviewed": {
        "@type": "Restaurant",
        "image": "https://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>

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


<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": "Brand",
      "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" typeof="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" itemtype="https://schema.org/Brand" itemscope>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>

Directrices

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

Directrices técnicas

  • Debes incluir etiquetas en una calificación total de un elemento realizada por muchas personas con schema.org/AggregateRating. En Google, podemos mostrar puntuaciones totales como fragmentos enriquecidos o, en 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 las valoraciones que etiquetes estén disponibles para los usuarios en la página etiquetada. Estos usuarios tienen que ver a primera vista que la página incluye reseñas.
  • Proporciona información de reseñas sobre elementos específicos, no sobre categorías ni sobre listas de elementos.
  • Si incluyes varias reseñas, proporciona también la valoración media de las diferentes reseñas.
  • No agregues reseñas de otros sitios web.
  • Si el fragmento de reseña es de una organización o empresa local, debes seguir estas directrices adicionales:
    • Si la entidad que se está valorando controla las reseñas sobre sí misma, las páginas que usan LocalBusiness o cualquier otro tipo de datos estructurados de Organization no son aptas para la función de reseñas con estrellas. 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 valoraciones deben hacerlas directamente los usuarios.
    • No utilices personas para crear, seleccionar o compilar valoraciones de empresas locales.

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 a tus datos estructurados, lo que quizá mejore la experiencia de los usuarios.

Review

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

Propiedades obligatorias
author

Person o Organization

El autor de la reseña. El nombre del autor de la reseña debe ser un nombre válido. Por ejemplo, "50 % de descuento hasta el sábado" no sirve como nombre de autor de la reseña.

Este campo debe tener menos de 100 caracteres. Si tiene más, tu página no podrá aparecer en fragmentos de reseñas basados en autores.

Para ayudar a Google a identificar mejor a los autores en distintas funciones, te recomendamos que sigas las prácticas recomendadas para etiquetar autores.

itemReviewed

Uno de los tipos válidos

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 de elementos reseñados válidos son:
itemReviewed.name

Text

Indica el nombre del 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 propiedad 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"
    }
}
reviewRating

Rating

Indica la puntuación dada en esta reseña. La puntuación puede ser Rating 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"). Google entiende la escala de fracciones y porcentajes, ya que la escala aparece en la propia fracción o en el porcentaje. La escala predeterminada de los números es de cinco puntos, donde 1 es el valor más bajo y 5 el más alto. Si quieres emplear otra escala, utiliza bestRating y worstRating.
Propiedades recomendadas
datePublished

Date

Indica la fecha en la 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; 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; 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

Uno de los tipos válidos

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 de elementos reseñados válidos son:
itemReviewed.name

Text

Indica el nombre del 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 propiedad 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 valoraciones 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"). Google entiende la escala de fracciones y porcentajes, ya que la escala aparece en la propia fracción o en el porcentaje. La escala predeterminada de los números es de cinco puntos, donde 1 es el valor más bajo y 5 el más alto. Si quieres emplear otra escala, utiliza bestRating y worstRating.
Propiedades recomendadas
bestRating

Number

Indica el valor más alto permitido en este sistema de puntuación; 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; si no se incluye ningún valor en worstRating, se supone que es 1.

Solucionar problemas

Si tienes problemas para implementar o depurar datos estructurados, a continuación se incluyen algunos recursos que pueden serte útiles.