Usa datos estructurados para la indexación avanzada de sitios web

Si la indexación avanzada de sitios web está habilitada en tu almacén de datos, puedes usar los siguientes tipos de datos estructurados para enriquecer tu indexación:

En esta página, se presentan ambos tipos de datos estructurados para tus páginas web y se describe cómo agregar atributos estructurados personalizados al esquema de tu almacén de datos.

Acerca de las fechas de páginas predefinidas inferidas por Google

Cuando rastrea las páginas web en el almacén de datos de tu sitio web, Google infiere los datos de la página con las propiedades que se aplican a tu contenido. Vertex AI Search agrega estas propiedades de datos de página inferidos a tu esquema. Estos datos inferidos incluyen las siguientes propiedades de fecha predefinidas, que también se denominan fechas de la línea de crédito:

  • datePublished: La fecha y hora en la que se publicó la página por primera vez
  • dateModified: La fecha y la hora en la que se modificó la página más recientemente.

Estas propiedades se indexan automáticamente. Puedes usar directamente estas propiedades de fecha para enriquecer tu búsqueda sin agregarlas a tu esquema. Para agregar fechas de firma a tu sitio web, consulta Influye en las fechas de firma de tus artículos en la Búsqueda de Google.

Para comprender cómo incluir estas propiedades de fecha predefinidas en tus solicitudes de búsqueda, como en las expresiones de filtro y las especificaciones de aumento, consulta el caso de uso de ejemplo con una fecha de página inferida por Google.

Información acerca de los campos de fecha y hora personalizados en una página web

Puedes agregar campos de fecha y hora personalizados a tus páginas web. Estas etiquetas se pueden usar con el indexado avanzado cuando agregas atributos de datos estructurados personalizados al esquema del almacén de datos.
Este es un ejemplo que muestra dónde agregar una metaetiqueta de fecha y hora personalizada llamada lastModified en tu página web.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Your web page title</title>

    <!-- Vertex AI Search can use this date. -->
    <meta name="lastModified" content="2022-07-01">
</head>
<body>
    </body>
</html>

Para comprender cómo incluir esas etiquetas de fecha y hora personalizadas en tus solicitudes de búsqueda, como en las expresiones de filtro y las especificaciones de aumento, consulta el ejemplo de caso de uso con un atributo de fecha y hora personalizado.

Acerca de los atributos de datos estructurados personalizados

Puedes agregar atributos de datos estructurados como etiquetas meta y mapas de páginas a tus páginas web y usarlos para enriquecer tu indexación. Para usar atributos estructurados personalizados para la indexación, debes actualizar tu esquema.

Ejemplo de caso de uso para etiquetas meta

Supongamos que tienes una gran cantidad de páginas web que son relevantes para varios departamentos de tu organización. Puedes usar etiquetas meta para etiquetar las páginas que son relevantes para cada departamento. Luego, puedes usar las etiquetas indexadas como filtros en tus consultas. Esto te permite restringir los resultados de la búsqueda a páginas web que contengan una etiqueta que coincida con cualquiera de los departamentos especificados.

Este proceso se puede resumir de la siguiente manera:

  1. Agrega las siguientes etiquetas meta a un subconjunto de tus páginas web:
    • Relevante para los departamentos de ingeniería y TI: <meta name="department" content="eng, infotech">
    • Relevante para los departamentos de finanzas y RR.HH.: <meta name="department" content="finance, human resources">
  2. Vuelve a rastrear las páginas actualizadas.
  3. Agrega department a tu esquema de almacén de datos como un array indexable, como se describe en la sección Cómo agregar atributos de datos estructurados personalizados al esquema de almacén de datos.

Después de actualizar el esquema, el almacén de datos se vuelve a indexar automáticamente. Una vez que se complete el reindexado, puedes usar el filtro department en una expresión de filtro para reordenar o filtrar los resultados de la búsqueda. Por ejemplo, cuando los usuarios del departamento de finanzas realizan consultas, los resultados de la búsqueda pueden ser más relevantes para ellos si el filtro department está configurado en finance.

Ejemplo de etiquetas meta en una página web

Este es un ejemplo de las etiquetas meta que puedes agregar a tu página web. Estas etiquetas se pueden usar con el indexado avanzado cuando agregas atributos de datos estructurados personalizados al esquema del almacén de datos.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Your web page title</title>

    <!-- Robots instructions for crawlers and for Vertex AI Search. -->
    <meta name="robots" content="index,follow">

    <!-- Vertex AI Search can use custom datetime fields to filter, boost, and order. -->
    <meta name="lastModified" content="2024-09-06">

    <!-- Vertex AI Search can filter by category or tags. -->
    <meta name="category" content="archived">
    <meta name="tags" content="legacy,interesting,faq">

    <!-- Vertex AI Search can index these common HTML tags. -->
    <meta name="description" content="A description of your web page's content.">
    <meta name="author" content="Your name or organization">
    <meta name="keywords" content="relevant,keywords,separated,by,commas">
    <link rel="canonical" href="https://www.yourwebsite.com/this-page">
    <meta property="og:title" content="Your Webpage Title">
    <meta property="og:description" content="A description of your webpage's content.">
    <meta property="og:image" content="https://www.yourwebsite.com/image.jpg">
    <meta property="og:url" content="https://www.yourwebsite.com/this-page">
    <meta property="og:type" content="website">
    <meta name="twitter:card" content="summary_large_image">
    <meta name="twitter:title" content="Your customized Webpage Title">
    <meta name="twitter:description" content="A description of your webpage's content.">
    <meta name="twitter:image" content="https://www.yourwebsite.com/image.jpg">
</head>
<body>
...
</body>
</html>

Ejemplo de caso de uso de PageMaps

Supongamos que tienes varias páginas web que contienen recetas de comida. Puedes agregar datos de PageMap al contenido HTML de cada página. Luego, puedes usar los nombres de atributos de PageMap indexados como filtros en tus consultas. Por ejemplo, si deseas destacar o ocultar páginas web según las calificaciones de las recetas, puedes seguir este proceso:

  1. Agrega datos de PageMap similares a los siguientes a tus páginas web:

    <html>
<head>
...
<!--
<PageMap>
    <DataObject type="document">
        <Attribute name="title">Baked potatoes</Attribute>
        <Attribute name="author">Dana A.</Attribute>
        <Attribute name="description">Homestyle baked potatoes in oven. This
        recipe uses Russet potatoes.</Attribute>
        <Attribute name="rating">4.9</Attribute>
        <Attribute name="lastUpdate">2015-01-01</Attribute>
    </DataObject>
</PageMap>
-->
</head>
...
</html>

  2. Vuelve a rastrear las páginas actualizadas.

  3. Agrega rating a tu esquema de almacén de datos como un array indexable, como se describe en la sección Cómo agregar atributos de datos estructurados personalizados al esquema de almacén de datos.

Después de actualizar el esquema, el almacén de datos se vuelve a indexar automáticamente. Una vez que se complete el reindexado, puedes usar el atributo rating en una expresión de filtro para reordenar o filtrar los resultados de la búsqueda. Por ejemplo, cuando los usuarios buscan recetas, aumenta los resultados de la búsqueda que tienen la mejor calificación usando rating como un atributo numérico personalizado.

Ejemplo de caso de uso para datos de schema.org

Supongamos que tienes un sitio web de opiniones y sus páginas web están anotadas con datos de schema.org en formato JSON-LD dentro de la etiqueta script de HTML. Luego, puedes usar las anotaciones indexadas como filtros en tus consultas. Por ejemplo, si deseas destacar o ocultar páginas web según las calificaciones agregadas, puedes seguir este proceso:

  1. Agrega a tus páginas web las anotaciones de schema.org para el contenido de opiniones similares a las siguientes. Para ver otros tipos de plantillas de schema.org disponibles, consulta Esquemas:

    <script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Review",
  "aggregateRating": {
    "@type": "Average Rating",
    "ratingValue": 3.5,
    "reviewCount": 11
  },
  "description": "Published in 1843, this is the perfect depiction of the Victorian London. A Christmas Carol is the story of Ebenezer Scrooge's transformation.",
  "name": "A Christmas Carol",
  "image": "christmas-carol-first-ed.jpg",
  "review": [
    {
      "@type": "Review",
      "author": "Alex T.",
      "datePublished": "2000-01-01",
      "reviewBody": "Read this in middle school and have loved this ever since.",
      "name": "Worth all the adaptations",
      "reviewRating": {
        "@type": "Rating",
        "bestRating": 5,
        "ratingValue": 5,
        "worstRating": 1
      }
    }
  ]
}
</script>

  2. Vuelve a rastrear las páginas actualizadas.

  3. Agrega la ruta a ratingValue al esquema de tu almacén de datos. Usa un identificador como el nombre del campo en el esquema del almacén de datos, como rating_value, como se describe en la sección Agrega atributos de datos estructurados personalizados al esquema del almacén de datos.

Después de actualizar el esquema, el almacén de datos se vuelve a indexar automáticamente. Una vez que se complete el reindexado, puedes usar el atributo rating_value en una expresión de filtro para reordenar o filtrar los resultados de la búsqueda. Por ejemplo, cuando los usuarios buscan libros, aumenta los resultados de la búsqueda que tienen la mejor calificación usando rating_value como un atributo numérico personalizado.

Antes de comenzar

Antes de actualizar el esquema del almacén de datos, haz lo siguiente:

  • Activa la indexación avanzada de sitios web para el almacén de datos. Para obtener más información, consulta Cómo activar la indexación avanzada de sitios web.
  • Comprende cómo funcionan los datos estructurados.
  • Obtén información para usar PageMaps. Revisa la lista de DataObjects reconocidos que se pueden agregar a los datos de PageMap.
  • Obtén información para usar etiquetas meta. Asegúrate de no usar ninguna metaetiqueta no admitida ni excluida.
  • Asegúrate de que el atributo que se debe indexar no tenga ninguno de los siguientes valores:
    • datePublished
    • dateModified
    • siteSearch
  • Ten en cuenta que, después de agregar datos estructurados a tus páginas web, debes volver a rastrearlas. Esto puede tardar varias horas.
  • Ten en cuenta que, después de agregar atributos de datos estructurados al esquema del almacén de datos, las páginas web de tu almacén de datos se vuelven a indexar automáticamente. La reinstalación del índice es una operación de larga duración que puede tardar varias horas.

Agrega atributos de datos estructurados personalizados al esquema del almacén de datos

Para agregar atributos de datos estructurados personalizados al esquema del almacén de datos, sigue estos pasos:

  1. Agrega etiquetas meta, datos de PageMap y datos de schema.org a todas las páginas de tu sitio web que quieras enriquecer con la indexación de datos estructurados:

    • Para las etiquetas meta, haz lo siguiente:
      • Cada etiqueta meta debe tener su atributo name configurado en el campo que deseas indexar y su atributo content en una cadena de uno o más valores separados por comas.
      • La Búsqueda de Vertex AI admite etiquetas meta con nombres que coinciden con el patrón [a-zA-Z0-9][a-zA-Z0-9-_]*. Asegúrate de no usar ninguna metaetiqueta no admitida ni excluida.
    • Para datos de PageMap:
      • Los datos de PageMap deben consistir en DataObjects reconocidos que contengan los nombres de atributos que deseas indexar. Los nombres de los atributos dentro de DataObjects deben establecerse en el campo que deseas indexar.
    • Para datos de schema.org:
      • Las anotaciones deben estar en formato JSON-LD, microdatos o RDFa válidos. Para obtener más información, consulta Formatos compatibles.

  2. Vuelve a rastrear las páginas web actualizadas.

  3. Consulta la definición del esquema de tu almacén de datos a través de la API de REST.

  4. Actualiza el esquema del almacén de datos a través de la API de REST. Para obtener más información, consulta Acerca de cómo proporcionar tu propio esquema como objeto JSON.

    1. Agrega objetos para cada atributo personalizado que quieras que se pueda buscar, recuperar o indexar.
    2. Agrega el atributo personalizado y establece su type en array.
    3. Agrega el tipo de datos del valor del atributo personalizado.
    4. Especifica la fuente del atributo personalizado en la que se puede encontrar en el campo siteSearchStructuredDataSources.
    5. Para los datos de schema.org, especifica la ruta de acceso del atributo en la anotación de schema.org que comienza con la cadena _root en el campo siteSearchSchemaOrgPaths.

    El siguiente es un ejemplo de una actualización de esquema para un sitio web:

    {
  "type": "object",
  "properties": [{
    "CUSTOM_ATTRIBUTE": {
      "type": "array",
      "items": {
        "type": "DATA_TYPE",
        "searchable": true,
        "retrievable": true,
        "indexable": true,
        "siteSearchStructuredDataSources": ["STRUCTURED_DATA_SOURCE_1", "STRUCTURED_DATA_SOURCE_2"]
      }
    }
  }
  {
    "IDENTIFIER_FOR_SCHEMA_ORG_FIELD": {
      "type": "array",
      "items": {
        "type": "DATA_TYPE_SCHEMA_ORG_FIELD",
        "searchable": true,
        "retrievable": true,
        "indexable": true,
        "siteSearchSchemaOrgPaths": ["_root.PATH_TO_THE_SCHEMA_ORG_FIELD"]
      }
    }
  }],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

    Reemplaza lo siguiente:

    • CUSTOM_ATTRIBUTE: Es el valor del atributo name. Por ejemplo:
      • Para una etiqueta meta definida como <meta name="department" content="eng, infotech">, usa department.
      • Para un atributo PageMap definido como <Attribute name="rating">4.9</Attribute>, usa rating.

    • DATA_TYPE: Es el tipo de datos del atributo name. Debe ser una cadena, un número o una fecha y hora. Por ejemplo:

      • Para una etiqueta meta definida como <meta name="department" content="eng, infotech">, usa string.
      • Para un atributo PageMap definido como <Attribute name="rating">4.9</Attribute>, usa number.
      • Para un atributo PageMap definido como <Attribute name="lastPublished">2015-01-01</Attribute>, usa datetime.

      Para obtener más información, consulta FieldType.

    • STRUCTURED_DATA_SOURCE_N: Es un array que consta de una o ambas de las siguientes fuentes de datos estructurados en las que se puede encontrar el atributo CUSTOM_ATTRIBUTE:

      • Si el atributo personalizado se puede encontrar como una etiqueta meta, especifica METATAG.
      • Si el atributo personalizado se puede encontrar como un atributo de PageMap, especifica PAGEMAP.
      • Si el atributo personalizado se puede encontrar como datos de schema.org, especifica SCHEMA_ORG.
      • Si el campo siteSearchStructuredDataSources no está presente o está vacío, los valores de las tres fuentes de datos se combinan en un array.

    • IDENTIFIER_FOR_SCHEMA_ORG_FIELD: Es un identificador personalizado para indicar el campo de schema.org. No es necesario que sea igual al nombre del campo en la anotación de schema.org de tu página web. Por ejemplo, si la ruta de acceso del campo es _root.nutrition.calories, el identificador puede ser calorific_value o nutrition_value.

    • DATA_TYPE_SCHEMA_ORG_FIELD: Es el tipo de datos del campo schema.org. Debe ser una cadena, un número o una fecha y hora. Por ejemplo:

      • Para un campo de schema.org definido como "calories":"240 calories", usa string.
      • Para un campo de schema.org definido como "calories": 240, usa number.
      • Para un campo de schema.org definido como "foundingDate": "1991-05-01", usa datetime.

      Para obtener más información, consulta FieldType.

    • PATH_TO_THE_SCHEMA_ORG_FIELD: Es la ruta de acceso a un solo campo en el campo schema.org al que se debe acceder. Se especifica con separadores de puntos después de cada nivel anidado. Debes especificar la ruta de acceso completa necesaria para acceder al campo requerido. Por ejemplo, si un campo ratingValue está anidado en el campo aggregateRating, puedes especificar la ruta de acceso como _root.aggregateRating.ratingValue.

Después de actualizar el esquema del sitio web, este se vuelve a indexar automáticamente. Esta es una operación de larga duración que puede tardar varias horas.

¿Qué sigue?

Usa los metadatos indexados para lo siguiente: