Fundamentos de los datos estructurados para lograr citas precisas en la IA

Qué es JSON-LD

JSON-LD son datos estructurados que se insertan en una página web como un fragmento de JSON. Declara a los buscadores y a los sistemas de IA el tipo y las propiedades del contenido de la página. Es el formato que recomienda Google y se añade a la página como un solo bloque <script> sin modificar nada de lo que ven los visitantes.

Este es un ejemplo mínimo:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Comercial Ejemplo, S.L.",
  "url": "https://www.example.com"
}
</script>

Este código indica que la página representa a una organización llamada Comercial Ejemplo, S.L. cuyo sitio web oficial es example.com. El vocabulario proviene de schema.org, un estándar público que mantienen conjuntamente los principales buscadores.

Qué aporta a la búsqueda con IA: hechos legibles por máquinas

Los datos estructurados convierten el contenido que leen las personas en declaraciones de hechos que una máquina puede analizar. Los buscadores tradicionales los utilizan para generar resultados enriquecidos. En la búsqueda con IA, unas declaraciones de hechos claras reducen la probabilidad de que un modelo interprete mal su contenido o lo atribuya a otra empresa.

Sirva de ejemplo FAQPage. Cuando las preguntas y las respuestas se marcan como campos de datos explícitos, un motor de IA que las extraiga o las cite no tiene que adivinar qué frase es la pregunta y cuál es la respuesta. El nombre de la empresa, los precios de los productos y la jerarquía de las páginas se pueden declarar de la misma manera.

Una advertencia: los datos estructurados no son un atajo para mejorar el posicionamiento. Su valor está en la precisión: garantizar que lo que leen las máquinas coincide con lo que se quería decir.

Los cuatro tipos que las pymes de Hong Kong deberían añadir primero

Organization: declare quién es su empresa

Conviene incluirlo en la página de inicio para declarar el nombre de la empresa, el sitio web, el logotipo y los perfiles sociales oficiales.

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Comercial Ejemplo, S.L.",
  "url": "https://www.example.com",
  "logo": "https://www.example.com/logo.png",
  "sameAs": ["https://www.linkedin.com/company/example"]
}

Errores habituales: declarar nombres de empresa distintos en cada página o indicar el logotipo con una ruta relativa. Mantenga el nombre idéntico al del registro de la empresa y al de los perfiles sociales, y utilice siempre URLs completas que empiecen por https.

FAQPage: haga que sus preguntas y respuestas se puedan extraer directamente

Se incluye en las páginas que contienen preguntas y respuestas, con un objeto Question por cada pregunta.

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "¿Qué servicios ofrecen?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "Ofrecemos servicios de alojamiento web y registro de dominios, con oficina en Hong Kong."
    }
  }]
}

Error habitual: las preguntas y respuestas existen en el JSON-LD, pero no aparecen en ninguna parte visible de la página. Google exige de forma explícita que el marcado se corresponda con el contenido que pueden ver los visitantes. Un marcado que solo vive en el código se considera un incumplimiento de sus directrices.

Product o Service: indique con claridad qué vende

En las páginas de producto se utiliza Product junto con Offer. Las empresas de servicios pueden emplear Service en su lugar.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Plan de alojamiento web para empresas",
  "description": "Alojamiento web para pymes, con copias de seguridad diarias incluidas.",
  "offers": {
    "@type": "Offer",
    "price": "0",
    "priceCurrency": "HKD"
  }
}

Un precio de 0 significa gratuito; en los planes de pago hay que indicar el precio real. Errores habituales: omitir priceCurrency o dejar que el precio del marcado se desincronice del precio que muestra la página porque solo se actualizó uno de los dos.

BreadcrumbList: declare dónde se sitúa la página

Indica a las máquinas a qué nivel del sitio pertenece la página, lo que facilita que la IA y los buscadores entiendan su estructura.

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {"@type": "ListItem", "position": 1, "name": "Inicio", "item": "https://www.example.com/"},
    {"@type": "ListItem", "position": 2, "name": "Servicios", "item": "https://www.example.com/services/"},
    {"@type": "ListItem", "position": 3, "name": "Alojamiento web"}
  ]
}

Error habitual: numerar las posiciones saltándose valores o repitiéndolos. El último elemento es la página actual y puede omitir la URL de item, pero todos los demás niveles deben incluir una URL completa.

Validar con el Rich Results Test de Google

Escribir el marcado no garantiza que funcione, así que conviene validarlo antes y después de publicarlo. Abra el Rich Results Test de Google (search.google.com/test/rich-results) y pegue la URL o directamente el código. La herramienta muestra todos los tipos que detecta junto con los errores que encuentre.

Un detalle a tener en cuenta: esta herramienta solo informa de los tipos que pueden generar resultados enriquecidos en Google. Para comprobar si todo su marcado de schema.org es válido, conviene pasarlo también por el validador oficial de Schema.org (validator.schema.org).

Por último, abra el código fuente de la página en el sitio en producción y confirme que el JSON-LD se genera realmente. Muchas plantillas web lo muestran sin problemas en la vista previa del editor y luego eliminan la etiqueta script al publicar.

Preguntas frecuentes

Primero analice, después empiece a corregir

Ninguno de los cuatro tipos es difícil de escribir. Lo difícil es saber cuáles le faltan ahora mismo a su sitio web. El AEO Auditor gratuito de UDomain (ai.ud.hk/aeo-auditor) analiza su sitio y revisa los datos estructurados, la accesibilidad para los rastreadores de IA y otros aspectos de la visibilidad en la IA, y después enumera las carencias que conviene cubrir primero. Repase los resultados con los ejemplos de esta guía para que, la próxima vez que una IA cite su contenido, diga exactamente lo que usted quería decir.