Datos estructurados de la organización (Organization)

Panel de conocimiento del comercio en los resultados de la Búsqueda de Google
Panel de conocimiento del comercio en los resultados de la Búsqueda de Google

Agregar datos estructurados de la organización a tu página principal puede ayudar a Google a comprender mejor los detalles administrativos de tu organización y desambiguarla en los resultados de la búsqueda. Algunas propiedades se usan en segundo plano para distinguir tu organización de otras (como iso6523 y naics), y otras pueden influir en los elementos visuales de los resultados de la Búsqueda (como qué logo se muestra en los resultados de la Búsqueda y en el panel de conocimiento). Si eres comerciante, puedes ampliar la información de tu panel de conocimiento del comercio y perfil de marca, como la política de devoluciones, la dirección y la información de contacto. No hay propiedades obligatorias, sin embargo, te recomendamos que agregues tantas propiedades como sean relevantes para tu organización.

Cómo añadir datos estructurados

Los datos estructurados son un formato estandarizado con el que se puede proporcionar información sobre una página y clasificar su contenido. Consulta cómo funcionan los datos estructurados si aún no te has familiarizado con ellos.

A continuación se explica a grandes rasgos cómo crear, probar y publicar datos estructurados.

  1. Añade el mayor número posible de propiedades recomendadas que se apliquen a tu página web. No hay propiedades obligatorias. Añade las propiedades que se apliquen a tu contenido. Consulta más información sobre dónde insertar datos estructurados en una página en función del formato que estés utilizando.
  2. Sigue las directrices.
  3. Valida tu código con la prueba de resultados enriquecidos y corrige los errores críticos. Te recomendamos que también corrijas los problemas no críticos que puedan marcarse en la herramienta, ya que pueden ayudar a mejorar la calidad de los datos estructurados (sin embargo, esto no es necesario para que se muestren los resultados enriquecidos).
  4. Crea varias páginas que incluyan tus datos estructurados y comprueba cómo las ve Google con la herramienta de inspección de URLs. Asegúrate de que Google pueda acceder a tu página y de que no esté bloqueada por un archivo robots.txt, por la etiqueta noindex ni por requisitos de inicio de sesión. Si la página se ve bien, puedes solicitar que Google vuelva a rastrear tus URLs.
  5. Para que Google siempre tenga la versión actualizada de tus páginas, te recomendamos que envíes un sitemap. Puedes automatizar este envío con la API Sitemap de Search Console.

Ejemplos

Organization

Aquí hay un ejemplo de información sobre la organización en código JSON-LD.


<html>
  <head>
    <title>About Us</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Organization",
      "image": "https://www.example.com/example_image.jpg",
      "url": "https://www.example.com",
      "sameAs": ["https://example.net/profile/example1234", "https://example.org/example1234"],
      "logo": "https://www.example.com/images/logo.png",
      "name": "Example Corporation",
      "description": "The example corporation is well-known for producing high-quality widgets",
      "email": "contact@example.com",
      "telephone": "+47-99-999-9999",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "Rue Improbable 99",
        "addressLocality": "Paris",
        "addressCountry": "FR",
        "addressRegion": "Ile-de-France",
        "postalCode": "75001"
      },
      "vatID": "FR12345678901",
      "iso6523Code": "0199:724500PMK2A2M1SQQ228"
    }
    </script>
  </head>
  <body>
  </body>
</html>

OnlineStore con política de devoluciones (subtipo de ejemplo de Organization)

Este es un ejemplo de información de la tienda en línea en código JSON-LD.

<html>
  <head>
    <title>About Us</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "OnlineStore",
      "name": "Example Online Store",
      "url": "https://www.example.com",
      "sameAs": ["https://example.net/profile/example12", "https://example.org/@example34"],
      "logo": "https://www.example.com/assets/images/logo.png",
      "contactPoint": {
        "contactType": "Customer Service",
        "email": "support@example.com",
        "telephone": "+47-99-999-9900"
      },
      "vatID": "FR12345678901",
      "iso6523Code": "0199:724500PMK2A2M1SQQ228",
      "hasMerchantReturnPolicy": {
        "@type": "MerchantReturnPolicy",
        "applicableCountry": ["FR", "CH"],
        "returnPolicyCountry": "FR",
        "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
        "merchantReturnDays": 60,
        "returnMethod": "https://schema.org/ReturnByMail",
        "returnFees": "https://schema.org/FreeReturn",
        "refundType": "https://schema.org/FullRefund"
      }
      ... // Other Organization-level properties
    }
    </script>
  </head>
  <body>
  </body>
</html>

Lineamientos

Debes seguir estos lineamientos para habilitar los datos estructurados y que estos sean aptos para mostrarse en los resultados de la Búsqueda de Google.

Lineamientos técnicos

Te recomendamos que coloques esta información en tu página principal o en una sola página que describa a tu organización, por ejemplo, la página Acerca de nosotros. No es necesario que la incluyas en todas las páginas de tu sitio.

Recomendamos usar el subtipo de schema.org más específico de Organization que coincida con tu organización. Por ejemplo, si tienes un sitio de comercio electrónico, te sugerimos usar el subtipo OnlineStore en lugar de OnlineBusiness. Si tu sitio es sobre una empresa local, por ejemplo, un restaurante o una tienda física, te recomendamos que proporciones tus detalles administrativos con el subtipo más específico de LocalBusiness y seguir los campos obligatorios y los recomendados para las empresas locales, además de los campos recomendados en esta guía.

Definiciones de tipos de datos estructurados

Google reconoce las siguientes propiedades de una Organization. Para ayudar a Google a comprender mejor tu página web, incluye tantas propiedades recomendadas que se apliquen a ella como sea posible. No hay propiedades obligatorias, puedes agregar todas aquellas que se aplican a tu organización.

Propiedades recomendadas
address

PostalAddress

La dirección (física o de correo) de tu organización, si corresponde. Incluye todas las propiedades que correspondan a tu país. Cuantas más propiedades indiques, mayor será la calidad del resultado para los usuarios. Puedes proporcionar varias direcciones si tienes una ubicación en varias ciudades, estados o países. Por ejemplo:

"address": [{
  "@type": "PostalAddress",
  "streetAddress": "999 W Example St Suite 99 Unit 9",
  "addressLocality": "New York",
  "addressRegion": "NY",
  "postalCode": "10019",
  "addressCountry": "US"
},{
  "streetAddress": "999 Rue due exemple",
  "addressLocality": "Paris",
  "postalCode": "75001",
  "addressCountry": "FR"
}]
address.addressCountry

Text

Indica el país de tu dirección postal con el código de país ISO 3166-1 alpha-2 de dos letras.

address.addressLocality

Text

La ciudad de tu dirección postal.

address.addressRegion

Text

Región de su dirección postal, si corresponde. Por ejemplo, un estado.

address.postalCode

Text

El código postal de tu dirección.

address.streetAddress

Text

La dirección completa de tu dirección postal.

alternateName

Text

Otro nombre común que recibe tu organización, si corresponde.

contactPoint

ContactPoint

La mejor manera en que un usuario se puede comunicar con tu empresa, si corresponde. Incluye todos los métodos de asistencia disponibles para los usuarios según las prácticas recomendadas de Google. Por ejemplo:

"contactPoint": {
  "@type": "ContactPoint",
  "telephone": "+9-999-999-9999",
  "email": "contact@example.com"
}
contactPoint.email

Text

La dirección de correo electrónico para contactarse con tu empresa, si corresponde. Si usas un tipo LocalBusiness, especifica una dirección de correo electrónico principal a nivel de LocalBusiness antes de usar contactPoint para especificar varias formas de comunicarte con tu organización.

contactPoint.telephone

Text

Número de teléfono para comunicarse con tu empresa, si corresponde. Asegúrate de incluir el código de país y de área. Si usas un tipo LocalBusiness, especifica un número de teléfono principal en el nivel LocalBusiness antes de usar contactPoint para especificar varias formas de comunicarse con tu organización.

description

Text

Una descripción detallada de tu organización, si corresponde.

duns

Text

El número DUNS de Dun & Bradstreet para identificar tu Organization, si corresponde. Te recomendamos que uses el campo iso6523Code con el prefijo 0060: en su lugar.

email

Text

La dirección de correo electrónico para contactarse con tu empresa, si corresponde.

foundingDate

Date

Es la fecha en la que se fundó tu Organization en el formato de fecha ISO 8601, si corresponde.

globalLocationNumber

Text

El número de ubicación global de GS1 que identifica la ubicación de tu Organization, si corresponde.

hasMerchantReturnPolicy

MerchantReturnPolicy

La política de devoluciones que usa tu Organization, si corresponde. Si agregas esta propiedad, asegúrate de incluir también los campos obligatorios y recomendados para MerchantReturnPolicy.

iso6523Code

Text

El identificador ISO 6523 de tu organización, si corresponde. La primera parte de un identificador ISO 6523 es un ICD (Designador de Código Internacional) que define qué esquema de identificación se usa. La segunda parte es el identificador real. Recomendamos separar el ICD y el identificador con dos puntos (U+003A). Entre los valores de ICD comunes, se incluyen los siguientes:

  • 0060: Sistema Universal de Numeración (DUNS) de Datos de Dun & Bradstreet
  • 0088: Número de ubicación global de GS1 (GLN)
  • 0199: Identificador de entidad legal (LEI)
legalName

Text

Es el nombre legal registrado de tu Organization, si corresponde y es diferente de la propiedad de name.

leiCode

Text

El identificador de tu Organization, como se define en ISO 17442, si corresponde. Te recomendamos que uses el campo iso6523Code con el prefijo 0199: en su lugar.

logo

URL o ImageObject

Un logotipo que represente a tu organización, si corresponde. Agregar esta propiedad puede ayudar a Google a comprender mejor qué logotipo quieres mostrar, por ejemplo, en los resultados de la búsqueda y los paneles de conocimiento.

Lineamientos sobre las imágenes:

  • La imagen debe tener una dimensión mínima de 112 x 112 px.
  • La URL de la imagen se debe poder indexar y rastrear.
  • El formato de archivo de imagen debe ser compatible con Google Imágenes.
  • Asegúrate de que la imagen se vea como quieres que se vea sobre un fondo completamente blanco (por ejemplo, si el logotipo es principalmente blanco o gris, puede no verse como quieres cuando se muestre en un fondo blanco).

Si usas el tipo ImageObject, asegúrate de que tenga una propiedad contentUrl o url válida que siga los mismos lineamientos que un tipo URL.

naics

Text

El código del Sistema de Clasificación de Industrias de América del Norte (NAICS) para tu Organization, si corresponde.

name

Text

El nombre de tu organización. Usa los mismos valores de name y alternateName que usas para el nombre del sitio.

numberOfEmployees

QuantitativeValue

Indica la cantidad de empleados de tu Organization, si corresponde.

Ejemplo con una cantidad específica de empleados:

"numberOfEmployees": {
  "@type": "QuantitativeValue",
  "value": 2056
}

Ejemplo con la cantidad de empleados en un rango:

"numberOfEmployees": {
  "@type": "QuantitativeValue",
  "minValue": 100,
  "maxValue": 999
}
sameAs

URL

La URL de una página en otro sitio web con información adicional sobre tu organización, si corresponde. Por ejemplo, una URL a la página de perfil de tu organización en una red social o un sitio de opiniones. Puedes proporcionar varias URLs sameAs.

taxID

Text

El ID fiscal asociado con tu Organization, si corresponde. Asegúrate de que taxID coincida con el país que proporcionaste en el campo address.

telephone

Text

Es el número de teléfono de la empresa destinado a ser la forma de contacto principal para los clientes, si corresponde. Asegúrate de incluir el código de país y de área.

url

URL

Es la URL del sitio web de tu organización, si corresponde. Esto ayuda a que Google pueda identificar tu organización de manera única.

vatID

Text

El código de IVA (Impuesto sobre el valor agregado) asociado con tu Organization, si corresponde a tu país y empresa. Este es un indicador de confianza importante para los usuarios (por ejemplo, pueden buscar tu empresa en registros públicos de IVA).

MerchantReturnPolicy

Usa las siguientes propiedades para describir las políticas de devoluciones generales para todo tu Organization, si corresponde a tu empresa. Si tienes políticas específicas para productos individuales, usa el marcado de la ficha del comercio.

Propiedades obligatorias (elige la opción que mejor se adapte a tu caso de uso)
Opción A
applicableCountry

Text

Es el código de país al que se aplica la política de devoluciones mediante el formato de código de país de dos letras ISO 3166-1 alpha-2. Puedes especificar hasta 50 países.

returnPolicyCategory

MerchantReturnEnumeration

Es el tipo de política de devoluciones. Usa uno de los siguientes valores:

  • https://schema.org/MerchantReturnFiniteReturnWindow: Hay una cantidad determinada de días para devolver un producto.
  • https://schema.org/MerchantReturnNotPermitted: No se permiten las devoluciones.
  • https://schema.org/MerchantReturnUnlimitedWindow: Puedes devolver un producto de forma ilimitada.

Si usas MerchantReturnFiniteReturnWindow, se requiere la propiedad merchantReturnDays.

returnPolicyCountry

Text

Es el país al que se debe enviar el producto para las devoluciones. Este país puede ser diferente del país al que se envió el producto originalmente. Es el formato de código de país ISO 3166-1 alpha-2. Puedes especificar hasta 50 países.

Opción B
Propiedades recomendadas
customerRemorseReturnFees

ReturnFeesEnumeration

Es un tipo específico de tarifa de devoluciones si el producto se devuelve debido al arrepentimiento del cliente. Consulta returnFees para ver los valores posibles.

customerRemorseReturnLabelSource

ReturnLabelSourceEnumeration

Es el método mediante el cual el consumidor obtiene una etiqueta de envío para devolver un producto. Consulta returnLabelSource para ver los valores posibles.

customerRemorseReturnShippingFeesAmount

MonetaryAmount

Es el costo de envío para la devolución de un producto por arrepentimiento del cliente. Esta propiedad solo es obligatoria si hay una tarifa de envío distinta de cero que el consumidor debe pagar para devolver un producto. Para obtener más información, consulta returnShippingFeesAmount.

itemCondition

OfferItemCondition

Son las condiciones aceptables de un artículo que se puede devolver. Puedes proporcionar varias condiciones que se acepten. Usa los siguientes valores:

  • https://schema.org/DamagedCondition: Se aceptan artículos dañados.
  • https://schema.org/NewCondition: Se aceptan artículos nuevos.
  • https://schema.org/RefurbishedCondition: Se aceptan artículos reacondicionados.
  • https://schema.org/UsedCondition: Se aceptan artículos usados.
itemDefectReturnFees

ReturnFeesEnumeration

Es un tipo específico de tarifa de devolución para productos con defectos. Consulta returnFees para ver los valores posibles.

itemDefectReturnLabelSource

ReturnLabelSourceEnumeration

Es el método por el cual el consumidor puede obtener una etiqueta de devolución de envío para un producto. Consulta returnLabelSource para ver los valores posibles.

itemDefectReturnShippingFeesAmount

MonetaryAmount

Es el costo de envío de la devolución de un producto debido a defectos. Esta propiedad solo es obligatoria si hay una tarifa de envío distinta de cero que el consumidor debe pagar para devolver un producto. Para obtener más información, consulta returnShippingFeesAmount.

merchantReturnDays

Integer o Date o DateTime

Es la cantidad de días posteriores a la fecha de entrega en que se puede devolver un producto. Esta propiedad solo es obligatoria si configuras returnPolicyCategory en MerchantReturnFiniteReturnWindow.

refundType

RefundType

Es el tipo de reembolsos disponibles para el consumidor cuando devuelve un producto.

  • https://schema.org/ExchangeRefund: El artículo se puede cambiar por el mismo producto.
  • https://schema.org/FullRefund: El artículo se puede reembolsar por el importe monetario total.
  • https://schema.org/StoreCreditRefund: El artículo se puede reembolsar como crédito de la tienda.
returnFees

ReturnFeesEnumeration

Es el tipo predeterminado de tarifa de devolución. Usa uno de los siguientes valores admitidos:

  • https://schema.org/FreeReturn: No se aplican cargos al consumidor por devolver el producto. Si se usa, no incluyas la propiedad returnShippingFeesAmount.
  • https://schema.org/ReturnFeesCustomerResponsibility: El consumidor debe encargarse de pagar el envío por devolución. Si se usa, no incluyas la propiedad returnShippingFeesAmount.
  • https://schema.org/ReturnShippingFees: El comercio cobra una tarifa de envío al consumidor por devolver el producto. Especifica la tarifa de envío (que no sea cero) con la propiedad returnShippingFeesAmount.
returnLabelSource

ReturnLabelSourceEnumeration

Es el método por el cual el consumidor puede obtener una etiqueta de devolución de envío para un producto. Usa uno de los siguientes valores:

  • https://schema.org/ReturnLabelCustomerResponsibility: Es responsabilidad del consumidor crear una etiqueta de devolución.
  • https://schema.org/ReturnLabelDownloadAndPrint: El cliente debe descargar e imprimir la etiqueta de devolución.
  • https://schema.org/ReturnLabelInBox: La etiqueta de devolución se incluyó cuando se envió el producto originalmente.
returnMethod

ReturnMethodEnumeration

Es el tipo de método de devolución que se ofrece. Solo se recomienda si returnPolicyCategory es diferente de MerchantReturnNotPermitted. Usa uno o más de los siguientes valores:

  • https://schema.org/ReturnAtKiosk: El artículo se puede devolver en un kiosco.
  • https://schema.org/ReturnByMail: El artículo se puede devolver por correo.
  • https://schema.org/ReturnInStore: El artículo se puede devolver en la tienda.
returnPolicySeasonalOverride

MerchantReturnPolicySeasonalOverride

Una excepción de temporada de una política de devoluciones para especificar políticas de devoluciones para eventos especiales, como festividades. Por ejemplo, tu categoría de política de devoluciones habitual está configurada en MerchantReturnPolicyUnlimitedWindow, pero el período de devolución debe limitarse durante las ventas del Black Friday:

"returnPolicySeasonalOverride": {
  "@type": "MerchantReturnPolicySeasonalOverride",
  "startDate": "2024-11-29",
  "endDate": "2024-12-06",
  "merchantReturnDays": 10,
  "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow"
}

A continuación, se explica cómo especificar varias excepciones de temporada. En este ejemplo, la política de devoluciones habitual es ilimitada, pero se limita durante los siguientes dos períodos:

"returnPolicySeasonalOverride": [{
  "@type": "MerchantReturnPolicySeasonalOverride",
  "startDate": "2024-11-29",
  "endDate": "2024-12-06",
  "merchantReturnDays": 10,
  "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow"
},
{
  "@type": "MerchantReturnPolicySeasonalOverride",
  "startDate": "2024-12-26",
  "endDate": "2025-01-06",
  "merchantReturnDays": 10,
  "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow"
}]
returnPolicySeasonalOverride.endDate

Date o DateTime

Es la fecha de finalización de la excepción de temporada.

returnPolicySeasonalOverride.merchantReturnDays

Integer o Date o DateTime

Es la cantidad de días posteriores a la fecha de entrega en que se puede devolver un producto. Esta propiedad solo es obligatoria si configuras returnPolicyCategory en MerchantReturnFiniteReturnWindow.

returnPolicySeasonalOverride.returnPolicyCategory

MerchantReturnEnumeration

Es el tipo de política de devoluciones. Usa uno de los siguientes valores:

  • https://schema.org/MerchantReturnFiniteReturnWindow: Hay una cantidad determinada de días para devolver un producto.
  • https://schema.org/MerchantReturnNotPermitted: No se permiten las devoluciones.
  • https://schema.org/MerchantReturnUnlimitedWindow: Puedes devolver un producto de forma ilimitada.

Si usas MerchantReturnFiniteReturnWindow, se requiere la propiedad merchantReturnDays.

returnPolicySeasonalOverride.startDate

Date o DateTime

Indica la fecha de inicio de la excepción de temporada.

returnShippingFeesAmount

MonetaryAmount

Indica el costo de envío de la devolución de un producto. Esta propiedad solo es necesaria si hay una tarifa de envío distinta de cero que el consumidor debe pagar al comercio para devolver un producto. En este caso, returnFees debe establecerse en https://schema.org/ReturnShippingFees). Si la devolución es gratuita, returnFees debe establecerse en https://schema.org/FreeReturn. Si es necesario que el consumidor tenga que encargarse de pagar el costo de envío por devolución, returnFees debe establecerse en https://schema.org/ReturnFeesCustomerResponsibility.

Enfoque alternativo para configurar las opciones de devolución con Google

Las políticas de devoluciones de los minoristas pueden complicarse y cambiar con frecuencia. Si tienes problemas para crear detalles de envío y mantenerlos actualizados con lenguaje de marcado y tienes una cuenta de Google Merchant Center, te recomendamos que consultes cómo configurar las políticas de devoluciones en la Ayuda de Google Merchant Center. También puedes configurar políticas de devoluciones en Search Console, a nivel de la cuenta que se agregan automáticamente a Merchant Center.

Combinación de varios parámetros de configuración de envíos y devoluciones

Si combinas varios parámetros de configuración de envíos y devoluciones, ten en cuenta puedes anular la información de la política según el orden de prioridad. Por ejemplo, si proporcionas tanto lenguaje de marcado a nivel de la organización en tu sitio y políticas de devoluciones en Search Console, Google solo usará la información proporcionada en Search Console. Si envías un feed de productos en Merchant Center y estableces las opciones de envío en Search Console, la información del feed de Merchent Center anula la configuración de Search Console.

Esto es lo que tiene prioridad para la información de la política de envíos y devoluciones (ordenada según su intensidad, con feeds que son los más eficaces):

Solución de problemas

Si tienes problemas para implementar o depurar datos estructurados, te brindamos algunos recursos que podrían resultarte útiles.