# AggregateRating: la valoración media en Schema.org

> Qué es AggregateRating en Schema.org, qué propiedades pide Google para mostrar estrellas, qué valoraciones no puedes marcar y cómo comprobarlo en tu ficha.

URL: https://clione.ai/es/glosario/aggregaterating/
Lang: es

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](/es/glosario/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](/es/glosario/schema-review/). Te importa porque es la propiedad de tus [datos estructurados](/es/glosario/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](/es/glosario/schema-product/).[^schema-org-aggregaterating] Sus propiedades son pocas:[^schema-org-aggregaterating]

| Propiedad      | Qué dice                                |
| -------------- | --------------------------------------- |
| `ratingValue`  | La nota media                           |
| `ratingCount`  | Cuántas valoraciones forman esa media   |
| `reviewCount`  | Cuántas reseñas hay                     |
| `bestRating`   | El valor más alto que permite la escala |
| `worstRating`  | El valor más bajo que permite la escala |
| `itemReviewed` | Lo que se valora                        |

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](/es/glosario/resultados-enriquecidos/) o en el panel de conocimiento con estrellas y otros datos resumidos.[^google-review-snippet] Para eso pide:[^google-review-snippet]

- **`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`.[^google-product-snippet]

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**.[^google-review-snippet] Y hay una excepción que sorprende a muchas empresas: si la [entidad](/es/glosario/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.[^google-review-snippet] 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.

| Lo que muestra la ficha | Propiedad de AggregateRating | Valor |
| ----------------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------- |
| «4,6 de 5»              | `ratingValue`                | `"4.6"`                                                                                                     |
| «38 opiniones»          | `reviewCount`                | `"38"`                                                                                                      |
| Estrellas de 1 a 5      | `bestRating`, `worstRating`  | Se pueden omitir: es la escala por defecto                                                                  |

```json
{
  "@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.[^google-review-snippet] Sin `bestRating`, porque la escala de la tienda es de 1 a 5, la que Google supone.[^google-review-snippet] 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.[^google-sd-policies] 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](/es/glosario/metafields/) estándar de reseñas que escriben las principales aplicaciones), y un producto sin reseñas no lleva ninguna.


Marcar una nota sobre 10 sin decir la escala. Si tu tienda puntúa de 1 a 10 y el nodo dice `"ratingValue": "9.2"` sin `bestRating`, Google entiende que la escala va hasta 5, porque es lo que supone cuando falta.[^google-review-snippet] La media que ves en la ficha y la que lee la máquina dejan de ser la misma.


## 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.[^google-review-snippet]
3. **Comprueba la escala.** Si tus valoraciones no van de 1 a 5, el nodo tiene que decirlo con `bestRating` y `worstRating`.[^google-review-snippet]
4. **Confirma el origen de las reseñas**: tienen que ser de tu web, no reunidas de otras.[^google-review-snippet]
5. **Pasa la URL por la [Prueba de resultados enriquecidos](/es/glosario/prueba-de-resultados-enriquecidos/)** para ver qué detecta y con qué errores o advertencias.[^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.[^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.[^google-review-snippet] 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](/es/glosario/resenas-de-producto/), y tienen su propia entrada.

Para seguir, la [ruta de lectura de datos estructurados](/es/aprender/datos-estructurados/) ordena el resto de términos, y la entrada de [Organization](/es/glosario/schema-organization/) explica qué marcado describe a la empresa y por qué no es el sitio de sus estrellas.