Fragmento de reseña

Un fragmento de reseña es un extracto breve de una reseña o calificació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 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):

Cómo añadir datos estructurados

Los datos estructurados son un formato estandarizado con el que se puede proporcionar información sobre una página y clasificar su contenido. Consulta cómo funcionan los datos estructurados si aún no te has familiarizado con ellos.

A continuación se explica a grandes rasgos cómo crear, probar y publicar datos estructurados. Si quieres consultar una guía detallada sobre cómo añadir datos estructurados a una página web, consulta el codelab de datos estructurados.

  1. Añade las propiedades obligatorias. Para saber dónde colocar datos estructurados en tus páginas, echa un vistazo a este vídeo, en el que se explica dónde insertar datos estructurados JSON-LD en una página.
  2. Sigue las directrices.
  3. Valida tu código con la prueba de resultados enriquecidos.
  4. Crea varias páginas que incluyan tus datos estructurados y comprueba cómo las ve Google con la herramienta de inspección de URLs. Asegúrate de que Google pueda acceder a tu página y de que no esté bloqueada por un archivo robots.txt, por la etiqueta noindex ni por requisitos de inicio de sesión. Si la página se ve bien, puedes solicitar que Google vuelva a rastrear tus URLs.
  5. Para que Google siempre tenga la versión actualizada de tus páginas, te recomendamos que envíes un sitemap. Puedes automatizar el envío con la API Sitemap de Search Console.

Ejemplos

Hay varias formas de añadir datos estructurados de reseña 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 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

<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>

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

<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>

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": "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>

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 valoraciones totales como fragmentos enriquecidos o, para ciertos tipos de elementos, 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 valoraciones 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 lista.
  • 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 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 valoraciones deben hacerlas directamente los usuarios.
    • No uses editores humanos para crear, seleccionar o compilar información de valoraciones para empresas locales; en vez de eso, usa datos estructurados de reseñas de críticos.
    • Los sitios web deben recoger información de valoraciones 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 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

Es el autor de la reseña. Esta propiedad debe incluir un nombre válido. Por ejemplo, "50 % de descuento hasta el sábado" no sirve como 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 de elementos reseñados 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 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"
    },
    "reviewBody": "I really enjoyed this game. You
    get to capture fireflies and put them in jars."
  }
}
reviewRating

Rating

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

reviewRating.ratingValue

Number o Text

Indica la valoración de calidad numérica del artículo, ya sea un número, una fracción o un porcentaje (como "4", "60 %" o "6/10"). Si con la valoració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 se quiere usar otra escala, usa 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 valoración. La propiedad bestRating solo se requiere si el sistema de valoració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 valoración. La propiedad worstRating solo se requiere si el sistema de valoració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 de elementos reseñados 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 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 valoración adjunta. Se requiere por lo menos ratingCount o reviewCount.

ratingValue

Number o Text

Indica la valoración de calidad numérica del artículo, ya sea un número, una fracción o un porcentaje (como "4", "60 %" o "6/10"). Si con la valoració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 se quiere usar otra escala, usa bestRating y worstRating.

Propiedades recomendadas
bestRating

Number

Indica el valor más alto permitido en este sistema de valoración. La propiedad bestRating solo se requiere si el sistema de valoració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 valoración. La propiedad worstRating solo se requiere si el sistema de valoración no es una escala de 5 puntos. Si no se incluye ningún valor en worstRating, se supone que es 1.

Monitorizar resultados enriquecidos con Search Console

Search Console es una herramienta que te ayuda a monitorizar el rendimiento de tus páginas en la Búsqueda de Google. No hace falta que te registres en Search Console para que tu sitio web aparezca en los resultados de la Búsqueda de Google, pero, si lo haces, sabrás cómo lo ve Google y qué puedes hacer para mejorarlo. Te recomendamos que consultes Search Console en los siguientes casos:

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

Después de implementar datos estructurados por primera vez

Una vez que Google haya indexado tus páginas, puedes comprobar si hay algún problema en el informe de estado de resultados enriquecidos correspondiente. Lo ideal sería ver que aumenta el número de páginas válidas y que la cantidad de errores y advertencias se mantiene estable. Si detectas problemas en tus datos estructurados, haz lo siguiente:

  1. Corrige los errores.
  2. Inspecciona la URL en tiempo real para ver si el problema continúa.
  3. Solicita que se valide la corrección desde el informe de estado.

Después de publicar plantillas nuevas o modificar el código

Cuando hagas cambios importantes en tu sitio web, mira si se incrementa la cantidad de errores y advertencias de datos estructurados.
  • Si notas que hay más errores, quizá sea porque has implementado una plantilla que no funciona correctamente, o puede que tu sitio web esté interactuando con la plantilla que utilizas de un modo diferente e incorrecto.
  • Si notas que disminuye el número de elementos válidos sin que aumenten los errores, es posible que hayas dejado de insertar datos estructurados en tus páginas. Para saber cuál es la causa del problema, utiliza la herramienta de inspección de URLs.

Para analizar el tráfico periódicamente

Analiza el tráfico de la Búsqueda de Google con el informe de rendimiento. En él, verás con qué frecuencia aparece tu página como resultado enriquecido en la Búsqueda, cada cuánto hacen clic en ella los usuarios y cuál es la posición media que ocupa tu sitio web en los resultados de búsqueda. También puedes obtener automáticamente estos resultados con la API de Search Console.

Solucionar problemas

Si tienes problemas para implementar datos estructurados en tu contenido, a continuación se incluyen recursos que pueden resultarte útiles.