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 opiniones pueden aparecer en los resultados enriquecidos o en los Paneles de conocimiento de Google. Puedes proporcionar calificaciones para los siguientes tipos de contenido:

Google también admite opiniones para los siguientes tipos de schema.org:

Ejemplos

Existen varias formas para agregar datos estructurados de opiniones, como las siguientes:

  • Agrega una opinión simple.
  • Incorpora una opinión a otro tipo de schema.org mediante su propiedad review.
  • Agrega calificaciones a tus opiniones.
  • 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.

Opinión simple

JSON-LD

Aquí tienes un ejemplo de una opinión simple en JSON-LD:

RDFa

Aquí tienes un ejemplo de una opinión simple en RDFa:

Microdatos

Aquí tienes un ejemplo de una opinión simple en microdatos:

Opinión incorporada

JSON-LD

Aquí tienes un ejemplo de una opinión incorporada en JSON-LD:

RDFa

Aquí tienes un ejemplo de una opinión incorporada en RDFa:

Microdatos

Aquí tienes un ejemplo de una opinión incorporada en microdatos:

Opinión con calificaciones

JSON-LD

Aquí tienes un ejemplo de una opinión con calificaciones en JSON-LD:

RDFa

Aquí tienes un ejemplo de una opinión con calificaciones en RDFa:

Microdatos

Aquí tienes un ejemplo de una opinión con calificaciones en microdatos:

Calificación agregada

JSON-LD

Aquí tienes un ejemplo de una calificación agregada en JSON-LD:

RDFa

Aquí tienes un ejemplo de una calificación agregada en RDFa:

Microdatos

Aquí tienes un ejemplo de una calificación agregada en microdatos:

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 calificaciones de un elemento específico, no de categorías ni de 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, lo que podría brindar una mejor 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 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á incorporada en otro tipo de schema.org que usa la propiedad review, puedes omitir 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á incorporada 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 es 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á incorporada en otro tipo de schema.org que usa la propiedad aggregateRating, puedes omitir 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á incorporada 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 es 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.