Pruebas de Datos Estructurados: Cómo Depurar Errores de Schema en las Herramientas de Google

Las Herramientas No Son Infalibles

Por mi experiencia, un JSON-LD perfectamente válido pasa el Rich Results Test y luego no produce rich results durante semanas. ¿Por qué? Porque la herramienta de pruebas valida la sintaxis, no el contexto.

Así es como se depura el schema de verdad.

Paso 1: Empieza con el Validador de Schema.org

Antes de tocar las herramientas de Google, pega tu JSON-LD en el validador de Schema.org. Detecta problemas estructurales que las herramientas de Google pasan por alto. Concretamente: jerarquías de @type faltantes, anidamiento de propiedades incorrecto y desajustes de enum.

El mes pasado encontré a un cliente usando @type: "Product" con brand como un string en lugar de brand: { @type: "Brand", name: "..." }. El Rich Results Test pasó. El validador de Schema.org lo marcó de inmediato.

Paso 2: El Rich Results Test Es para Vista Previa, No para Validación

La propia documentación de Google dice que esta herramienta "muestra qué rich results se pueden generar". Fíjate en la palabra "pueden". No significa que se generarán.

El truco: Si tu página pasa el Rich Results Test pero no ves rich results en el informe de Rendimiento de Search Console después de dos semanas, comprueba:

• ¿Está la página realmente indexada? (usa la URL Inspection Tool)
• ¿Necesita la página dateModified para el Article schema? (el 85% de los Article rich results omitidos que hemos depurado carecen de fecha)
• ¿Está la página compitiendo con otro tipo de rich result? (breadcrumb + product pueden entrar en conflicto)

Paso 3: El Informe de Rich Results de Search Console

Esta es tu fuente de verdad. Los mensajes de error son crípticos, pero se corresponden directamente con la especificación de schema.org.

Advertencias comunes decodificadas:

• "Missing field 'image'" en Article schema: tu objeto image está mal formado. Necesita @type: "ImageObject" con url, no solo una URL como string.
• "Missing field 'price'" en Product schema: comprueba si hay espacios en blanco en la propiedad de precio de offers. Un espacio antes de "99.99" hará que falle. Sí, de verdad.
• "Invalid value for 'review'": a tu reviewRating le falta bestRating. Si estableces una calificación de 5, Google necesita conocer la escala.

Paso 4: La URL Inspection Tool

Es la única herramienta que te muestra lo que Google realmente analizó. Ejecuta la URL, haz clic en "Ver página rastreada" y mira la pestaña de datos estructurados. Si difiere de lo que ves en el Rich Results Test, Googlebot no ha vuelto a rastrear. Solicita la indexación y espera 24 horas.

Paso 5: Schema Markup Validator (Extensión de Chrome)

Para depurar rápidamente mientras navegas, la extensión Schema Markup Validator resalta todo el schema de una página. La uso para verificar el breadcrumb schema en todas las páginas de un sitio en minutos.

Una cosa más: Si usas JSON-LD a través de un tag manager, a veces Google no ejecuta los scripts de GTM antes de analizar el schema. Incrústalo inline. Siempre.