Datos estructurados de producto: ofertas, reseñas, errores

Para qué sirve el marcado de producto

Los datos estructurados de producto describen un producto de forma que los programas puedan leerlo: su nombre, imagen, precio, moneda, disponibilidad y valoraciones. El vocabulario procede de schema.org, y un formato habitual es JSON-LD, un bloque de datos dentro de la página que los visitantes no ven. Google puede usar estos datos para mostrar información del producto en los resultados de búsqueda, por ejemplo un precio o estrellas de valoración. Google también deja claro que los datos estructurados no son ninguna promesa de un resultado enriquecido.

Dos tipos de páginas de producto

Google distingue dos casos. Las fichas de comerciante son para páginas en las que un comprador puede comprarte el producto. Los fragmentos de producto son para otras páginas de producto, como reseñas, pruebas y páginas de comparación. Los requisitos son distintos, así que decide primero qué caso es tu página.

Según Google, los resultados enriquecidos de producto solo admiten páginas centradas en un único producto o en varias variantes del mismo producto. Google recomienda añadir el marcado a las páginas de producto, no a páginas de categoría ni a listas de productos.

Los elementos básicos

• Product: el artículo en sí, con name, image, description, brand, sku y, si lo tienes, un GTIN.
• Offer: las condiciones de venta, con price, priceCurrency, availability, la url de la oferta y, si el precio termina, priceValidUntil.
• AggregateRating: la media de muchas valoraciones, con ratingValue y ratingCount o reviewCount.
• Review: una reseña individual. Google exige que el nombre del autor sea un nombre válido de una persona o de un equipo.

Un ejemplo mínimo

Este bloque describe una taza que está a la venta. Va en el HTML de la página de producto, normalmente en el head o al final del body.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Taza de cerámica azul, 0.3 l",
  "image": "https://example.com/img/mug-blue.jpg",
  "sku": "MUG-BL-03",
  "brand": { "@type": "Brand", "name": "Cerámica Ejemplo" },
  "offers": {
    "@type": "Offer",
    "price": "12.90",
    "priceCurrency": "EUR",
    "availability": "https://schema.org/InStock",
    "url": "https://example.com/mug-blue"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.6",
    "reviewCount": "38"
  }
}
</script>

Tres detalles causan muchos errores. schema.org pide un punto como signo decimal y ningún símbolo de moneda en el precio, así que escribe 12.90, no 12,90 ni 12.90 €. La moneda va en priceCurrency como código ISO 4217, por ejemplo EUR o PLN. La disponibilidad es un valor de schema.org, como InStock u OutOfStock.

Valoraciones y reseñas

Un AggregateRating necesita ratingValue y al menos uno de ratingCount o reviewCount. Dentro de un producto no hace falta itemReviewed. Si omites bestRating y worstRating, Google supone una escala de 1 a 5. Si tu tienda usa otra escala, por ejemplo de 1 a 10, indícala.

Precio, disponibilidad y mantenerlos al día

• Marca solo lo que los visitantes pueden ver. Google escribe que los datos estructurados deben representar fielmente el contenido de la página.
• Cambia el marcado cuando cambien el precio o las existencias. Un buen sistema de tienda lo hace automáticamente; un bloque escrito a mano, no.
• Pon priceValidUntil solo si el precio termina de verdad. Según Google, una fecha pasada puede impedir que se muestre el fragmento de producto.
• Usa una moneda por dirección. Google pide una URL distinta para cada moneda.
• Describe el envío y las devoluciones una sola vez para toda la tienda. Google recomienda una política de devoluciones y una política de envío globales en el marcado Organization.

Errores típicos

• El precio está escrito con coma, con símbolo de moneda o como 0 en una página en la que se vende el producto.
• priceCurrency contiene € o $ en lugar de un código como EUR o USD.
• Falta la imagen, aunque las fichas de comerciante la exigen.
• Una página de tienda usa AggregateOffer. Las fichas de comerciante exigen un Offer, porque el comerciante tiene que ser el vendedor.
• El nombre o el precio del marcado no coinciden con la página, a menudo después de un cambio de precio.
• Dos bloques describen el mismo producto con valores distintos, por ejemplo uno del tema y otro de un plugin.

Cómo comprobar tu marcado

Google menciona la prueba de resultados enriquecidos y la herramienta de inspección de URLs, que detectan la mayoría de los errores técnicos. Algunos problemas siguen siendo invisibles para estas pruebas, por ejemplo una valoración que no está en la página. Google también puede aplicar una acción manual por datos estructurados que incumplen sus reglas. Entonces la página deja de poder optar a resultados enriquecidos y se ignoran los datos estructurados.

Trabajar con Do4U

La herramienta Comprobación de datos estructurados lee una página desde su dirección, o el HTML o el bloque JSON-LD que pegues. Lee todos los bloques JSON-LD, también @graph y los elementos anidados, así como microdatos y RDFa. El código encuentra errores de sintaxis con línea y columna, tipos desconocidos o mal escritos y las propiedades que Google exige o recomienda para fragmentos de producto, fichas de comerciante, ofertas y valoraciones. Comprueba la forma de precios, monedas, fechas y valoraciones y avisa cuando un nombre o un precio del marcado no aparece en el texto visible. Recibes un árbol de los elementos con errores, advertencias y la fuente de cada regla. La página se lee tal como la entrega el servidor, sin JavaScript. No se usa IA, y la comprobación es gratuita, con un límite diario.

Do4U encuentra indicios; tú revisas y decides. Si aparece un resultado enriquecido lo decide Google, y solo tú sabes si un precio, unas existencias o una valoración son correctos.