Conceptos básicos de datos estructurados JSON-LD

Los datos estructurados son JSON legible por máquinas que describe el tema de una página: un artículo, una receta, un producto o un evento. Los motores de búsqueda los utilizan para mostrar resultados enriquecidos (valoraciones con estrellas, tarjetas de recetas y rutas de navegación) en lugar de simples enlaces azules.

El formato preferido por Google es JSON-LD: un único bloque <script type="application/ld+json"> en la cabecera o el cuerpo que contiene uno o más objetos de schema.org. Está desacoplado del HTML visible, por lo que añadirlo o actualizarlo no requiere reescribir la plantilla.

Cada objeto JSON-LD necesita @context (casi siempre "https://schema.org") y @type (la clase de schema.org: Article, Recipe, Product, FAQPage). @context indica a los analizadores de qué vocabulario proceden los nombres de las propiedades.

Para Article, proporcione headline, image (una URL o un array), datePublished, dateModified, author (un objeto Person u Organization) y publisher (Organization con logo). Estos son los campos mínimos que Google necesita para considerar la página para su carrusel de noticias destacadas.

Las páginas de productos declaran @type Product con name, image, description, brand, sku y un subobjeto offers que contiene price, priceCurrency y availability. Combinado con aggregateRating, permite que Google muestre valoraciones con estrellas y fragmentos de precios directamente en el resultado de búsqueda.

BreadcrumbList describe la jerarquía de navegación. Cada itemListElement es un ListItem con position, name e item (la URL). Cuando está presente, Google sustituye la línea de URL del fragmento por la ruta de navegación etiquetada, lo que consigue más clics.

Los esquemas FAQPage y HowTo antes desbloqueaban widgets de resultados enriquecidos en las SERP. Desde entonces, Google ha restringido los resultados enriquecidos de FAQ a unas pocas categorías de sitios (gov, edu), pero el marcado sigue siendo valioso para los asistentes de voz y otros consumidores; consérvelo en las páginas de preguntas frecuentes reales.

Google penaliza el marcado que no coincide con lo que ven los usuarios. No declare una valoración de 5 estrellas que no aparezca en la página ni indique un precio de 9,99 $ que el usuario no pueda ver. Los datos estructurados deben describir con precisión el contenido renderizado.

La herramienta Rich Results Test de Google (search.google.com/test/rich-results) analiza cualquier URL o código pegado, muestra los tipos de esquema detectados y advierte sobre las propiedades obligatorias que faltan. Ejecútela antes de desplegar cualquier cambio en los datos estructurados.

Puede declarar varios bloques JSON-LD en la misma página (por ejemplo, Article + BreadcrumbList + Organization) o combinarlos en una única matriz @graph. Ambas formas son válidas; elija la que resulte más fácil de convertir en plantilla en su canalización de compilación.

JSON-LD se encuentra en una etiqueta script separada del contenido visible. Para actualizarlo, vuelva a generar el bloque JSON; nunca inyecte datos estructurados únicamente mediante JavaScript del lado del cliente, porque Googlebot no siempre ejecuta JavaScript de forma fiable antes de indexar.

¿Qué dos propiedades de nivel superior debe incluir todo objeto JSON-LD para que los datos estructurados sean válidos?

JSON-LD declara datos estructurados en un único bloque de script application/ld+json, donde @context y @type identifican cada objeto. Los esquemas habituales (Article, Product, BreadcrumbList) habilitan resultados de búsqueda enriquecidos cuando el marcado refleja con precisión la página visible. Valide los datos con Rich Results Test antes de desplegarlos.