Strukturierte Daten für die erweiterte Websiteindexierung verwenden

Wenn die erweiterte Websiteindexierung in Ihrem Datenspeicher aktiviert ist, können Sie die folgenden Arten von strukturierten Daten verwenden, um die Indexierung zu ergänzen:

Auf dieser Seite werden beide Arten von strukturierten Daten für Ihre Webseiten vorgestellt. Außerdem wird beschrieben, wie Sie Ihrem Datenspeicherschema benutzerdefinierte strukturierte Attribute hinzufügen.

Vordefinierte, von Google abgeleitete Seitendatumsangaben

Beim Crawling der Webseiten in Ihrem Website-Datenspeicher leitet Google Seitendaten anhand der Properties ab, die für Ihre Inhalte gelten. Vertex AI Search fügt Ihrem Schema diese abgeleiteten Seitendateneigenschaften hinzu. Diese abgeleiteten Daten umfassen die folgenden vordefinierten Datumseigenschaften, die auch als Datumsangaben bezeichnet werden:

  • datePublished: Datum und Uhrzeit der Erstveröffentlichung der Seite
  • dateModified: Datum und Uhrzeit der letzten Änderung der Seite

Diese Properties werden automatisch indexiert. Sie können diese Datumseigenschaften direkt verwenden, um Ihre Suche zu ergänzen, ohne sie Ihrem Schema hinzuzufügen. Wie Sie Ihrer Website Datumsangaben für Verfasserzeilen hinzufügen, erfahren Sie unter Datum der Verfasserzeile in der Google Suche beeinflussen.

Weitere Informationen dazu, wie Sie diese vordefinierten Datumseigenschaften in Suchanfragen einbinden, z. B. in Filterausdrücken und Leistungssteigerungsspezifikationen, finden Sie im Hilfeartikel Beispiel für einen Anwendungsfall mit einem von Google abgeleiteten Seitendatum.

Benutzerdefinierte Datums-/Uhrzeitfelder auf einer Webseite

Sie können Ihren Webseiten benutzerdefinierte Datums-/Uhrzeitfelder hinzufügen. Solche Tags können mit der erweiterten Indexierung verwendet werden, wenn Sie dem Datenspeicherschema benutzerdefinierte Attribute für strukturierte Daten hinzufügen.
In diesem Beispiel wird gezeigt, wo Sie ein benutzerdefiniertes Datums-/Uhrzeit-Meta-Tag namens lastModified auf Ihrer Webseite einfügen.

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

Weitere Informationen dazu, wie Sie solche benutzerdefinierten Datums-/Zeittags in Suchanfragen einbinden, z. B. in Filterausdrücken und Leistungssteigerungsspezifikationen, finden Sie unter Beispiel für einen Anwendungsfall mit einem benutzerdefinierten Datums-/Zeitattribut.

Benutzerdefinierte Attribute für strukturierte Daten

Sie können Ihren Webseiten strukturierte Datenattribute als meta-Tags und PageMaps hinzufügen und diese zur Bereicherung der Indexierung verwenden. Wenn Sie benutzerdefinierte strukturierte Attribute für die Indexierung verwenden möchten, müssen Sie Ihr Schema aktualisieren.

Beispielanwendungsfall für meta-Tags

Angenommen, Sie haben eine große Anzahl von Webseiten, die für verschiedene Abteilungen in Ihrer Organisation relevant sind. Sie können die Seiten, die für die einzelnen Abteilungen relevant sind, mit meta-Tags kennzeichnen. Sie können die indexierten Tags dann als Filter in Ihren Abfragen verwenden. So können Sie die Suchergebnisse auf Webseiten beschränken, die ein Label enthalten, das mit einer der angegebenen Abteilungen übereinstimmt.

Dieser kann so zusammengefasst werden:

  1. Fügen Sie einer Teilmenge Ihrer Webseiten die folgenden meta-Tags hinzu:
    • Für die Entwicklungs- und IT-Abteilungen relevant: <meta name="department" content="eng, infotech">
    • Für Finanz- und Personalabteilungen relevant: <meta name="department" content="finance, human resources">
  2. Aktualisierte Seiten noch einmal erfassen
  3. Fügen Sie department als indexierbares Array in das Datenspeicherschema ein, wie im Abschnitt Dem Datenspeicherschema benutzerdefinierte strukturierte Datenattribute hinzufügen beschrieben.

Nach der Aktualisierung des Schemas wird Ihr Datenspeicher automatisch neu indexiert. Nach Abschluss der Neuindexierung können Sie den department-Filter in einem Filterausdruck verwenden, um Suchergebnisse neu anzuordnen oder zu filtern. Wenn Nutzer aus der Finanzabteilung beispielsweise Suchanfragen stellen, können die Suchergebnisse für sie relevanter gemacht werden, indem der department Filter auf finance gesetzt wird.

Beispiel für meta-Tags auf einer Webseite

Hier sehen Sie ein Beispiel für meta-Tags, die Sie Ihrer Webseite hinzufügen können. Solche Tags können mit der erweiterten Indexierung verwendet werden, wenn Sie dem Datenspeicherschema benutzerdefinierte Attribute für strukturierte Daten hinzufügen.

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

Beispielanwendungsfall für PageMaps

Angenommen, Sie haben mehrere Webseiten mit Rezepten. Sie können dem HTML-Inhalt jeder Seite PageMap-Daten hinzufügen. Sie können die indexierten PageMap-Attributnamen dann als Filter in Ihren Abfragen verwenden. Wenn Sie beispielsweise Webpages je nach Rezeptbewertung hervorheben oder unterdrücken möchten, gehen Sie so vor:

  1. Fügen Sie Ihren Webseiten PageMap-Daten wie den folgenden hinzu:

    <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. Aktualisierte Seiten noch einmal erfassen

  3. Fügen Sie rating als indexierbares Array in das Datenspeicherschema ein, wie im Abschnitt Dem Datenspeicherschema benutzerdefinierte strukturierte Datenattribute hinzufügen beschrieben.

Nach der Aktualisierung des Schemas wird Ihr Datenspeicher automatisch neu indexiert. Nach Abschluss der Neuindexierung können Sie das rating-Attribut in einem Filterausdruck verwenden, um Suchergebnisse neu anzuordnen oder zu filtern. Wenn Nutzer beispielsweise nach Rezepten suchen, können Sie die Suchergebnisse mit der höchsten Bewertung hervorheben, indem Sie rating als benutzerdefiniertes numerisches Attribut verwenden.

Beispiel für einen Anwendungsfall für schema.org-Daten

Angenommen, Sie haben eine Rezensionswebsite und die Webseiten sind mit schema.org-Daten im JSON-LD-Format im HTML-script-Tag annotiert. Sie können die indexierten Anmerkungen dann als Filter in Ihren Abfragen verwenden. Wenn Sie beispielsweise Webpages je nach den Gesamtbewertungen hervorheben oder unterdrücken möchten, gehen Sie so vor:

  1. Fügen Sie Ihren Webseiten Schema.org-Anmerkungen für Rezensionsinhalte hinzu, die denen in der Abbildung unten ähneln. Weitere verfügbare Schema.org-Vorlagentypen finden Sie unter Schemas:

    <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. Aktualisierte Seiten noch einmal erfassen

  3. Fügen Sie dem Datenspeicherschema den Pfad zu ratingValue hinzu. Verwenden Sie im Datenspeicherschema eine Kennung als Feldnamen, z. B. rating_value, wie im Abschnitt Dem Datenspeicherschema benutzerdefinierte Attribute für strukturierte Daten hinzufügen beschrieben.

Nach der Aktualisierung des Schemas wird Ihr Datenspeicher automatisch neu indexiert. Nach Abschluss der Neuindexierung können Sie das rating_value-Attribut in einem Filterausdruck verwenden, um Suchergebnisse neu anzuordnen oder zu filtern. Wenn Nutzer beispielsweise nach Büchern suchen, können Sie die Suchergebnisse mit der besten Bewertung hervorheben, indem Sie rating_value als benutzerdefiniertes numerisches Attribut verwenden.

Hinweise

Führen Sie die folgenden Schritte aus, bevor Sie das Datenspeicherschema aktualisieren:

Dem Datenspeicherschema benutzerdefinierte Attribute für strukturierte Daten hinzufügen

So fügen Sie dem Datenspeicherschema benutzerdefinierte Attribute für strukturierte Daten hinzu:

  1. Fügen Sie allen Seiten Ihrer Website, die Sie mit der Indexierung strukturierter Daten anreichern möchten, meta-Tags, PageMap-Daten und schema.org-Daten hinzu:

    • Für meta-Tags:

      • Für jedes meta-Tag muss das name-Attribut auf das Feld festgelegt sein, das indexiert werden soll, und das content-Attribut auf einen String mit einem oder mehreren durch Kommas getrennten Werten.

      • Vertex AI Search unterstützt meta-Tags mit Namen, die dem Muster [a-zA-Z0-9][a-zA-Z0-9-_]* entsprechen. Verwenden Sie keine ausgeschlossenen oder nicht unterstützten Meta-Tags.

        Wenn der Name des meta-Tags ein Sonderzeichen wie einen Doppelpunkt (:) enthält, müssen Sie im Schema eine andere Kennung für das Tag auswählen und dann den genauen Namen des meta-Tags im Feld siteSearchMetatagName des Schemas angeben.

    • Für PageMap-Daten:

      • PageMap-Daten müssen aus erkannten DataObjects bestehen, die Attributnamen enthalten, die Sie indexieren möchten. Die Attributnamen in den DataObjects müssen auf das Feld festgelegt sein, das Sie indexieren möchten.

    • Für schema.org-Daten:

      • Die Anmerkungen müssen im gültigen JSON-LD-, Mikrodaten- oder RDFa-Format vorliegen. Weitere Informationen finden Sie unter Unterstützte Formate.

  2. Aktualisierte Webseiten noch einmal crawlen

  3. Schemadefinition für Ihren Datenspeicher über die REST API aufrufen

  4. Aktualisieren Sie das Datenspeicherschema über die Google Cloud Console oder die API. Wenn Sie die API verwenden möchten, erfahren Sie hier, wie Sie Ihr eigenes Schema als JSON-Objekt bereitstellen.

    1. Fügen Sie für jedes benutzerdefinierte Attribut Objekte hinzu, die suchbar, abrufbar oder indexierbar sein sollen.
    2. Fügen Sie das benutzerdefinierte Attribut hinzu und legen Sie als type den Wert array fest.
    3. Fügen Sie den Datentyp des Werts des benutzerdefinierten Attributs hinzu.
    4. Geben Sie die Quelle des benutzerdefinierten Attributs an, in der es im Feld siteSearchStructuredDataSources zu finden ist.
    5. Für schema.org-Daten: Geben Sie den Pfad des Attributs in der schema.org-Anmerkung an, beginnend mit dem String _root im Feld siteSearchSchemaOrgPaths.

    Im folgenden Beispiel wird eine Schemaaktualisierung für eine Website veranschaulicht:

    {
  "type": "object",
  "properties": {
    "CUSTOM_ATTRIBUTE": {
      "type": "array",
      "items": {
        "type": "DATA_TYPE",
        "searchable": true,
        "retrievable": true,
        "indexable": true,
        "siteSearchMetatagName": "METATAG_NAME",
        "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"
}

    Ersetzen Sie Folgendes:

    • CUSTOM_ATTRIBUTE: Der Wert des Attributs name. Beispiel:

      • Verwenden Sie für ein meta-Tag, das als <meta name="department" content="eng, infotech"> definiert ist, department.
      • Geben Sie für ein PageMap-Attribut, das als <Attribute name="rating">4.9</Attribute> definiert ist, rating ein.

      Manchmal entspricht der meta-Tag-Name, den Sie dem Schema hinzufügen möchten, nicht dem Muster [a-zA-Z0-9][a-zA-Z0-9-_]* und enthält Sonderzeichen wie einen Doppelpunkt :. Geben Sie in solchen Fällen ein benutzerdefiniertes Attribut an, das dem Namen des meta-Tags entspricht, und geben Sie dann den genauen Namen des meta-Tags im Feld siteSearchMetatagName an. Wenn der Name des meta-Tags beispielsweise og:updated_time lautet, verwenden Sie og_updated_time als Kennung im Feld CUSTOM_ATTRIBUTE und og:updated_time im Feld METATAG_NAME.

    • DATA_TYPE: Der Datentyp des Attributs name. Muss entweder ein String, eine Zahl oder ein Datum/Uhrzeit sein. Beispiel:

      • Verwenden Sie für ein meta-Tag, das als <meta name="department" content="eng, infotech"> definiert ist, string.
      • Geben Sie für ein PageMap-Attribut, das als <Attribute name="rating">4.9</Attribute> definiert ist, number ein.
      • Geben Sie für ein PageMap-Attribut, das als <Attribute name="lastPublished">2015-01-01</Attribute> definiert ist, datetime ein.

      Weitere Informationen finden Sie unter FieldType.

    • METATAG_NAME: Der genaue Name des meta-Tags, wie er auf der Webseite zu finden ist. Dieses Feld ist hilfreich, wenn der Name des meta-Tags, den Sie dem Schema hinzufügen möchten, nicht dem Muster [a-zA-Z0-9][a-zA-Z0-9-_]* folgt und Sonderzeichen wie einen Doppelpunkt : enthält. Geben Sie in solchen Fällen ein benutzerdefiniertes Attribut an, das dem meta-Tag-Namen im Feld CUSTOM_ATTRIBUTE entspricht, und geben Sie dann den genauen meta-Tag-Namen im Feld siteSearchMetatagName an. Wenn der Name des meta-Tags beispielsweise og:updated_time lautet, verwenden Sie og_updated_time als Kennung im Feld CUSTOM_ATTRIBUTE und og:updated_time im Feld METATAG_NAME. Wenn Sie dieses Feld hinzufügen, um das Schema zu aktualisieren, müssen Sie den Endpunkt „v1alpha“ anstelle des Endpunkts „v1“ verwenden, um die Methode schema aufzurufen.

    • STRUCTURED_DATA_SOURCE_N: Ein Array aus einer oder beiden der folgenden strukturierten Datenquellen, in denen sich das CUSTOM_ATTRIBUTE-Attribut befindet:

      • Wenn das benutzerdefinierte Attribut als meta-Tag gefunden werden kann, gib METATAGS an.
      • Wenn das benutzerdefinierte Attribut als PageMap-Attribut gefunden werden kann, geben Sie PAGEMAP an.
      • Wenn das benutzerdefinierte Attribut als Schema.org-Daten gefunden werden kann, geben Sie SCHEMA_ORG an.
      • Wenn das Feld siteSearchStructuredDataSources fehlt oder leer ist, werden die Werte aus allen drei Datenquellen in einem Array zusammengeführt.

    • IDENTIFIER_FOR_SCHEMA_ORG_FIELD: Ein benutzerdefinierter Bezeichner für das Schema.org-Feld. Er muss nicht genau mit dem Feldnamen in der schema.org-Anmerkung auf Ihrer Website übereinstimmen. Wenn der Pfad des Felds beispielsweise _root.nutrition.calories ist, kann die Kennung calorific_value oder nutrition_value sein.

    • DATA_TYPE_SCHEMA_ORG_FIELD: Der Datentyp des Schema.org-Felds. Muss ein String, eine Zahl oder ein Datum/eine Uhrzeit sein. Beispiel:

      • Verwenden Sie für ein schema.org-Feld, das als „calories“: „240 Kalorien“ definiert ist, string.
      • Verwenden Sie für ein schema.org-Feld, das als „calories“: 240 definiert ist, number.
      • Für ein schema.org-Feld, das als „Gründungsdatum“: „1991-05-01“ definiert ist, verwenden Sie datetime.

      Weitere Informationen finden Sie unter FieldType.

    • PATH_TO_THE_SCHEMA_ORG_FIELD: Pfad zu einem einzelnen Feld im schema.org-Feld, auf das zugegriffen werden muss. Sie wird nach jeder verschachtelten Ebene mithilfe von Punkttrennzeichen angegeben. Sie müssen den vollständigen Pfad angeben, der für den Zugriff auf das erforderliche Feld erforderlich ist. Wenn ein Feld ratingValue beispielsweise im Feld aggregateRating verschachtelt ist, können Sie den Pfad als _root.aggregateRating.ratingValue angeben.

Nachdem Sie das Website-Schema aktualisiert haben, wird die Website automatisch neu indexiert. Dieser Vorgang mit langer Ausführungszeit kann mehrere Stunden dauern.

Nächste Schritte

Sie können die indexierten Metadaten für Folgendes verwenden: