¿Qué es AggregateRating en Schema.org?

Las estrellas que a veces salen debajo de un resultado de Google, con «4,6» y el número de opiniones al lado, tienen un origen concreto en el código de la página: un nodo AggregateRating. Es un tipo de Schema.org, y se escribe en inglés porque es un nombre del vocabulario. No es una reseña: es la media de todas, con su recuento. Cada reseña suelta, con su autor y su texto, es otro tipo, Review. Te importa porque es la propiedad de tus datos estructurados que más se ve cuando funciona, y la que más reglas tiene sobre de dónde pueden salir los números.

Cómo funciona

Schema.org define AggregateRating como la valoración media basada en varias valoraciones o reseñas. Es una clase de valoración (Rating) y se puede colgar, con la propiedad aggregateRating, de una marca, una obra, un evento, una oferta, una organización, un lugar, un servicio o un Product.⁠^{[1]Schema.org. AggregateRating} Sus propiedades son pocas:⁠^{[1]Schema.org. AggregateRating}

Google lo usa para el fragmento de reseña, que describe como un extracto breve de una reseña o de una valoración, normalmente la media de las notas de muchas personas, y que puede aparecer en los resultados enriquecidos o en el panel de conocimiento con estrellas y otros datos resumidos.⁠^{[2]Google Search Central. Review snippet (Review, AggregateRating) structured data} Para eso pide:⁠^{[2]Google Search Central. Review snippet (Review, AggregateRating) structured data}

• ratingValue, la media, como número, fracción o porcentaje.
• ratingCount o reviewCount, al menos uno de los dos. Google precisa la diferencia: el primero cuenta las valoraciones del artículo en tu web; el segundo, las personas que dejaron una reseña, con nota o sin ella.
• itemReviewed, lo que se valora, salvo que la valoración vaya anidada dentro de otro tipo con la propiedad aggregateRating, que es lo normal en una ficha: entonces se omite.
• La escala, si no es la de siempre. Si falta bestRating, Google entiende que es 5; si falta worstRating, que es 1.

En un producto, la valoración es una de las tres puertas al fragmento de producto: Google exige el nombre y al menos una de estas tres propiedades, review, aggregateRating u offers.⁠^{[3]Google Search Central. Product snippet (Product, Review, Offer) structured data}

Las reglas importan tanto como las propiedades. Las valoraciones que marcas tienen que estar a la vista de quien visita la página, y Google pide no reunir reseñas ni valoraciones de otras webs.⁠^{[2]Google Search Central. Review snippet (Review, AggregateRating) structured data} Y hay una excepción que sorprende a muchas empresas: si la entidad valorada controla las reseñas sobre sí misma, sus páginas con marcado de negocio local o de organización no optan a las estrellas.⁠^{[2]Google Search Central. Review snippet (Review, AggregateRating) structured data} La regla habla de ese marcado, el de la empresa sobre sí misma; las valoraciones de los productos que vende se marcan en el producto.

En una tienda

Una ficha con sus opiniones y su nodo, uno al lado del otro. Ejemplo ficticio: la tienda, el producto, la nota y el número de opiniones son inventados.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Camisa de lino Calella, azul",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.6",
    "reviewCount": "38"
  }
}

Sin itemReviewed, porque va dentro del producto.⁠^{[2]Google Search Central. Review snippet (Review, AggregateRating) structured data} Sin bestRating, porque la escala de la tienda es de 1 a 5, la que Google supone.⁠^{[2]Google Search Central. Review snippet (Review, AggregateRating) structured data} Y con los mismos números que ve el cliente: si la ficha dice 38 opiniones, el nodo dice 38, porque los datos estructurados no pueden marcar lo que el lector no ve.⁠^{[4]Google Search Central. General structured data guidelines} Si la ficha no muestra opiniones, el nodo no lleva valoración. Las tiendas que publican con Clione siguen esa misma regla: la valoración del nodo del producto sale de las reseñas de la propia tienda (en BigCommerce, las de la plataforma; en Shopify, los metafields estándar de reseñas que escriben las principales aplicaciones), y un producto sin reseñas no lleva ninguna.

Cómo comprobarlo

1. Busca aggregateRating en el código fuente de una ficha y apunta ratingValue, ratingCount o reviewCount, y bestRating si lo hay.
2. Compáralos con lo que ve el cliente en ese momento: la misma media y el mismo número de opiniones, a la vista en la ficha.⁠^{[2]Google Search Central. Review snippet (Review, AggregateRating) structured data}
3. Comprueba la escala. Si tus valoraciones no van de 1 a 5, el nodo tiene que decirlo con bestRating y worstRating.⁠^{[2]Google Search Central. Review snippet (Review, AggregateRating) structured data}
4. Confirma el origen de las reseñas: tienen que ser de tu web, no reunidas de otras.⁠^{[2]Google Search Central. Review snippet (Review, AggregateRating) structured data}
5. Pasa la URL por la Prueba de resultados enriquecidos para ver qué detecta y con qué errores o advertencias.⁠^{[5]Ayuda de Search Console. Rich Results Test}

Concepto cercano: Review

AggregateRating y Review se marcan juntos a menudo y responden a preguntas distintas. Review es una opinión concreta, con quien la escribe y su nota; AggregateRating es la media de muchas, con su recuento.⁠^{[1]Schema.org. AggregateRating} Un producto puede llevar las dos cosas, y los dos tipos sirven para el fragmento de reseña de Google, con sus propias propiedades obligatorias.⁠^{[2]Google Search Central. Review snippet (Review, AggregateRating) structured data} Si lo que quieres es que se vean las estrellas con el número de opiniones, el nodo que lo dice es AggregateRating; si quieres destacar lo que escribió un cliente, es Review. Lo que tus clientes escriben, antes de convertirse en marcado, son las reseñas de producto, y tienen su propia entrada.

Para seguir, la ruta de lectura de datos estructurados ordena el resto de términos, y la entrada de Organization explica qué marcado describe a la empresa y por qué no es el sitio de sus estrellas.