Qué es JSON-LD: definición y guía completa SEO
JSON-LD (JavaScript Object Notation for Linked Data): Formato de datos estructurados recomendado por Google para implementar vocabulario schema.org en las páginas web. Se inserta como un bloque de script en el HTML sin modificar el markup visible, lo que facilita su implementación, mantenimiento y validación.
Por qué Google recomienda JSON-LD sobre Microdata y RDFa
JSON-LD tiene ventajas técnicas claras frente a los otros formatos. Al ser un bloque de script independiente del HTML, puede añadirse o modificarse sin tocar el markup visible de la página, lo que simplifica el trabajo de los equipos de desarrollo. Se puede inyectar mediante Google Tag Manager sin acceso al código, lo que lo hace accesible para equipos de marketing. Es más fácil de mantener en sitios dinámicos porque los valores del JSON se pueden generar programáticamente desde la base de datos. Google, Bing y Yandex soportan JSON-LD. Microdata y RDFa siguen siendo válidos, pero Google los ha relegado a una posición secundaria en su documentación.
Estructura básica del JSON-LD y propiedades esenciales
Todo JSON-LD para schema se enmarca en una etiqueta script de tipo ‘application/ld+json’. La estructura mínima incluye ‘@context’: ‘https://schema.org’, ‘@type’: (el tipo de schema, como Article, Product, FAQPage) y las propiedades específicas de ese tipo. Las propiedades más universales son name, description, url e image. Algunos tipos tienen propiedades obligatorias para activar rich results: Article requiere headline, author, datePublished e image. Product requiere name y offers (con price y priceCurrency). FAQPage requiere mainEntity con una lista de Question y acceptedAnswer. La documentación de schema.org detalla las propiedades de cada tipo.
Los schema types más útiles en JSON-LD para SEO
Los tipos con mayor impacto en CTR son FAQPage (genera desplegables de preguntas directamente en el resultado), Product con Review y AggregateRating (muestra estrellas y precio), Recipe (imagen, tiempo y valoración), Event (fecha, lugar y precio), Article con breadcrumb, y LocalBusiness con contacto y horario. En ecommerce, Product es el type más importante: permite mostrar precio, disponibilidad y valoraciones en la SERP. Para webs de servicio local, LocalBusiness y Organization ayudan al Knowledge Panel. Para contenido editorial, Article y BlogPosting con autor verificado refuerzan las señales E-E-A-T.
Validación y depuración del JSON-LD
La herramienta principal es el Rich Results Test de Google (search.google.com/test/rich-results): permite pegar la URL o el código directamente y muestra qué rich results son elegibles, qué propiedades están bien implementadas y qué errores o advertencias hay. El validador de schema.org (validator.schema.org) comprueba la sintaxis del vocabulario con más detalle. En GSC, el informe de ‘Mejoras’ muestra todos los tipos de schema detectados en el sitio con sus errores y la cobertura de URLs. Es común que el validador no muestre errores pero Google aún no active el rich result: suele deberse a que la URL no tiene suficientes señales de autoridad o el contenido no cumple las directrices editoriales de Google para ese tipo de rich result.
Preguntas frecuentes
¿Puedo tener varios bloques JSON-LD en la misma página?
Sí. Una página puede tener múltiples bloques script de JSON-LD con tipos diferentes: por ejemplo, un Article con su breadcrumb en un bloque, y un FAQPage en otro. Google los procesa todos. Lo que no es recomendable es duplicar el mismo tipo en varios bloques con información contradictoria.
¿El JSON-LD añadido vía Google Tag Manager es procesado correctamente por Google?
Sí, Google ha confirmado que procesa el JSON-LD inyectado mediante JavaScript, incluido GTM. Sin embargo, dado que Googlebot puede tardar en renderizar el JavaScript, existe un retraso entre la publicación y la detección del schema. Para sitios donde la velocidad de indexación del schema es importante, inyectarlo directamente en el HTML del servidor es más fiable que vía GTM.