Ponga datos estructurados Service en cada página que explique un servicio. Incluya name, description, url, serviceType, provider y areaServed, y dé al servicio su propio @id construido a partir de la URL de la página. Apunte provider a su nodo de negocio mediante su @id.

Agregue un objeto offers solo cuando la propia página muestre un precio, una estimación o un rango de precios. Si el trabajo requiere un presupuesto, indíquelo en el texto visible y deje Offer.price fuera.

Puntos clave

  1. Un nodo por página de servicioColoque Service en cada página que explique un servicio, con name, description, url, serviceType, provider y areaServed, más un @id a partir de la URL.
  2. Enlace al proveedorDescriba el negocio una vez en un nodo LocalBusiness, y luego apunte provider a él mediante @id desde cada página de servicio.
  3. Añada ofertas con cuidadoAñada offers solo cuando la página muestre un precio, un presupuesto o un rango. Si el trabajo requiere cotización, indíquelo en el texto visible y omita Offer.price.
  4. Conozca la función de GoogleLa galería de Google no tiene una función Service específica, pero documenta LocalBusiness y exige name y address para ella. Service es vocabulario válido de schema.org.
  5. Revise en cuatro puntosRevise primero la sintaxis JSON, luego el vocabulario de schema.org, después la Prueba de resultados enriquecidos para LocalBusiness. Inspeccione la URL publicada, porque un rastreador puede recibir otra salida.
  6. Actualice junto con la páginaActualice el texto visible y el nodo Service en el mismo cambio si cambian un precio, la cobertura o el nombre del servicio, luego inspeccione la URL publicada.

Escriba un nodo Service para cada página de servicio

Un nodo Service describe una sola cosa que un negocio hace por sus clientes: la inspección de un calefactor, un paquete de contabilidad, la tala de un árbol. Schema.org define Service como un servicio que proporciona una organización, y sus ejemplos incluyen entrega, impresión, consultoría, limpieza y reparación. La regla práctica que se deriva es una página y un nodo. Si dos servicios son lo bastante distintos como para tener precios, alcances o zonas de cobertura diferentes, cada uno necesita su propia página y su propio nodo Service.

Cada valor del nodo debe coincidir con algo que un visitante pueda leer en esa página. Las directrices generales de datos estructurados de Google indican que los datos estructurados deben representar el contenido visible de la página, y que el contenido engañoso u oculto puede impedir que una página muestre un resultado enriquecido. Las Directrices para webmasters de Bing hacen una afirmación similar y agregan que el marcado engañoso puede ser ignorado.

Un hombre sentado en la compuerta trasera de un camión de jardinería escribe en una computadora portátil sobre una mesa plegable, con un portapapeles a su lado
Figura 1. Una página y un nodo Service para cada servicio que ofrece el negocio.

Dé al nodo un @id estable. El patrón más sencillo es la URL canónica de la página seguida de #service, por ejemplo https://example.com/services/furnace-inspection/#service. Ese identificador permite que la propiedad provider, un Offer y cualquier otro nodo se refieran al servicio sin repetir sus datos, y se mantiene igual mientras no cambie la URL de la página. Si alguna vez traslada la página, actualice el @id junto con ella.

Mantenga separados los nodos Service y LocalBusiness

Los dos nodos cumplen funciones distintas. El nodo LocalBusiness indica quién es el negocio, dónde está y cómo comunicarse con él. El nodo Service indica qué ofrece una página y dónde está disponible. El nodo Service remite al negocio mediante provider, así que usted describe el negocio una sola vez y lo referencia desde cada página de servicio.

Los dos nodos también siguen reglas distintas. El nodo Service usa el vocabulario de schema.org. La galería de datos estructurados de Google incluye funciones como Local business (negocio local), Organization, Product, Event, Article, Breadcrumb y Review snippet (fragmentos de reseñas), y no tiene una función específica para Service. El nodo LocalBusiness es distinto: Google lo documenta como función, indica que name y address son obligatorios para ella, y recomienda url, telephone y otros campos. Lea la documentación de LocalBusiness de Google para ver la lista completa, y la guía de schema de negocio local para profundizar en el nodo del negocio.

Una tarjeta de edificio arriba conectada a una fila de cuatro tarjetas de servicio, con un panel de marcado entre corchetes que las refleja
Figura 2. El nodo del negocio se describe una sola vez y cada nodo de servicio apunta de vuelta a él.

Use el subtipo de LocalBusiness más específico que corresponda al negocio; Google lo recomienda. Google también indica que el marcado puede ir en cualquier página, aunque una página con información sobre el negocio suele ser el lugar más adecuado. Si su organización no está ligada a una ubicación, la guía de schema de organización explica el nodo Organization al que haría referencia desde provider.

Qué campos van en cada nodo

Pase el cursor o toque una fila para resaltarla. En pantallas pequeñas la tabla se desplaza de lado.

PropiedadNodoEstado
name y addressLocalBusinessObligatorio para esta función de Google
url y telephoneLocalBusinessRecomendado para esta función de Google
name, description, urlServiceVocabulario de schema.org; no hay función de Service documentada en Google
serviceType, provider, areaServedServiceVocabulario de schema.org; mantener coincidencia con el texto visible
offersServiceOpcional; añadir solo cuando la página muestre un precio real
price y priceCurrencyOfferOpcional; solo cuando sea visible y exacto

Las propiedades que necesita un nodo Service

Seis propiedades transmiten la mayor parte del significado, y cada una debe respaldarse con texto visible.

El name es el servicio tal como lo nombra el título principal de la página. La description es una o dos oraciones que coinciden con la apertura de la propia página, no una lista de palabras clave. La url es la dirección canónica de la página. El serviceType es la categoría del trabajo, en palabras corrientes como «inspección de calefactor residencial». El provider es la organización o persona que realiza el servicio, normalmente una referencia a su nodo de negocio. El areaServed es el lugar donde se presta el servicio.

Para areaServed, schema.org acepta texto, un lugar, un área administrativa o una forma geográfica. Use la forma que corresponda a lo que dice la página. Si la página dice «atiende a Example County», un AdministrativeArea llamado Example County es una buena correspondencia. Si enumera tres localidades, use un arreglo con una entrada City para cada una. No incluya localidades que el negocio no atiende solo porque una lista más larga parezca más impresionante.

La séptima propiedad, offers, describe una oferta real para prestar el servicio. Es opcional, y solo corresponde cuando la página muestra un precio, una estimación o un rango. Una propiedad de calificación o de reseñas también es opcional, y solo corresponde cuando la página muestra reseñas genuinas y atribuibles; la guía de schema de reseñas explica las reglas para ellas.

Un ejemplo completo con un negocio y un servicio

El siguiente ejemplo es un único bloque JSON-LD con dos nodos dentro de un @graph. Todos los nombres, direcciones, números y precios son ficticios y usan example.com. Se muestra aquí como código de enseñanza; nunca pegue los valores de ejemplo en una página publicada, y nunca agregue nodos de demostración al JSON-LD de su propio sitio.

json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "LocalBusiness",
      "@id": "https://example.com/#business",
      "name": "Example Home Repair",
      "url": "https://example.com/",
      "telephone": "+1-555-010-0147",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "100 Example Avenue",
        "addressLocality": "Example City",
        "addressRegion": "IL",
        "postalCode": "60000",
        "addressCountry": "US"
      }
    },
    {
      "@type": "Service",
      "@id": "https://example.com/services/furnace-inspection/#service",
      "url": "https://example.com/services/furnace-inspection/",
      "name": "Inspección de calefactor residencial",
      "description": "Una inspección visual y de funcionamiento de un calefactor residencial para propietarios en Example County.",
      "serviceType": "Inspección de calefactor residencial",
      "provider": {
        "@id": "https://example.com/#business"
      },
      "areaServed": {
        "@type": "AdministrativeArea",
        "name": "Example County"
      },
      "offers": {
        "@type": "Offer",
        "url": "https://example.com/services/furnace-inspection/",
        "price": "180",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "itemOffered": {
          "@id": "https://example.com/services/furnace-inspection/#service"
        }
      }
    }
  ]
}

Reemplace cada valor con datos de su propia página. El @id del negocio debe ser una URL que usted controle, y ese mismo @id debe aparecer en la referencia de provider. El @id y la url del servicio deben coincidir con la página real del servicio. Los campos de address deben coincidir con la dirección que muestra su sitio, y price y priceCurrency deben coincidir con el precio que ve el visitante; si no coinciden, elimine todo el objeto offers.

Observe que Offer apunta de vuelta al servicio mediante itemOffered, con el mismo @id. Así la oferta queda vinculada al nodo correcto cuando el grafo crece. Para el patrón más amplio de conectar nodos mediante identificadores, la guía de graph en JSON-LD explica cómo construir un mapa de entidades entre páginas.

Para publicar esto en una página, envuelva el objeto en un elemento script. Todo lo que hay entre las etiquetas es exactamente el JSON de arriba.

html
<script type="application/ld+json">
{ "@context": "https://schema.org", "@graph": [ ... ] }
</script>

Cada página de servicio lleva su propio nodo Service. Cuando quiera que un sistema lea los datos del negocio junto con el servicio, incluya también el nodo LocalBusiness completo en el grafo de esa página. Una referencia provider sola solo nombra el identificador; es el nodo completo el que contiene la dirección y el número de teléfono.

Agregue la oferta solo cuando la página muestre un precio

Un Offer es una afirmación de que el servicio puede comprarse o solicitarse en condiciones indicadas. Eso significa que la página debe respaldarla. Incluya price y priceCurrency cuando la página muestre un precio en el que el visitante pueda confiar, como una tarifa fija por una inspección. También puede corresponder un rango publicado o un método de estimación bien explicado, siempre que la página lo muestre.

Deje el precio fuera cuando la página no muestre uno. Un precio inicial que la página no explica, una suposición o un número que no coincide con el texto visible no debe ir en el marcado. Cuando el trabajo requiere una inspección o un presupuesto a medida, describa ese proceso con palabras visibles, como «Damos el presupuesto tras una visita al lugar», y omita Offer.price. Un nodo de servicio sin oferta está completo y es válido.

La misma moderación se aplica a todo lo demás que la página no muestra. No agregue aggregateRating, review, ratingValue ni reviewCount a menos que aparezcan en la página reseñas reales y atribuibles. No invente cifras de clientes, credenciales, disponibilidad ni garantías. Y no cambie el nodo a Product para que un servicio parezca algo que se puede enviar; use Service para el servicio y Offer para las condiciones comerciales. El marcado de producto tiene sus propias reglas, explicadas en la guía de schema de producto.

Agregue el marcado a su plataforma

Empiece por revisar lo que su sitio ya genera. Muchos temas, plugins de SEO y constructores de sitios agregan automáticamente algún marcado de negocio o de página, y una segunda descripción del mismo servicio, en conflicto con la primera, no le sirve a nadie. Abra el código fuente de la página publicada, busque application/ld+json y anote qué tipos están presentes. Si ya existe un nodo Service o LocalBusiness, actualícelo en lugar de agregar otro.

Después, use la ruta de inserción que documenta su plataforma.

  • WordPress: use un tema hijo, un fragmento de código personalizado o un plugin cuya propia documentación indique que genera JSON-LD para el tipo de página que necesita. La guía de datos estructurados en WordPress explica esas rutas paso a paso.
  • Wix documenta una opción de marcado de datos estructurados que acepta JSON-LD manual por página, y también ofrece marcado predefinido para algunos tipos de página.
  • Webflow admite incrustaciones de código personalizado basadas en script. El código personalizado es una función avanzada y puede depender de su plan.
  • Squarespace documenta que genera automáticamente varios tipos de schema y describe una edición limitada de ellos en su ayuda sobre optimización para búsqueda. Revise lo que ya genera antes de planificar un marcado Service personalizado.
  • Shopify describe cómo funciona la estructura de temas. Confirme si su tema activo o una ubicación controlada de código personalizado puede agregar el JSON-LD sin duplicar el marcado existente.
  • Next.js documenta cómo renderizar JSON-LD en componentes de página o de diseño, y recomienda sanear la cadena serializada para que un carácter < no pueda salirse de la etiqueta script.

En un sitio hecho a mano o en un proyecto de Next.js, un componente pequeño por cada página de servicio mantiene sincronizados los datos y la página. El siguiente boceto construye el objeto a partir de los mismos valores que imprime la página, así el marcado no puede separarse del texto visible.

js
export default function ServiceJsonLd({ service }) {
  const data = {
    "@context": "https://schema.org",
    "@type": "Service",
    "@id": service.url + "#service",
    url: service.url,
    name: service.name,
    description: service.summary,
    serviceType: service.type,
    provider: { "@id": "https://example.com/#business" },
    areaServed: { "@type": "AdministrativeArea", name: service.area }
  };
  const json = JSON.stringify(data).replace(/</g, "\\u003c");
  return <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: json }} />;
}

Pase al componente los mismos campos que generan el titular, el resumen y el texto de la zona de cobertura de la página. Agregue el nodo LocalBusiness por separado, en las páginas donde corresponda. Si su sitio funciona en otra plataforma, como HubSpot, confirme el método de inserción vigente en la documentación de esa plataforma o con el administrador del sitio.

Pruebe el marcado en cuatro lugares

Cada comprobación responde una pregunta distinta, así que hágalas en este orden. Primero, confirme que la sintaxis JSON es válida: una coma o una comilla que falte romperá todo lo que venga después. El validador de Schema Nova informa los problemas de sintaxis y señala la línea.

Segundo, revise el vocabulario en el Schema Markup Validator, que comprueba los tipos y propiedades contra schema.org. Tercero, pase la página por la Prueba de resultados enriquecidos (Rich Results Test) de Google, que cubre la parte LocalBusiness. No espere que informe un resultado de Service, porque Google no documenta ninguno. Un resultado limpio de LocalBusiness le indica los requisitos de ese nodo, no la indexación ni la visualización.

Cuarto, revise la URL publicada, no solo el código que pegó. Lo que recibe un rastreador puede diferir de lo que usted escribió, por la caché, las URL canónicas, los controles de acceso o un segundo plugin que agrega su propio marcado. En Search Console, use la Inspección de URL (URL Inspection) sobre la página publicada. Si usa Bing Webmaster Tools, su Inspección de URL tiene una tarjeta «Markup» (marcado) que reconoce JSON-LD, y Yandex ofrece un validador de datos estructurados que comprueba Schema.org, Open Graph, microformatos, microdatos y RDFa.

Haga que el marcado Service sea legible para Bing y la búsqueda con IA

Bing indica que admite JSON-LD de schema.org y valida los datos anotados, así que el mismo bloque Service también sirve para Bing. DuckDuckGo indica que la mayoría de sus enlaces tradicionales se obtienen en gran medida de los resultados de Bing. Yandex indica que admite Schema.org y JSON-LD, pero no todos los tipos de Schema.org, así que un nodo Service válido puede no producir una visualización en Yandex.

Si quiere que la búsqueda de ChatGPT encuentre la página, permita OAI-SearchBot en sus reglas de robots; consulte la documentación de rastreadores de OpenAI. Ningún marcado promete un posicionamiento, un resultado enriquecido ni una cita. Así que, indique en el texto visible el nombre del servicio, el proveedor, la zona de cobertura, el precio y la URL de la página, mantenga estable esa URL y deje que un marcado preciso diga lo mismo. La guía sobre si la IA usa el marcado schema incluye la comparación completa.

Mantenga el marcado actualizado

El marcado queda desactualizado cuando cambia un servicio y la página no. Cada vez que edite un precio, agregue una localidad a la zona de cobertura, cambie el nombre de un servicio o retire una página, actualice el texto visible y el nodo en el mismo cambio. Después, inspeccione de nuevo la URL publicada.

Un resultado de prueba cubre un solo nivel: JSON válido, vocabulario válido de schema.org, una función documentada de Google como LocalBusiness, o una visualización real. Son preguntas separadas. Para crear el primer nodo sin escribir el código a mano, use el generador de schema de servicio y compare su resultado con su página antes de publicar. Si tiene varias ubicaciones, la guía de varias ubicaciones muestra cómo organizar los nodos de negocio.

Del texto visible al marcado publicado

  1. Preparar la páginaMuestre en texto visible el nombre del servicio, la descripción, la zona de cobertura y el precio (si lo hay).
  2. Crear el nodo ServiceAñada name, url, serviceType y un @id construido a partir de la URL de la página.
  3. Vincular el providerApunte provider al nodo del negocio mediante su @id y añada después areaServed.
  4. Añadir offers con cuidadoIncluya offers solo cuando en la página se vea un precio exacto.
  5. ValidarCompruebe por separado la sintaxis JSON, el vocabulario de schema.org y la parte LocalBusiness.
  6. Inspeccionar y mantenerInspeccione la URL publicada y vuelva a revisarla cuando cambien el servicio, el precio o la cobertura.

Preguntas frecuentes

¿Tiene Google un resultado enriquecido para Service?

La galería de datos estructurados de Google incluye funciones como Local business, Organization, Product, Event, Article, Breadcrumb y Review snippet, pero ninguna función dedicada a Service. Google también indica que cumplir los requisitos de una función documentada no garantiza que aparezca un resultado enriquecido. Un nodo Service puede seguir describiendo la página para los sistemas que leen schema.org.

¿Debe una página de servicio usar Service o Product?

Use Service para el trabajo que usted realiza y Offer para las condiciones en que se vende. Product describe bienes, y cambiar un servicio a marcado Product solo para que parezca un producto describe mal la página.

¿Qué va en provider?

La organización o persona que realiza el servicio. En un negocio con ubicación, referencie su nodo LocalBusiness con provider: {"@id": "..."}, usando el mismo @id que tiene el nodo del negocio.

¿Puedo agregar un precio cuando el servicio requiere un presupuesto?

Solo si la página muestra un precio real, una estimación o un rango. Cuando el precio depende de una visita al lugar, explíquelo en el texto visible y omita Offer.price. El nodo sigue siendo válido sin oferta.

¿Agregan las plataformas de sitios web marcado Service automáticamente?

Algunas plataformas agregan por su cuenta marcado de negocio, de página o de producto. Squarespace, por ejemplo, documenta varios tipos de schema que genera automáticamente. Abra el código fuente publicado y busque application/ld+json antes de agregar nada, para no publicar dos descripciones de un mismo servicio.

Revisión rápida

Elija una respuesta para ver comentarios. Nada se califica ni se guarda.

Pregunta 1 de 3

El JSON-LD de Service es válido, pero la Prueba de resultados enriquecidos de Google no muestra ninguna función de Service. ¿Qué significa eso?

Pregunta 2 de 3

Una página indica que el precio depende de una visita al lugar. ¿Qué debe hacer el nodo Service con el precio?

Pregunta 3 de 3

¿Qué afirmación mantiene separados tres significados distintos?

Términos usados en el marcado Service

Seleccione un término para ver su definición.

Service. El tipo de schema.org que describe un servicio.