Utiliser les données structurées pour l'indexation avancée de sites Web

Si l'indexation avancée de sites Web est activée dans votre data store, vous pouvez utiliser les types de données structurées suivants pour enrichir votre indexation:

Cette page présente ces deux types de données structurées pour vos pages Web et explique comment ajouter des attributs structurés personnalisés au schéma de votre data store.

À propos des dates de page prédéfinies inférées par Google

Lorsque Google explore les pages Web de votre data store de site Web, il infère les données de page à l'aide des propriétés qui s'appliquent à votre contenu. Vertex AI Search ajoute ces propriétés de données de page inférées à votre schéma. Ces données inférées incluent les propriétés de date prédéfinies suivantes, également appelées dates de signature:

  • datePublished: date et heure de la première publication de la page
  • dateModified: date et heure de la dernière modification de la page

Ces propriétés sont indexées automatiquement. Vous pouvez utiliser directement ces propriétés de date pour enrichir votre recherche sans les ajouter à votre schéma. Pour ajouter des dates de publication à votre site Web, consultez la section Influencer vos dates de publication dans la recherche Google.

Pour savoir comment inclure ces propriétés de date prédéfinies dans vos requêtes de recherche, par exemple dans les expressions de filtre et les spécifications de boost, consultez Exemple de cas d'utilisation utilisant une date de page inférée par Google.

À propos des champs de date et heure personnalisés sur une page Web

Vous pouvez ajouter des champs de date et d'heure personnalisés à vos pages Web. Ces balises peuvent être utilisées avec l'indexation avancée lorsque vous ajoutez des attributs de données structurées personnalisés au data store données.
Voici un exemple qui montre où ajouter une balise Meta de date et heure personnalisée nommée lastModified sur votre page 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>

Pour savoir comment inclure ces balises de date et heure personnalisées dans vos requêtes de recherche, par exemple dans les expressions de filtre et les spécifications de boost, consultez Exemple de cas d'utilisation avec un attribut de date et heure personnalisé.

À propos des attributs de données structurées personnalisés

Vous pouvez ajouter des attributs de données structurées en tant que balises meta et PageMaps à vos pages Web, et les utiliser pour enrichir votre indexation. Pour utiliser des attributs structurés personnalisés pour l'indexation, vous devez mettre à jour votre schéma.

Exemple de cas d'utilisation des balises meta

Supposons que vous disposiez d'un grand nombre de pages Web pertinentes pour différents services de votre organisation. Vous pouvez utiliser des balises meta pour ajouter des libellés aux pages pertinentes pour chaque service. Vous pouvez ensuite utiliser les balises indexées comme filtres dans vos requêtes. Vous pouvez ainsi limiter les résultats de recherche aux pages Web contenant un libellé correspondant à l'un des services spécifiés.

Ce processus peut se résumer comme suit:

  1. Ajoutez les balises meta suivantes à un sous-ensemble de vos pages Web :
    • Informations utiles pour les services d'ingénierie et IT : <meta name="department" content="eng, infotech">
    • Informations utiles pour les services financiers et RH : <meta name="department" content="finance, human resources">
  2. Réindexez les pages mises à jour.
  3. Ajoutez department à votre schéma de data store en tant que tableau indexable, comme décrit dans la section Ajouter des attributs de données structurées personnalisés au schéma de data store.

Une fois votre schéma mis à jour, votre data store est automatiquement réindexé. Une fois l'indexation terminée, vous pouvez utiliser le filtre department dans une expression de filtre pour réorganiser ou filtrer les résultats de recherche. Par exemple, lorsque les utilisateurs du service financier posent des requêtes, les résultats de recherche peuvent être plus pertinents pour eux si le filtre department est défini sur finance.

Exemples de balises meta sur une page Web

Voici un exemple de balise meta que vous pouvez ajouter à votre page Web. Ces balises peuvent être utilisées avec l'indexation avancée lorsque vous ajoutez des attributs de données structurées personnalisés au data store données.

<!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>

Exemple de cas d'utilisation de PageMaps

Supposons que vous ayez plusieurs pages Web contenant des recettes de cuisine. Vous pouvez ajouter des données PageMaps au contenu HTML de chaque page. Vous pouvez ensuite utiliser les noms d'attribut PageMap indexés comme filtres dans vos requêtes. Par exemple, si vous souhaitez mettre en avant ou masquer des pages Web en fonction des notes des recettes, vous pouvez suivre cette procédure:

  1. Ajoutez des données PageMaps semblables à celles-ci à vos pages 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. Réindexez les pages mises à jour.

  3. Ajoutez rating à votre schéma de data store en tant que tableau indexable, comme décrit dans la section Ajouter des attributs de données structurées personnalisés au schéma de data store.

Une fois votre schéma mis à jour, votre data store est automatiquement réindexé. Une fois l'indexation terminée, vous pouvez utiliser l'attribut rating dans une expression de filtre pour réorganiser ou filtrer les résultats de recherche. Par exemple, lorsque les utilisateurs recherchent des recettes, boostez les résultats de recherche les mieux notés en utilisant rating comme attribut numérique personnalisé.

Exemple de cas d'utilisation des données schema.org

Supposons que vous possédiez un site Web d'avis et que ses pages Web soient annotées avec des données schema.org au format JSON-LD dans la balise HTML script. Vous pouvez ensuite utiliser les annotations indexées comme filtres dans vos requêtes. Par exemple, si vous souhaitez mettre en avant ou masquer des pages Web en fonction des notes globales, vous pouvez suivre cette procédure:

  1. Ajoutez les annotations schema.org pour le contenu des avis semblables aux suivantes à vos pages Web. Pour afficher d'autres types de modèles schema.org disponibles, consultez la page Schémas:

    <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. Réindexez les pages mises à jour.

  3. Ajoutez le chemin d'accès à ratingValue au schéma de votre data store. Utilisez un identifiant comme nom de champ dans le schéma du data store, par exemple rating_value, comme décrit dans la section Ajouter des attributs de données structurées personnalisés au schéma du data store de données.

Une fois votre schéma mis à jour, votre data store est automatiquement réindexé. Une fois l'indexation terminée, vous pouvez utiliser l'attribut rating_value dans une expression de filtre pour réorganiser ou filtrer les résultats de recherche. Par exemple, lorsque les utilisateurs recherchent des livres, boostez les résultats de recherche les mieux notés en utilisant rating_value comme attribut numérique personnalisé.

Avant de commencer

Avant de mettre à jour le schéma du data store, procédez comme suit:

Ajouter des attributs de données structurées personnalisés au schéma du data store

Pour ajouter des attributs pour les données structurées personnalisés au schéma du data store:

  1. Ajoutez des balises meta, des données PageMap et des données schema.org à toutes les pages de votre site Web que vous souhaitez enrichir avec l'indexation de données structurées:

    • Pour les balises meta :
      • L'attribut name de chaque balise meta doit être défini sur le champ que vous souhaitez indexer et son attribut content sur une chaîne d'une ou plusieurs valeurs séparées par une virgule.
      • Vertex AI Search est compatible avec les balises meta dont le nom correspond au format [a-zA-Z0-9][a-zA-Z0-9-_]*. Assurez-vous de ne pas utiliser de balise méta exclue ni de balise méta non prise en charge.
    • Pour les données PageMaps :
      • Les données PageMap doivent se composer de DataObjects reconnus contenant les noms d'attributs que vous souhaitez indexer. Les noms d'attributs dans les DataObjects doivent être définis sur le champ que vous souhaitez indexer.
    • Pour les données schema.org :
      • Les annotations doivent être au format JSON-LD, Microdonnées ou RDFa valide. Pour en savoir plus, consultez la section Formats acceptés.

  2. Réexplorer les pages Web mises à jour.

  3. Affichez la définition du schéma de votre data store via l'API REST.

  4. Mettez à data store datastore via l'API REST. Pour en savoir plus, consultez la section À propos de la fourniture de votre propre schéma en tant qu'objet JSON.

    1. Ajoutez des objets pour chaque attribut personnalisé que vous souhaitez rendre accessible à la recherche, récupérable ou indexable.
    2. Ajoutez l'attribut personnalisé et définissez son type sur array.
    3. Ajoutez le type de données de la valeur de l'attribut personnalisé.
    4. Spécifiez la source de l'attribut personnalisé dans le champ siteSearchStructuredDataSources.
    5. Pour les données schema.org: spécifiez le chemin de l'attribut dans l'annotation schema.org commençant par la chaîne _root dans le champ siteSearchSchemaOrgPaths.

    Voici un exemple de mise à jour de schéma pour un site 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"
}

    Remplacez les éléments suivants :

    • CUSTOM_ATTRIBUTE: valeur de l'attribut name. Exemple :
      • Pour une balise meta définie comme <meta name="department" content="eng, infotech">, utilisez department.
      • Pour un attribut PageMap défini comme <Attribute name="rating">4.9</Attribute>, utilisez rating.

    • DATA_TYPE: type de données de l'attribut name. Doit être une chaîne, un nombre ou une date et heure. Exemple :

      • Pour une balise meta définie comme <meta name="department" content="eng, infotech">, utilisez string.
      • Pour un attribut PageMap défini comme <Attribute name="rating">4.9</Attribute>, utilisez number.
      • Pour un attribut PageMap défini comme <Attribute name="lastPublished">2015-01-01</Attribute>, utilisez datetime.

      Pour en savoir plus, consultez la page FieldType.

    • STRUCTURED_DATA_SOURCE_N: tableau composé d'une ou de deux des sources de données structurées suivantes dans lesquelles l'attribut CUSTOM_ATTRIBUTE peut être trouvé:

      • Si l'attribut personnalisé est disponible en tant que balise meta, spécifiez METATAG.
      • Si l'attribut personnalisé est disponible en tant qu'attribut PageMap, spécifiez PAGEMAP.
      • Si l'attribut personnalisé peut être trouvé en tant que données schema.org, spécifiez SCHEMA_ORG.
      • Si le champ siteSearchStructuredDataSources est absent ou laissé vide, les valeurs des trois sources de données sont fusionnées dans un tableau.

    • IDENTIFIER_FOR_SCHEMA_ORG_FIELD: identifiant personnalisé pour désigner le champ schema.org. Il n'a pas besoin d'être identique au nom du champ dans l'annotation schema.org de votre page Web. Par exemple, si le chemin d'accès du champ est _root.nutrition.calories, l'identifiant peut être calorific_value ou nutrition_value.

    • DATA_TYPE_SCHEMA_ORG_FIELD: type de données du champ schema.org. Doit être une chaîne, un nombre ou une date et heure. Exemple :

      • Pour un champ schema.org défini comme "calories":"240 calories", utilisez string.
      • Pour un champ schema.org défini comme "calories": 240, utilisez number.
      • Pour un champ schema.org défini comme "foundingDate": "1991-05-01", utilisez datetime.

      Pour en savoir plus, consultez la page FieldType.

    • PATH_TO_THE_SCHEMA_ORG_FIELD: chemin d'accès à un seul champ du champ schema.org auquel vous devez accéder. Il est spécifié à l'aide de séparateurs de points après chaque niveau imbriqué. Vous devez spécifier le chemin complet nécessaire pour accéder au champ requis. Par exemple, si un champ ratingValue est imbriqué dans le champ aggregateRating, vous pouvez spécifier le chemin sous la forme _root.aggregateRating.ratingValue.

Une fois le schéma du site Web mis à jour, il est réindexé automatiquement. Il s'agit d'une opération de longue durée qui peut prendre plusieurs heures.

Étape suivante

Utilisez les métadonnées indexées pour les éléments suivants: