🗂️ Datos estructurados
Introduce una URL para extraer todos los bloques JSON-LD de la página, con @type y cargas formateadas. También detecta microdata / RDFa.
📖 Qué te dice este diagnóstico
Los datos estructurados anotan una página en un formato que las máquinas pueden leer. Este diagnóstico extrae JSON-LD, Microdata y RDFa, y comprueba que la sintaxis se analiza y que los tipos son schema.org válidos. Google recortó mucho la elegibilidad para resultados enriquecidos desde 2023: FAQ y HowTo ya no aparecen en sitios corrientes. Aun así merece la pena: hoy sirven para los resultados enriquecidos de Article, Product y BreadcrumbList, y para dar a la búsqueda con IA y a los modelos de lenguaje un asidero fiable.
| Elemento | Qué significa | Cómo corregirlo |
|---|---|---|
| Error de sintaxis JSON | Si no se puede analizar, se ignora el bloque entero. La causa casi siempre es una comilla sin escapar procedente de una variable de plantilla, o una coma final. | Deja de montar la cadena a mano y que lo haga el codificador JSON del lenguaje: json_encode() en PHP, |json_encode|raw en Twig. Sólo con eso desaparece toda esa familia de fallos en la que un apóstrofo en el título rompe el bloque. |
| Falta una propiedad obligatoria | Cada tipo tiene campos obligatorios: headline e image para Article, name y offers para Product, itemListElement para BreadcrumbList. | Añade lo que falte, pero nunca inventes datos que la página no tiene. Declarar un aggregateRating sin reseñas reales se considera spam y puede acarrear una acción manual. Si no puedes rellenarlo con honestidad, es más seguro no declarar ese tipo. |
| Discrepancia con el contenido visible | Lo que pongas en el marcado tiene que estar también visible para el usuario en la página. Marcar contenido que no existe es una infracción de las directrices. | La única solución fiable es generar el marcado y el HTML visible desde una sola fuente. Si ambos salen del mismo bucle, ya no pueden separarse cuando alguien actualice uno. |
| BreadcrumbList | Alimenta la ruta de navegación en los resultados y es uno de los pocos tipos que sigue mostrándose de forma fiable. Comunica la estructura lógica del sitio, no la jerarquía de la URL. | Pon una URL absoluta en item. En un sitio multilingüe, cuidado con no perder el prefijo de idioma: escribir /blog/ apunta a la URL sin prefijo y obliga a una redirección. |
Pasar este diagnóstico no significa que vaya a aparecer un resultado enriquecido. Que se muestre lo decide Google y depende de la categoría, la reputación del sitio y la consulta. Usa la prueba de resultados enriquecidos de Google para ver qué mostraría de verdad.