„Einzelhandel“ wird in „Vertex AI Search for Retail“ umbenannt. Wir aktualisieren derzeit unsere Inhalte gemäß dem neuen Branding.

Diese Seite wurde von der Cloud Translation API übersetzt.

Kataloge und Produkte

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

Übersicht

Die Katalogdaten, die Sie in Vertex AI Search für den Einzelhandel importieren, haben direkten Einfluss auf die Qualität des resultierenden Modells und somit 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 Katalogzweige verwenden, um neue Daten zu testen, die Sie offline hochgeladen haben, bevor Sie sie auf Ihrer Website bereitstellen.

Sie können bis zu drei Branches verwenden, die als 0, 1 und 2 identifiziert werden. Ihre Live-Website verweist für ihre Katalogdaten auf default_branch. Geben Sie an, welcher Zweig derzeit Ihr Live-default_branch ist (Standardeinstellung ist Zweig 0) mit setDefaultBranch oder dem Tab „Daten“ in Search for Retail-Konsole. Ihre Website verwendet dann die bereitgestellten Katalogdaten durch den Zweig, auf den default_branch verweist.

Beispiel: Angenommen, default_branch ist auf Zweig-ID 0 eingestellt. Ihre verwendet die Katalogdaten, die Sie in diesen Zweig hochgeladen haben. Sie können neue Katalogdaten in einen Branch 1 hochladen und in der Vorschau ansehen. Nachdem Sie bestätigt haben, dass der Katalog korrekt hochgeladen wurde, können Sie als Live-default_branch auf Branch 1 wechseln.

Nach dem Wechsel des Standorts kann es bis zu 30 Minuten dauern, bis der Katalogcache aktualisiert ist.

Wenn Sie Empfehlungen verwenden, empfehlen wir aufgrund der Aktualisierungsverzögerung beim Wechseln des Branches, nur den Standard-Branch zu verwenden. Wenn die Datenabweichung zwischen den Verzweigungen 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	Hinweise
`name`	Der vollständige Ressourcenname des Produkts. Für alle erforderlich `Product`-Methoden mit Ausnahme von `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 Jedem Produkt muss mindestens eine 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änge von maximal 5.000 Zeichen sein. Geben Sie immer den vollständigen Pfad der Kategorie an, z. B.: `["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, sind Attribute in einem Produkt in der Suchantwort enthalten, wenn Sie sie als abrufbar in Product.retrievableFields markieren. Sie können dann für andere Suchfunktionen wie Filter und Facetten.

Weitere Informationen finden Sie unter Produktattribute.

Produktebenen

Durch die Kennzeichnung von Produkt-SKUs wird die Hierarchie in Ihrem Katalog festgelegt.

Arten von Produktbezeichnungen

Es gibt drei Arten von Produktbezeichnungen:

Primäre Elemente werden in Empfehlungen und Suchergebnissen zurückgegeben. Primäre Elemente können einzelne Elemente (SKU-Ebene) und Gruppen ähnlicher Elemente (SKU-Gruppen) sein.
Varianten sind Versionen eines primären Produkts einer SKU-Gruppe. Varianten können nur einzelne Elemente (Artikelebene) sein. Wenn das Hauptprodukt beispielsweise „V-Ausschnitt“, Varianten könnten „Braun V-Ausschnitt, Größe XL“ sein und „Weiße Shirt mit V-Ausschnitt, Größe S". Primäre und Varianten werden manchmal als übergeordnete und untergeordnete Elemente bezeichnet.
Elemente der Sammlung sind Sammlungen von Produkten. Sammlungen sind Sets aus primären Produkten oder Varianten. Eine Kollektion kann beispielsweise ein Schmuckset mit einer Halskette, Ohrringen und einem Ring sein. Sammlungen sind nur in der Suche verfügbar und werden nicht häufig verwendet.

Produktbeispiele

Gemäß diesen Produktbenennungstypen würden Lebensmittel beispielsweise aus Produkten mit einer einzelnen SKU wie "bananas, fresh" bestehen.

Auf der anderen Seite wären T-Shirts besser hierarchisch strukturiert, da T-Shirts eher hierarchisch strukturiert werden könnten, als Grundschulen mit den entsprechenden Varianten. Jede Variante stellt eine einzelne SKU (für jede Größe) dar und jeder Hauptartikel eine Gruppe von SKUs, wobei jede SKU eine andere Größe für einen übergeordneten T-Shirt-Stil hat. Durch diese Organisation nach SKU-Struktur können in den Suchergebnissen und Empfehlungsbereichen verschiedene T-Shirt-Modelle angezeigt werden. Käufer können damit eine bestimmte primäre Variante (Stil) aufschlüsseln, um die entsprechende Variante auszuwählen. (Größe).

Es gibt auch einen Katalogtyp, der nur eine Variante enthält, der inzwischen eingestellt wurde. Dieser Katalog -Typ kann nur mit Empfehlungen verwendet werden. Für den Katalog mit nur Varianten wird ingestionProductType beim Import auf variant gesetzt. Eine primäre wird für jede Variante auf Basis einer für jede Variante angegebenen primären Produkt-ID abgeleitet. Variante.

Produktkatalog einrichten

Bei der Planung Ihres Produktkatalogs müssen Sie entscheiden, ob er Produkte enthält, die nur als Grundfarben, als primäre und als Varianten gekennzeichnet sind oder eine Mischung aus beiden Anordnungen enthalten. Betrachten Sie es in Bezug auf SKU-Struktur Bei Ihren Produkten kann es sich um Hauptartikel handeln, von denen es verschiedene Varianten gibt.

Je nachdem, wie Ihre Produkt-SKUs angegeben sind, haben Sie folgende Möglichkeiten, Ihren Produktkatalog einzurichten:

Die Artikelnummer soll als einzelnes Suchergebnis oder Empfehlung angezeigt werden: SKU=primary
Die SKU muss Teil einer Gruppe ähnlicher SKUs sein: SKU = Variante, SKU-Gruppe = primär
Eine Kombination aus beiden Kombinationen: SKU=primär, SKU=Variante, Gruppe von SKUs=primär

Wenn auf Ihrer Produktdetailseite eine Auswahlmöglichkeit für Optionen, Größen oder Farben angezeigt wird, werden diese Optionen in der Regel als Varianten in Ihren Produktkatalog hochgeladen. Überlegen Sie, ob verschiedene Arten desselben Produkts mit unterschiedlichen Attributen wie Größe und Farbe in einem oder in separaten Suchergebnissen angezeigt werden sollen. Beispiel: Sie möchten für ein Buch entscheiden, ob die Artikelnummer für Hardcover und Softcover desselben Buchs als separate Suchergebnisse (SKU = primär) oder als eine (SKU = Variante, Gruppe von SKUs = primär) angezeigt werden soll.

Beachten Sie beim Einrichten Ihres Produktkatalogs, dass Empfehlungen und Suchergebnisse nur primäre Artikel zurückgeben.

Mindestanzahl der Hauptprodukte

Wenn Sie feststellen, dass Ihr Katalog sowohl Vorwahlen als auch Varianten enthalten sollte, ist, SKU-Gruppen und SKUs. Da Sie aktuell nur SKUs haben, müssen Sie für die Artikelnummergruppen. Vorwahlen werden manchmal als „virtuell“ Vorwahlen“ oder „gefälschte Vorwahlen“ verwenden.

Diese primären Datenbanken müssen nur minimale Informationen enthalten: id, title und categories

Wenn type nicht angegeben ist, wird standardmäßig „primär“ verwendet. Wenn Sie importieren möchten, müssen Sie name nicht angeben. Weitere Informationen finden Sie unter im vorherigen Abschnitt, Erforderliche Produktinformationen.

Typ ist unveränderlich

Sie können den Typ eines Produkts nicht ändern, z. B. von Variante in primär. oder von der primären zur Variante wechseln.

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

Katalogimport

Wenn sich Ihr Katalog im Merchant Center befindet, empfehlen wir Ihnen, ihn zu importieren, indem Sie Ihr Merchant Center-Konto verknüpfen.

Wenn sich Ihr Katalog nicht im Merchant Center befindet, aber in Cloud Storage oder BigQuery oder einen anderen Speicher, um einen Bulk-Datenimport durchzuführen.

Wenn Sie zukünftig 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. Das ist wichtig, da die Konfiguration eines vorhandenen Katalogs geändert werden muss, indem der Katalog gelöscht und noch einmal hochgeladen wird (siehe Konfiguration auf Produktebene ändern).

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

Produktinventar

Das Inventar umfasst Folgendes:

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

Es gibt zwei Inventarebenen: Produktebene und lokal.

Inventar auf Produktebene

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

Weitere Informationen zum Inventar auf Produktebene, finden Sie unter Inventar aktualisieren für Vertex AI Search for Retail.

Lokales Inventar

Einzelhändler mit Ladengeschäften und einem Onlineshop müssen ihre Inventarinformationen für jedes Geschäft. Dazu verwendet er lokales Inventar.

Es gibt zwei Produktfelder, in denen lokales Inventar gespeichert werden kann. Beide Felder sind Listen mit Standorten (Orts-IDs) mit zugehörigen Inventarinformationen:

Product.fulfillmentInfo. Abhol- und Versandmethoden an jedem Standort
Product.localInventories: Preisinformationen, Produkt Attribute sowie Abhol- und Versandmethoden in jedem Geschäft

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

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

Qualitätsmesswerte für Katalogdaten

Auf der Seite Datenqualität in der Retail-Konsole wird ermittelt, ob Sie Katalogdaten aktualisieren müssen, um die Qualität der Suchergebnisse zu verbessern und Leistungsstufen für die Suche freizuschalten.

In der folgenden Tabelle werden die Qualitätsmesswerte beschrieben, die Vertex AI Search for Retail verwendet, um bei der Auswertung Ihrer Produktdaten. Weitere Informationen dazu, wie Sie Messwerte zur Datenqualität und Leistungsstufen für die Suche in der Retail Search Console aufrufen, finden Sie unter Leistungsstufen für die Suche freischalten.

Katalogqualitätsmesswert	Qualitätsregel	Hinweise
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 Google Suche nutzt Websignale, die mit diesem 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 for Retail

Verwenden Sie beim Importieren eines Katalogs aus BigQuery das unten stehende Schema „Vertex AI Search for retail product“, 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"
      }
    ]
  }
]