La implementación del esquema JSON-LD implica incrustar una etiqueta de script específica en el encabezado o cuerpo HTML de su página web para proporcionar datos estructurados sobre su contenido. Google utiliza esta información para comprender los temas de la página y mostrar resultados enriquecidos, como calificaciones de estrellas, detalles de eventos o precios de productos, directamente en los fragmentos de búsqueda.
¿Por qué se prefiere JSON-LD sobre otros formatos?
Google recomienda JSON-LD como el formato estándar para datos estructurados porque es fácil de mantener y no interrumpe la representación visual de su HTML. A diferencia de Microdata, que requiere anotar etiquetas HTML existentes, JSON-LD es un bloque de código autónomo que permanece separado de la estructura del contenido.
Debido a que los datos se almacenan en un objeto JSON, son menos propensos a corromperse cuando los diseñadores actualizan el diseño visual de una página. Esta separación garantiza que la capa técnica de SEO permanezca intacta incluso durante ciclos significativos de diseño front-end, proporcionando una base confiable para la indexación de los motores de búsqueda.
La mayoría de los sistemas de gestión de contenido modernos ahora incluyen complementos nativos que generan estos scripts. Sin embargo, el desarrollo personalizado permite un mayor control sobre los atributos específicos asignados, asegurando que cada pieza de información proporcionada al rastreador sea precisa y relevante para la experiencia del usuario.
El uso de un formato independiente también reduce la probabilidad de conflictos de sintaxis dentro del documento HTML. Cuando el código está aislado, la depuración se convierte en un proceso más rápido, ya que los desarrolladores pueden identificar problemas en el bloque de script sin tener que escanear miles de líneas de marcado.
- Se inserta fácilmente en el encabezado o cuerpo sin anidamiento HTML complejo.
- Permite un código más limpio y fácil de mantener en sitios web grandes.
- La documentación de Google favorece explícitamente JSON-LD para la mayoría de los tipos de datos estructurados.
Cómo estructurar su código JSON-LD
Para crear un JSON-LD válido, debe utilizar el vocabulario de schema.org y seguir los requisitos de sintaxis definidos por Google. Cada bloque de esquema comienza con una etiqueta de script donde el tipo se define como application/ld+json. Dentro de este bloque, usted define el tipo de objeto y sus propiedades utilizando pares clave-valor claros.
Al elaborar estos bloques, priorice la precisión. Si está marcando una página de producto, las propiedades ‘name’, ‘image’, ‘offers’ y ‘aggregateRating’ deben reflejar la información exacta que ve un humano. Proporcionar datos contradictorios entre el contenido visible de la página y los datos estructurados puede dar lugar a acciones manuales o a la exclusión de sus resultados enriquecidos.
Considere la estructura jerárquica de sus objetos JSON. Por ejemplo, un objeto Producto puede contener un objeto Oferta anidado para especificar el precio y la disponibilidad. Mantener este flujo lógico garantiza que el rastreador pueda asignar correctamente la relación entre el elemento y sus atributos.
Compruebe siempre los campos obligatorios. La documentación de búsqueda de Google enumera las propiedades obligatorias para cada tipo de esquema. Omitirlas podría resultar en que los datos sean ignorados durante el proceso de indexación, incluso si la sintaxis en sí es técnicamente correcta.
Requisitos técnicos esenciales para su script
- Incluya la propiedad @context apuntando a https://schema.org.
- Especifique el @type para identificar el contenido, como Producto, Artículo o Evento.
- Asegúrese de que todos los campos obligatorios para su tipo de contenido específico estén presentes.
- Valide su código utilizando la herramienta oficial de prueba de resultados enriquecidos antes de la implementación.
Los datos estructurados son un formato estandarizado para proporcionar información sobre una página y clasificar el contenido de la misma.
Google Search Central
Cómo aplica Alien Road la implementación del esquema JSON-LD
En Alien Road, seguimos un proceso riguroso para garantizar que nuestros clientes capturen todos los beneficios de visibilidad de los datos estructurados. Comenzamos auditando las plantillas de página del cliente para identificar qué tipos de contenido, como rutas de navegación, precios de productos o secciones de preguntas frecuentes, se pueden marcar para ayudar a Google a crear fragmentos enriquecidos.
Para un compromiso típico, realizamos una auditoría de referencia de los errores de esquema existentes a través de Google Search Console. Luego, creamos plantillas JSON-LD personalizadas que inyectan variables dinámicas desde el CMS, asegurando que el precio de un producto o la fecha de un artículo siempre se actualicen automáticamente. Esto evita que los datos obsoletos causen discrepancias en la interfaz de búsqueda.
También priorizamos la implementación de esquemas a nivel de organización para nuestros socios. Esto proporciona a los motores de búsqueda detalles clave como el logotipo de la empresa, enlaces a perfiles sociales e información de contacto, lo que ayuda a establecer la autoridad de la marca en el panel de conocimiento.
Después de la implementación inicial, realizamos un ciclo de validación utilizando entornos de prueba. Al observar cómo el motor de búsqueda interpreta estas nuevas estructuras de datos antes de que se publiquen, evitamos posibles problemas que podrían afectar el rendimiento del sitio o el tráfico de búsqueda orgánica.
¿Cuáles son los errores comunes que se deben evitar?
Muchos sitios web no logran generar resultados enriquecidos porque incluyen información oculta en su esquema que no existe en la página. Google requiere que los datos estructurados representen con precisión el contenido visible para el usuario. Si muestra un precio en su JSON-LD, ese mismo precio debe ser claramente visible para una persona que navega por la página.
Otro error común es aplicar un esquema que no es relevante para el contenido de la página. Por ejemplo, usar el esquema ‘Review’ en una página que no contiene reseñas reales de usuarios es una violación de las directrices de calidad. Asegúrese siempre de que los datos que proporciona sean relevantes, específicos y estén directamente respaldados por el contenido de la URL.
Compruebe si hay definiciones de esquema duplicadas. Si una página tiene tanto código manual como un complemento automatizado que proporciona el mismo marcado, la redundancia resultante puede confundir al analizador. Consolide estos scripts para asegurarse de que solo exista una fuente autorizada de datos estructurados por página.
Evite codificar valores estáticos si el contenido de la página cambia a menudo. El uso de marcadores de posición dinámicos garantiza que los datos estructurados permanezcan sincronizados con la visualización del front-end, lo cual es crítico para los sitios de comercio electrónico donde los niveles de existencias o los precios fluctúan diariamente.
Errores técnicos comunes
Los errores de sintaxis, como comas faltantes o llaves sin cerrar, pueden invalidar todo el bloque. Además, el uso de un tipo de esquema obsoleto puede llevar a que se ignoren los datos. Compruebe siempre la documentación oficial para asegurarse de que las propiedades de esquema elegidas sigan siendo recomendadas para el contenido que está marcando.
¿Se puede probar y monitorear el rendimiento del esquema?
Sí, las pruebas son un paso obligatorio en el proceso de implementación. Antes de enviar el código a un servidor en vivo, utilice la prueba de resultados enriquecidos de Google para verificar que su JSON-LD sea sintácticamente correcto y que Google pueda analizarlo. Esta herramienta proporciona una vista previa de cómo podrían aparecer los datos en los resultados de búsqueda, ayudándole a confirmar que la estructura cumple con sus expectativas.
Después de la implementación, monitoree la sección ‘Mejoras’ en Google Search Console. Este informe rastrea si Google procesó con éxito sus datos estructurados o si encontró problemas. Si nota una disminución en las impresiones de resultados enriquecidos, investigue el informe para ver si ciertas plantillas se han vuelto inválidas o si las directrices de esquema han cambiado.
Las auditorías periódicas son esenciales. A medida que su sitio crece, pueden surgir nuevos tipos de páginas que requieran sus propios bloques de esquema. Una verificación mensual garantiza que su marcado permanezca alineado con los requisitos más recientes y que no se haya acumulado deuda técnica.
Por dónde empezar esta semana: Ejecute una página de muestra a través de la prueba de resultados enriquecidos de Google para ver si su marcado actual es válido. Si falta, cree un bloque de esquema Organization básico para su página de inicio y pruebe la implementación en un entorno de ensayo para confirmar que el resultado sea legible por los bots de búsqueda.