La primera vez que agregué marcado de esquema a un sitio cliente, escribí a mano un Product block en el encabezado del tema, lo implementó y siguió sintiéndose inteligente. Dos semanas después, la prueba de resultados enriquecidos me dijo que al objeto de oferta le faltaba @type, el precio era un número en el que Google quería una cadena, y una coma perdida había invalidado silenciosamente todo el bloque. Google lo había estado ignorando todo el tiempo. Eso es de lo que nadie te advierte con datos estructurados: JSON-LD no válido no genera ningún error ni pone nada rojo. Simplemente no hace nada en silencio y meses después descubres que el rico resultado con el que contabas nunca aparece.
El vocabulario en sí se publica en esquema.org, y para lo que Google realmente mostrará un resultado enriquecido es una lista más estrecha documentación de datos estructurada.
Construyo herramientas para ganarme la vida (Toolz.dev, el complemento WP Adminify, una pila de aplicaciones Laravel y React) y los datos estructurados son una de esas tareas que hago con suficiente frecuencia como para resentirme haciéndolo a mano y rara vez lo suficiente como para olvidar la propiedad exacta. nombres cada vez. Entonces construí el Generador de marcado de esquema eliminar los dos modos de falla que más me costaron: anidamiento incorrecto e invalidez silenciosa. Esta guía analiza qué hace realmente el marcado de esquema, cómo lo construye el generador y los errores específicos que impiden que el marcado de apariencia válida obtenga resultados enriquecidos.
TL;Dr: El marcado de esquemas son datos estructurados (que utilizan el vocabulario de Schema.org) que indican a los motores de búsqueda exactamente de qué se trata una página, lo que la hace elegible para obtener resultados enriquecidos como acordeones de preguntas frecuentes, precios de productos y migajas de pan. Google recomienda el formato JSON-LD, un formato autónomo
<script type="application/ld+json">bloquear. El generador crea JSON-LD válido para nueve tipos comunes, anida subobjetos comoPostalAddressyOffercorrectamente, faltan indicadores en los campos requeridos y recomendados, y se ejecuta al 100% en su navegador para que no se cargue nada de lo que escribe.
¿qué es el marcado de esquema y por qué es importante?
El marcado de esquemas es una forma estandarizada de describir el contenido de una página para que las máquinas puedan entenderlo, no solo representarlo. El vocabulario proviene de schema.org, un proyecto compartido respaldado por Google, Microsoft, Yahoo y Yandex. Cuando marca una página como Article, le estás diciendo a un motor de búsqueda " este es un artículo de noticias o blog, aquí está su titular, aquí está quién lo escribió, aquí está cuando se publicó." Esa descripción estructurada es lo que hace que una página sea elegible para obtener resultados enriquecidos: listados mejorados con calificaciones de estrellas, precios, menús desplegables de preguntas frecuentes, fechas de eventos y senderos de migas de pan que ocupan más espacio y ganan más clics que un simple enlace azul.
La razón por la que importa ha cambiado en los últimos años. Solía tratarse únicamente de resultados enriquecidos en Google. Ahora, los datos estructurados también alimentan los motores de respuestas de IA y las descripciones generales de IA de Google & #39. Cuando ChatGPT, Perplexity o Gemini intentan resumir lo que hace su negocio o qué producto coincide con una consulta, los datos estructurados limpios son una de las señales que les ayuda a acertar con los hechos. Una página que se declara claramente como Organization con un nombre, logotipo y perfiles sociales es mucho más fácil razonar para cualquier máquina que una que deja todo implícito en el HTML.
El problema es que los datos estructurados son implacables. Es código, y el código tiene que ser exactamente correcto. Una propiedad escrita datePublish en vez de datePublished simplemente se ignora. Un Offer sin un @type no se reconoce como oferta. Y como ninguno de estos errores rompe la página visible, se esconden en producción indefinidamente. Ese es el vacío que llena un generador: no escribir los conceptos para usted, sino lograr la sintaxis y la estructura adecuadas cada vez.
¿por qué JSON-LD en lugar de Microdata o RDFa?
Hay tres formas de agregar datos de Schema.org a una página y es útil comprender por qué el generador produce solo una de ellas.
Microdatos y RDFa entrelaza los datos estructurados directamente en tu HTML visible usando atributos adicionales itemscope, itemprop, propertyși altceva. Tu <div> para una revisión de producto, obtiene atributos que etiquetan cada pieza de texto visible. Esto funciona, pero acopla estrechamente su marcado con la estructura de su página. Cambie el diseño y corre el riesgo de romper el esquema. También es detallado y difícil de leer.
JSON-LD adopta el enfoque opuesto. Pone todos los datos estructurados en un único sistema autónomo <script type="application/ld+json"> bloque, normalmente en el <head>, completamente separado del HTML visible. Google ha recomendado JSON-LD durante años precisamente debido a esta separación: puedes agregarlo, actualizarlo o inyectarlo a través de un administrador de etiquetas sin tocar tus plantillas. Es el formato que enseña todo tutorial de esquema moderno y es lo que genera el generador.
| formato | Donde vive | Facilidad de mantenimiento | Postura de Google & 39 |
|---|---|---|---|
| JSON-LD | Soltero <script> bloquear, separado de HTML |
Más fácil: edite un bloque | recomendado |
| Microdatos | Atributos dentro del HTML visible | Más difícil, acoplado al diseño | sostenido |
| RDFa | Atributos dentro del HTML visible | Más difícil, acoplado al diseño | sostenido |
Si está trabajando en WordPress, JSON-LD es también lo que inyectan la mayoría de los complementos de SEO y lo que acompaña limpiamente una herramienta como WP Adminify. Debido a que es un bloque independiente, puede generarlo aquí y pegarlo en un campo HTML personalizado, un administrador de etiquetas o un diseño de Laravel Blade sin ninguna gimnasia específica del marco.
¿cómo uso el generador de marcado de esquemas?
El flujo de trabajo se basa en elegir un tipo y completar un formulario breve, con una vista previa en vivo para que vea el ensamblaje JSON-LD mientras escribe.
Paso 1: elija un tipo de esquema. Elija entre Organización, Negocios locales, Sitio web, Artículo, Producto, Página de preguntas frecuentes, Lista Breadcrumb, Persona o Evento. El formulario se cambia inmediatamente a los campos que el tipo necesita. Estos nueve cubren la inmensa mayoría de lo que los sitios pequeños y medianos realmente necesitan marcado.
Paso 2: rellena los campos. Los campos obligatorios están marcados con un asterisco. A medida que escribe, la herramienta ensambla el JSON-LD y elimina cualquier campo que deje en blanco, para que nunca termine vacío "" propiedades que contaminan la salida. Para tipos basados en direcciones como LocalBusiness y Event, los campos de direcciones individuales se pliegan en una escritura adecuada PostalAddress objeto automáticamente.
Paso 3: observe la validación. El generador señala dos tipos de problemas. Los errores (faltan campos obligatorios, URL con formato incorrecto) bloquean un resultado limpio y se muestran en rojo. Advertencias (faltan campos recomendados por Google como image investigaciones operacionales datePublished, o una plantilla de URL de búsqueda a la que le falta su marcador de posición) se muestran en ámbar: el marcado sigue siendo válido, pero está dejando un potencial de resultados enriquecido en la tabla.
Paso 4: copie e implemente. Cambia entre el completo <script> etiqueta (listo para pegar en tu <head>) y el JSON sin formato (para administradores de etiquetas y campos CMS). La salida del script escapa de los caracteres que de otro modo dejarían extraviarse </script> en tus datos rompe la página. Luego valide la página en vivo con Google's Rich Results Test.
Debido a que todo se ejecuta en el lado del cliente, es seguro usarlo en páginas de productos no publicadas, entornos de preparación y trabajo del cliente según NDA. Sus precios, detalles de eventos y URL internas nunca salen del navegador, la misma postura de privacidad detrás de cada herramienta del sitio, sobre la cual escribí en el Guía de privacidad de datos.
¿Qué tipos de esquemas debo utilizar realmente?
No todas las páginas necesitan marcado, y acumular tipos que no puedes admitir es peor que ninguno. Así es como pienso sobre los nueve que cubre el generador.
Organización pertenece a su página de inicio o a una página de información: es el esquema que alimenta los paneles de conocimiento y ayuda a Google a conectar su marca a sus perfiles sociales a través de sameAs. Sitio web se empareja con él y puede declarar un cuadro de búsqueda de Sitelinks a través de a SearchAction, permitiendo a los usuarios buscar en su sitio directamente desde la página de resultados. Negocio Local es esencial si tiene una ubicación física: transmite su dirección, teléfono, rango de precios y horario de apertura, y respalda los resultados del mapa y del paquete local.
Artículo (con el que emite el generador Article escriba, igualmente válido para publicaciones de blog) marca el contenido editorial con un titular, autor, editor y fechas de publicación. Producto describe algo a la venta, con un anidado Offer precio de transporte, moneda y disponibilidad: esto es lo que impulsa los fragmentos de precio y disponibilidad. Evento cubre cualquier cosa que tenga fecha y lugar, desde una conferencia hasta un seminario web.
Página de preguntas frecuentes y Lista de migas de pan son estructurales en lugar de un "cosa." FAQPage marca el contenido de preguntas y respuestas; Tenga en cuenta que Google redujo los resultados ricos en preguntas frecuentes a sitios gubernamentales y de salud autorizados, pero el marcado aún ayuda a otros motores de búsqueda y motores de respuestas de IA a analizar su sesión de preguntas y respuestas;A. BreadcrumbList produce el rastro de navegación que se muestra debajo de su título en los resultados, lo que mejora la forma en que se lee su estructura de URL. Persona marca a un individuo (un autor, fundador o figura pública) y es útil para biografías de autores y señales EEAT.
La regla que sigo: marque de qué se trata realmente la página y solo reclame propiedades que reflejen el contenido realmente visible en la página. Las pautas de Google & #39;s son explícitas en el sentido de que los datos estructurados deben describir contenido real y visible; marcar un precio que no aparece en la página es una violación, no un atajo.
¿cómo mantiene válido el generador el marcado?
El valor está en los detalles que son fáciles de equivocar a mano. Algunos que vale la pena destacar.
Anidamiento correcto con @type. En JSON-LD, los objetos anidados no son subobjetos simples: cada uno necesita los suyos propios @type. Una dirección es a PostalAddress, una oferta es una Offer, un artículo's autor es un Person, su editor es un Organization cuyo logo es un ImageObject. El generador construye cada uno de estos con el tipo correcto para que el analizador los reconozca en lugar de tratarlos como blobs anónimos.
Poda vacía. Dejar un campo en blanco debería eliminar la propiedad, no emitir "telephone": "". Las cadenas vacías y las matrices vacías se eliminan de la salida automáticamente, por lo que lo que copia siempre está limpio.
Escapar a prueba de guiones. El personaje más peligroso en JSON-LD en línea es un < - específicamente la secuencia </script> aparecer dentro de sus datos (por ejemplo, en una descripción), lo que terminaría el bloque de script antes de tiempo y rompería la página. El generador se escapa <, >y & en la salida de etiquetas de script que utiliza escapes unicode, que es exactamente lo que hacen los propios ejemplos de Google & #39.
Conciencia requerida y recomendada. Cada tipo tiene su propia lista de lo que Google requiere versus recomienda. El artículo realmente quiere un image y datePublished; El producto quiere un price; El evento necesita un startDate. La herramienta distingue los requisitos estrictos (que trata como errores) de las recomendaciones (advertencias), por lo que usted sabe la diferencia entre "esto no funcionará" y "esto podría funcionar mejor."
Si está ensamblando un flujo de trabajo técnico más amplio, el generador de esquemas se ubica naturalmente junto con las otras utilidades de SEO: el Generador de metaetique para su título, descripción y etiquetas Open Graph, y el Generador de mapas del sitio XML para enviar sus URL. Juntos cubren la mayor parte de la superficie técnica de SEO de la página y los agrupé por ese motivo en el descripción general del kit de herramientas para desarrolladores web.
¿Cómo pruebo e implemente datos estructurados?
Generar JSON-LD válido es la mitad del trabajo; la otra mitad confirma que Google lo lee como lo desea.
Comience con Google & #39;s Prueba de resultados ricos, que recupera una URL o acepta código pegado e informa qué tipos de resultados enriquecidos califica la página, además de cualquier error o advertencia. Luego ejecute el mismo marcado a través de Validador de marcado de esquemas en validator.schema.org, que verifica la conformidad con el vocabulario de schema.org en sí en lugar de los requisitos de resultados enriquecidos de Google '. Los dos captan cosas diferentes: la prueba de resultados enriquecidos le indica si califica para una función específica de Google, mientras que el validador le indica si el marcado es estructuralmente sólido.org.
Una vez que la página está activa, la mejora informa Consola de búsqueda de Google realice un seguimiento del rendimiento a lo largo del tiempo y marque los errores que Google encuentra durante el rastreo. Aquí es donde detecta problemas que solo aparecen a escala: una plantilla que emite posiciones duplicadas de migas de pan, por ejemplo, o una fuente de producto que ocasionalmente omite un campo requerido.
Para la implementación, pegue el <script> bloquear en el <head> de la página específica que describe. No coloque un solo bloque de Producto en una plantilla global que se ejecute en cada página; el marcado debe coincidir con la página en la que vive. En un CMS, utilice cualquier campo HTML o SEO personalizado que le proporcione la plataforma. En un administrador de etiquetas, use una etiqueta HTML personalizada y copie el JSON. En una aplicación React o Laravel, inyecte el bloque del lado del servidor para que los rastreadores lo vean en el HTML inicial en lugar de después de la hidratación.
Errores comunes que todavía veo
Un puñado de errores aparecen una y otra vez, y cada uno de ellos produce un marcado que se ve bien pero no hace nada.
El clásico es marcar contenido invisible - agregar una calificación de revisión o un precio que no aparece en ninguna parte de la página. Google prohíbe explícitamente esto y puede emitir una acción manual para ello. El segundo es el tipo incorrecto en un objeto anidado, normalmente falta @type en una dirección u oferta. El tercero es combinando tipos similares, ca usând Product marcado en una página de listado de categorías en lugar de en un solo producto. Y el cuarto, mi némesis personal, lo es un error de sintaxis al editar manualmente - una coma final o una cita sin escape que invalida todo el bloque.
Cada uno de estos es el motivo por el que un generador se gana su sustento. No puede saber si su precio es visible en la página, es decir, en usted, pero nunca emitirá una coma final, ya que falta @type, o una propiedad vacía. Eso por sí solo elimina la mayoría de las formas en que los datos estructurados fallan silenciosamente. Para obtener más información sobre los flujos de trabajo de los desarrolladores en torno a este tipo de herramientas, el Guía de herramientas de codificación es una buena lectura complementaria.
Preguntas frecuentes
¿Qué es el marcado de esquema?
El marcado de esquema son datos estructurados que describen una página 's contenido para motores de búsqueda que utilizan el vocabulario compartido de Schema.org. Agregarlo puede hacer que una página sea elegible para obtener resultados enriquecidos, como acordeones de preguntas frecuentes, precios de productos, estrellas de revisión y migas de pan. JSON-LD, el formato que produce esta herramienta, es la sintaxis que recomienda Google porque vive en una única etiqueta de script separada de su HTML visible.
¿Cuál es la diferencia entre JSON-LD, Microdata y RDFA?
Las tres son formas de agregar datos estructurados de Schema.org a una página. Los microdatos y RDFA son atributos entretejidos en su HTML visible, mientras que JSON-LD es un bloque de JSON autónomo en una etiqueta de script. Google recomienda JSON-LD porque es más fácil agregar, actualizar y mantener separado del marcado de página. Esta herramienta genera JSON-LD por esa razón.
¿Dónde pongo el json-ld generado?
Pegue el completo <script type="application/ld+json"> etiqueta en el <head> de la página que describe, o en cualquier lugar del <body> - Google lo lee en cualquier ubicación. Si utiliza Google Tag Manager, copie el JSON y agréguelo a través de una etiqueta HTML personalizada. Coloque siempre el marcado en la misma página cuyo contenido describe, no en una plantilla que lo aplique en todas partes.
¿Agregar marcado de esquema garantiza resultados enriquecidos?
prohibido Los datos estructurados válidos hacen que una página sea elegible para resultados enriquecidos, pero Google decide si los muestra en función de la calidad, la relevancia y sus propias pautas. Su marcado también debe reflejar el contenido que es realmente visible en la página. Piense en el esquema como un requisito para resultados enriquecidos, no como un interruptor que los enciende.
¿Cómo pruebo mis datos estructurados?
Ejecute el marcado generado a través de Google's Rich Results Test y Schema Markup Validator (schema.org's validator). Analice su JSON-LD e informe los campos obligatorios faltantes o los errores de sintaxis. Una vez que la página está activa, los informes de mejoras de la Consola de búsqueda de Google rastrean cómo se desempeñan sus datos estructurados a lo largo del tiempo.
¿Qué campos se requieren para cada tipo?
Los requisitos varían según el tipo: el artículo necesita un título, el producto necesita un nombre, el evento necesita un nombre y la fecha de inicio, y la página de preguntas de FAQ necesita al menos una pregunta y una respuesta. Esta herramienta marca los campos obligatorios y bloquea la salida hasta que se llenan, al mismo tiempo que advierte sobre los campos recomendados que mejoran sus posibilidades de obtener un resultado rico.
¿Puedo generar esquema de preguntas frecuentes para mi página?
Sí. Elija el tipo de página de preguntas frecuentes, agregue cada pregunta con su respuesta y la herramienta crea automáticamente la matriz de objetos de preguntas y respuestas de forma automática. Tenga en cuenta que Google Now muestra resultados enriquecidos con preguntas frecuentes principalmente para sitios de gobierno y salud autorizados, pero el marcado sigue siendo válido y útil para otros motores de búsqueda y motores de respuesta de IA.
¿Mis datos se mantienen privados?
Sí. El JSON-LD se ensambla completamente en su navegador con JavaScript simple. Nada de lo que escriba, incluidos precios no publicados, detalles de eventos o URL privadas, se transmite, registra o almacena, y el generador continúa funcionando sin conexión de red una vez cargado.
