Retail wird in Vertex AI Search für den Einzelhandel umbenannt. Wir aktualisieren derzeit unsere Inhalte gemäß dem neuen Branding.

Kataloge und Produkte

Auf dieser Seite finden Sie Best Practices zum Erstellen Ihrer Kataloginformationen und zum Füllen Ihrer Katalogdaten.

Überblick

Die Katalogdaten, die Sie in Vertex AI Search für den Einzelhandel importieren, haben direkte Auswirkungen auf die Qualität des resultierenden Modells und damit auf die Qualität der Such- und Empfehlungsergebnisse. Im Allgemeinen gilt: Je genauer und spezifischer die Kataloginformationen sind, desto höher ist die Qualität Ihres Modells.

Ihr Katalog sollte auf dem neuesten Stand sein. Sie können Katalogänderungen so oft wie nötig hochladen. Im Idealfall täglich für Kataloge mit einer hohen Änderungsrate. Sie können vorhandene Produktelemente hochladen (patchen). Es werden nur die geänderten Felder aktualisiert. Für das Hochladen von Kataloginformationen fallen keine Gebühren an. Weitere Informationen finden Sie unter Katalog auf dem neuesten Stand halten.

Katalogzweige

Wenn Sie die Suche verwenden, können Sie neue Daten, die Sie offline hochgeladen haben, mithilfe von Katalogzweigen testen, bevor Sie sie auf Ihrer Website veröffentlichen.

Sie können bis zu drei Zweige verwenden, die als 0, 1 und 2 identifiziert werden. Ihre Live-Website verweist für ihre Katalogdaten auf default_branch. Gib über setDefaultBranch oder den Tab „Daten“ in der Search for Retail-Konsole an, welcher Zweig derzeit deine aktive default_branch ist (standardmäßig auf Branch 0 festgelegt). Ihre Website verwendet dann die Katalogdaten des Zweigs, auf den default_branch verweist.

Beispiel: default_branch ist derzeit auf die Branch-ID 0 festgelegt, sodass Ihre Website die Katalogdaten verwendet, die Sie in diesen Branch hochgeladen haben. Sie können neue Katalogdaten in einen Branch 1 hochladen und in der Vorschau ansehen. Nachdem Sie sich vergewissert haben, dass der Katalog korrekt hochgeladen wurde, können Sie zum Zweig 1 als Live-default_branch wechseln.

Nach dem Zweigwechsel kann es bis zu 30 Minuten dauern, bis der Katalog-Cache aktualisiert wird.

Wenn Sie Empfehlungen verwenden, empfehlen wir, aufgrund der Aktualisierungsverzögerung beim Zweigwechsel nur den Standardzweig zu verwenden. Wenn der Datenunterschied zwischen Zweigen groß ist, kann sich die Aktualisierungsverzögerung negativ auf die Vorhersageergebnisse auswirken.

Produkte

Der Katalog ist eine Sammlung von Produktobjekten.

Erforderliche Produktinformationen

Die folgenden Felder sind erforderlich. Sie müssen Werte für diese angeben, wenn Sie Produktelemente in Ihrem Katalog erstellen. Sie sollten auch den Werten entsprechen, die in Ihrer internen Produktdatenbank verwendet werden. Außerdem sollten sie das dargestellte Produkt genau widerspiegeln, da sie im Training Ihrer Modelle enthalten sind.

In einigen Fällen sind auch andere Felder erforderlich. Sehen Sie sich die vollständige Liste aller Produktfelder auf der Product-Referenzseite an.

Alle von Ihnen bereitgestellten Produktinformationen können zur Verbesserung der Qualität von Empfehlungen und Suchergebnissen verwendet werden. Achten Sie darauf, so viele Felder wie möglich anzugeben.

Feld	Notes
`name`	Der vollständige Ressourcenname des Produkts. Erforderlich für alle `Product`-Methoden außer `import`. Während des Imports wird der Name automatisch generiert und muss nicht manuell angegeben werden.
`id`	Die von Ihrer Produktdatenbank verwendete Produkt-ID. Das ID-Feld muss in dem gesamten Katalog eindeutig sein. Derselbe Wert wird beim Aufzeichnen eines Nutzerereignisses verwendet und auch von den Methoden `predict` und `search` zurückgegeben.
`title`	Produkttitel aus Ihrer Produktdatenbank. Ein UTF-8-codierter String. Er ist auf maximal 1250 Zeichen beschränkt.
`categories`	Produktkategorien. Jedes Produkt muss mindestens einer Kategorie zugewiesen sein. Wenn ein Produkt zu mehreren Kategorien gehört, wiederholen Sie das Feld für jede Kategorie. Der Wert muss ein nicht leerer UTF-8-codierter String mit einer Längenbeschränkung von 5.000 Zeichen sein. Geben Sie immer den vollständigen Kategoriepfad an. Beispiel: `["Sports & Fitness > Athletic Clothing > Shoes"]`.

Produktattribute

Es wird dringend empfohlen, Werte für vordefinierte Systemattribute in Product wie Marke, Farbe und Größe anzugeben. Sie können auch benutzerdefinierte Attribute hinzufügen, die Sie mit Product.attributes definieren.

Wenn Sie die Suche verwenden, werden Attribute mit einem Produkt in der Suchantwort enthalten, wenn Sie sie in Product.retrievableFields als abrufbar markieren. Sie lassen sich dann für andere Suchfunktionen wie Filter und Facetten verwenden.

Weitere Informationen finden Sie unter Produktattribute.

Produktebenen

Produktebenen bestimmen die Hierarchie in Ihrem Katalog. In der Regel müssen Sie zwischen einem ein- und zweistufigen Katalog wählen.

Sie können beispielsweise einen Katalog mit einer Ebene haben, in dem jeder Produktartikel eine Artikelnummer hat. Alternativ können Sie einen Katalog mit zwei Ebenen auswählen, der sowohl SKU-Gruppen als auch einzelne SKUs enthält.

Typen auf Produktebene

Es gibt drei Typen auf Produktebene:

Primäre Elemente werden in Empfehlungen oder Suchergebnissen zurückgegeben. Primärschlüssel können einzelne Artikel (Artikelebene auf SKU-Ebene) und Gruppen ähnlicher Artikel (SKU-Gruppen) sein.
Artikel mit Varianten sind Versionen eines Hauptprodukts aus einer SKU-Gruppe. Varianten können nur einzelne Artikel (SKU-Ebene) sein. Wenn das Hauptprodukt beispielsweise „Hemd mit V-Ausschnitt“ ist, könnten die Varianten „Braunes Hemd mit V-Ausschnitt, Größe XL“ und „Weißes Hemd mit V-Ausschnitt, Größe S“ sein. Hauptelemente und Varianten werden manchmal als parent und parent Elemente beschrieben.
Collection-Elemente sind Sammlungen von Produkten. Sammlungen sind Sets von Primärprodukten oder Produktvarianten. Eine Kollektion kann z. B. ein Schmuckset mit Halskette, Ohrringen und Ring sein. Sammlungen sind nur in der Suche verfügbar und nicht weit verbreitet.

Kataloghierarchie

Bei der Planung Ihrer Kataloghierarchie müssen Sie entscheiden, ob Ihr Katalog nur Primär- oder Primärschlüssel und Varianten enthalten soll. Beachten Sie, dass Vervollständigungen und Suchergebnisse nur primäre Elemente zurückgeben.

Ein reiner Katalog kann sich beispielsweise gut für den Verkauf von Büchern eignen, bei dem in einem Empfehlungsbereich eine Auswahl von Büchern mit jeweils eigener Artikelnummer zurückgegeben wird. In einem Primärkatalog für T-Shirts wird jedoch wahrscheinlich dasselbe T-Shirt in jeder verfügbaren Größe im Empfehlungsbereich angezeigt.

Der T-Shirt-Katalog wäre besser, wenn es sowohl Haupt- als auch Varianten gibt, wobei die Artikelnummern als Varianten (eine Variante pro Größe) und die Artikelnummern die Artikelnummergruppen für die Größen der einzelnen T-Shirt-Stile darstellen. Dieser zweistufige Katalog ermöglicht es dem Empfehlungsbereich, eine Reihe ähnlicher T-Shirt-Stile anzuzeigen. Der Käufer kann eine bestimmte Hauptversion (Stil) aufschlüsseln, um die zu kaufende Variante (Größe) auszuwählen.

Es gibt auch einen Katalogtyp nur für Varianten, der jetzt eingestellt wird. Dieser Katalogtyp kann nur mit Empfehlungen verwendet werden. Für den Variantenkatalog wird ingestionProductType während des Imports auf variant gesetzt. Für jede Variante wird aus einer primären Produkt-ID abgeleitet, die für jede Variante angegeben ist.

Minimale Hauptprodukte

Wenn Sie feststellen, dass Ihr Katalog sowohl Primärschlüssel als auch Varianten enthalten sollte, also SKU-Gruppen und SKUs, Sie jetzt aber nur SKUs haben, müssen Sie Hauptrollen für die SKU-Gruppen erstellen. Diese werden manchmal als „virtuelle Hauptquellen“ oder „gefälschte Vorwahlen“ bezeichnet.

Diese Primärquellen müssen nur minimale Informationen enthalten: id, title und categories.

Wenn type nicht angegeben ist, wird standardmäßig der Produkttyp „Primär“ verwendet. Beim Importieren müssen Sie name nicht angeben. Weitere Informationen finden Sie im vorherigen Abschnitt Erforderliche Produktinformationen.

Der Typ ist unveränderlich

Sie können den Typ eines Produkts nicht ändern, z. B. von Variante zu Primär oder von Primär zu Variante.

Wenn Sie den Typ eines Produkts ändern müssen, löschen Sie das Produkt und erstellen Sie ein Produkt mit einem anderen Typ neu. Bevor Sie ein Hauptprodukt löschen können, müssen Sie die zugehörigen Varianten löschen.

Katalogimport

Wenn Sie Ihren Katalog derzeit im Merchant Center haben, sollten Sie ihn importieren. Verknüpfen Sie dazu Ihr Merchant Center-Konto.

Wenn sich Ihr Katalog nicht im Merchant Center, sondern in Cloud Storage, BigQuery oder einem anderen Speicher befindet, führen Sie einen Bulk-Datenimport durch.

Wenn Sie in Zukunft Katalogdaten aus dem Merchant Center importieren möchten, überprüfen Sie Ihre Daten wie für Merchant Center-Importe beschrieben, um sicherzustellen, dass Sie die richtigen Entscheidungen für Ihren Katalog treffen. Dies ist wichtig, da beim Ändern der Konfiguration eines vorhandenen Katalogs der Katalog gelöscht und noch einmal hochgeladen werden muss (siehe Konfiguration auf Produktebene ändern).

Ausführliche Informationen zum Hochladen eines Katalogs finden Sie unter Kataloginformationen importieren.

Produktinventar

Das Produktinventar umfasst:

Preis, sowohl der aktuelle als auch der Originalpreis
Verfügbarkeit (z. B. auf Lager, nicht auf Lager, nachbestellt oder vorbestellt)
Verfügbare Menge
Informationen zur Auftragsausführung wie Abholung im Geschäft, Ladenversand und Lieferung am nächsten Tag

Es gibt zwei Inventarebenen: die Produktebene und die lokale Inventarebene.

Inventar auf Produktebene

Bei Einzelhändlern, die ihre Produkte nur online verkaufen, wird das Inventar auf Produktebene angegeben. Preis, Verfügbarkeit und andere Inventardaten werden für jedes Produkt im Katalog festgelegt.

Weitere Informationen zum Inventar auf Produktebene, einschließlich der Verwaltung von Inventardaten, finden Sie unter Inventar für Vertex AI Search für den Einzelhandel aktualisieren.

Lokales Inventar

Einzelhändler, die Ladengeschäfte und einen Onlineshop haben, müssen Inventarinformationen pro Geschäft speichern. Dazu nutzt er lokales Inventar.

Es gibt zwei Produktfelder, die zum Speichern von lokalem Inventar verwendet werden können. Beide Felder sind Listen von Standorten (Orts-IDs) mit zugehörigen Inventarinformationen:

Product.fulfillmentInfo: Abhol- und Versandmethoden an jeder Filiale
Product.localInventories: Preisinformationen, Produktattribute sowie Abhol- und Versandmethoden

Sie können eines oder beide Felder für Informationen auf Geschäftsebene verwenden.

Weitere Informationen zu lokalen Inventaren finden Sie unter Lokales Inventar für Vertex AI Search für den Einzelhandel aktualisieren.

Qualitätsmesswerte für Katalogdaten

Auf der Seite Datenqualität in der Search for Retail-Konsole wird bewertet, ob Sie Katalogdaten aktualisieren müssen, um die Qualität der Suchergebnisse zu verbessern und Stufen für die Suchleistung zu nutzen.

In der folgenden Tabelle werden die Qualitätsmesswerte beschrieben, die Vertex AI Search für den Einzelhandel zur Bewertung Ihrer Produktdaten verwendet. Informationen zum Aufrufen von Datenqualitätsmesswerten und Suchleistungsstufen in der Search for Retail-Konsole finden Sie unter Suchleistungsstufen freischalten.

Katalogqualitätsmesswert	Qualitätsregel	Notes
URI ist vorhanden und zugänglich	Das Produkt hat eine gültige `Product.uri`. Der URI muss zugänglich sein und mit Ihrer Domain übereinstimmen.	Die Suche verwendet Websignale, die über diesen URI gecrawlt werden, um die Suchqualität zu verbessern.
Erfüllt Zeitvorgaben	`Product.availableTime` liegt vor der aktuellen Uhrzeit und `Product.expireTime` liegt nach der aktuellen Uhrzeit.	Nur Produkte, die die Zeitkonformität erfüllen, sind für die Suche verfügbar.
Suchbares Attribut vorhanden	Für das Produkt ist mindestens ein `attribute` für die Suche festgelegt.	Benutzerdefinierte Attribute, die als suchbar gekennzeichnet sind, können durch Textabfragen gesucht werden.
Beschreibung ist vorhanden	Das Produkt ist nicht leer `Product.description`.	Eine umfassende Beschreibung hilft, die Suchqualität zu verbessern.
Der Titel besteht aus mindestens zwei Wörtern	`Product.title` besteht aus mindestens zwei Wörtern.	Ein umfassender Titel trägt zu einer besseren Suchqualität bei.
Hat Variante mit Bild	Das `variant`-Produkt hat mindestens ein `Product.image`. Sie können diesen Messwert ignorieren, wenn sich alle Ihre Produkte auf der `primary`-Ebene befinden.	Dieser Messwert dient nur Informationszwecken und wirkt sich nicht auf die Suchqualität aus.
Hat Variante mit Preisinformationen	Für das Produkt `variant` ist `Product.priceInfo` festgelegt. Sie können diesen Messwert ignorieren, wenn sich alle Ihre Produkte auf der `primary`-Ebene befinden.	Dieser Messwert dient nur Informationszwecken und wirkt sich nicht auf die Suchqualität aus.

Produktschema für Vertex AI Search für den Einzelhandel

Verwenden Sie beim Importieren eines Katalogs aus BigQuery das folgende Produktschema von Vertex AI Search für den Einzelhandel, um eine BigQuery-Tabelle mit dem richtigen Format zu erstellen und mit Ihren Katalogdaten zu laden. Anschließend importieren Sie den Katalog.

Produktschema von Vertex AI Search für den Einzelhandel

BigQuery

[
  {
    "name": "name",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "id",
    "type": "STRING",
    "mode": "REQUIRED"
  },
  {
    "name": "type",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "primaryProductId",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "collectionMemberIds",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "gtin",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "categories",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "title",
    "type": "STRING",
    "mode": "REQUIRED"
  },
  {
    "name": "brands",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "description",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "languageCode",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "attributes",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "key",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "value",
        "type": "RECORD",
        "mode": "NULLABLE",
        "fields": [
          {
            "name": "text",
            "type": "STRING",
            "mode": "REPEATED"
          },
          {
            "name": "numbers",
            "type": "FLOAT",
            "mode": "REPEATED"
          }
        ]
      }
    ]
  },
  {
    "name": "tags",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "priceInfo",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "currencyCode",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "price",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "originalPrice",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "cost",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "priceEffectiveTime",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "priceExpireTime",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "rating",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "ratingCount",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "averageRating",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "ratingHistogram",
        "type": "INTEGER",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "expireTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "ttl",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "seconds",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "nanos",
        "type": "INTEGER",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "availableTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "availability",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "availableQuantity",
    "type": "INTEGER",
    "mode": "NULLABLE"
  },
  {
    "name": "fulfillmentInfo",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "type",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "placeIds",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "uri",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "images",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "uri",
        "type": "STRING",
        "mode": "REQUIRED"
      },
      {
        "name": "height",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "width",
        "type": "INTEGER",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "audience",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "genders",
        "type": "STRING",
        "mode": "REPEATED"
      },
      {
        "name": "ageGroups",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "colorInfo",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "colorFamilies",
        "type": "STRING",
        "mode": "REPEATED"
      },
      {
        "name": "colors",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "sizes",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "materials",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "patterns",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "conditions",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "retrievableFields",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "publishTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "promotions",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "promotionId",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  }
]