„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 mit dem setDefaultBranch oder dem Tab „Daten“ in der Search for Retail Console an, welcher Zweig Ihre Live-default_branch ist (standardmäßig auf den Zweig 0 gesetzt). Ihre Website verwendet dann die Katalogdaten des Branches, auf den default_branch verweist.

Beispiel: default_branch ist 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 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. Eine vollständige Liste aller Produktfelder finden Sie auf der Referenzseite Product.

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. Erforderlich für alle `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 mehr als einer Kategorie 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.

Abrufbare Felder

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 Attribute verwendet werden.

Option für die genaue Suche

Sie können der Option „Genaue Suche“, einem Katalogattributfeld, einen bestimmten Wert für bestimmte Stringabfragen zuweisen. Wenn eine Suchanfrage mit einem Produkt in Ihrem Katalog übereinstimmt, bei dem der Wert für dieses Feld mit dem in der Suchanfrage angegebenen String übereinstimmt, wird genau dieses Produkt in der Suchanfrage zurückgegeben. Diese Option eignet sich gut für Seriennummern, bei denen Kunden eine gezielte Suche erwarten.

Das Feld ExactSearchableOption ist ein nützliches Feld für Produktattribute mit einem genauen Wert (z. B. ModelId oder ManufacturerId) und wird in der Regel für benutzerdefinierte Attribute verwendet. Attribute wie „product_id“ sind Hauptindexfelder, die standardmäßig genau durchsucht werden können. Das Feld item_id ist für die genaue Übereinstimmung immer aktiviert und kann nicht deaktiviert werden.

Damit bei Suchanfragen keine irrelevanten Elemente zurückgegeben werden, sollten Sie die Option „Suchbar“ niemals auf einen generischen Wert wie battery festlegen.
Damit Suchanfragen nicht zu selten ausgeliefert werden, sollten Sie spezielle Felder wie tag, das einen Stringwert wie „iphone“ haben könnte, nicht für die exakte Suche festlegen. Dadurch werden die Ergebnisse für alle iPhones im Produktkatalog möglicherweise eingeschränkt.

Weitere Informationen finden Sie unter Produktattribute.

Produktebenen

Die SKU-Bezeichnungen der Produkte bestimmen die Hierarchie in Ihrem Katalog.

Arten von Produktbezeichnungen

Es gibt drei Arten von Produktbezeichnungen:

Primäre Elemente werden in Empfehlungen oder 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 primäre Produkt z. B. „V-Neck-Shirt“ ist, können die Varianten „Braunes V-Neck-Shirt, Größe XL“ und „Weißes V-Neck-Shirt, Größe S“ lauten. Primäre und Varianten werden manchmal als übergeordnete und untergeordnete Elemente bezeichnet.
Sammlungsartikel sind Sets aus Hauptprodukten oder Variantenprodukten, z. B. ein Schmuckset mit einer Halskette, Ohrringen und einem Ring. Sammlungen sind hierarchische Strukturen, die mit Produkten und Varianten vergleichbar sind. Sie gruppieren ähnliche Hauptprodukte. Kunden können sie nicht direkt kaufen, sie werden nicht häufig verwendet und sind nur in der Google Suche verfügbar.

Produktbeispiele

Beispielsweise werden Lebensmittel gemäß diesen Produktbenennungstypen besser als Hauptprodukte katalogisiert, die jeweils aus einer einzelnen SKU bestehen, z. B. "bananas, fresh".

T-Shirts hingegen sollten hierarchisch strukturiert werden, als Hauptelemente 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. So kann der Käufer einen bestimmten primären Artikel (Stil) aufschlüsseln, um die gewünschte Variante (Größe) auszuwählen.

In Sammlungen werden ähnliche Produkte zusammengefasst, die ein Kunde kaufen könnte. Damit sie im Modell für die Neubewertung korrekt berücksichtigt werden, werden ihnen in Vertex AI Search für den Einzelhandel Käufe gutgeschrieben. Beispiel: Ein Käufer klickt auf Produkte in einem Bettwäscheset, fügt sie in den Einkaufswagen oder kauft ein Hauptprodukt in dieser Sammlung. Der Kauf wird der Sammlung gutgeschrieben und das Modell spiegelt die Beliebtheit und den Wert der Sammlungen genau wider.

Es gibt auch einen Katalogtyp, der nur Varianten enthält. Dieser wird jedoch nicht mehr unterstützt. Dieser Katalogtyp kann nur für Empfehlungen verwendet werden. Für den Katalog mit nur Varianten wird ingestionProductType beim Import auf variant gesetzt. Für jede Variante wird eine primäre Variante basierend auf einer für jede Variante angegebenen primären Produkt-ID abgeleitet.

Produktkatalog einrichten

Bei der Planung Ihres Produktkatalogs müssen Sie entscheiden, ob er nur primäre Produkte, primäre Produkte und Varianten oder eine Mischung aus beiden enthält. Stellen Sie sich das in Bezug auf die SKU-Struktur Ihrer Produkte vor. Ihre Produkte können Hauptartikel sein, die mit oder ohne Varianten vorliegen.

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

Sie möchten, dass Ihre SKU als einzelnes Suchergebnis oder Empfehlung angezeigt wird: SKU=primary
Die SKU muss Teil einer Gruppe ähnlicher SKUs sein: SKU=Variante, SKU-Gruppe=primär
Eine Mischung aus beiden Kombinationen: SKU=primär, SKU=Variante, SKU-Gruppe=primär

Wenn auf Ihrer Produktdetailseite eine Auswahl 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 als einzelnes oder als separates Suchergebnis erscheinen sollen. Beispiel: Sie können festlegen, ob eine SKU mit Hardcover und eine SKU mit Softcover desselben Buchs als separate Suchergebnisse (SKU = primär) oder als ein Ergebnis (SKU = Variante, Gruppe von SKUs = primär) erscheinen sollen.

Beachten Sie beim Einrichten Ihres Produktkatalogs, dass in den Empfehlungs- und Suchergebnissen nur primäre Artikel zurückgegeben werden.

Mindestanzahl der Hauptprodukte

Wenn Sie feststellen, dass Ihr Katalog sowohl primäre als auch Varianten enthalten sollte, also Artikelnummergruppen und Artikelnummern, Sie aber derzeit nur Artikelnummern haben, müssen Sie primäre Artikelnummern für die Artikelnummergruppen erstellen. Diese Primärschlüssel werden manchmal auch als „virtuelle Primärschlüssel“ oder „gefälschte Primärschlüssel“ bezeichnet.

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

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

Typ ist unveränderlich

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

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, sondern in Cloud Storage, BigQuery oder einem anderen Speicher befindet, führen Sie einen Bulk-Datenimport durch.

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 Produktinventar umfasst:

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, einschließlich der Verwaltung von Inventardaten, finden Sie unter Inventar für die Vertex AI Search für den Einzelhandel aktualisieren.

Lokales Inventar

Einzelhändler mit Ladengeschäften und einem Onlineshop müssen Inventardaten für jedes Geschäft erfassen. 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, Produktattribute sowie Abhol- und Versandmethoden an jedem Standort

Sie können entweder ein oder beide Felder für Ihre 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, mit denen Vertex AI Search für den Einzelhandel Ihre Produktdaten bewertet. 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 folgende Schema für Vertex AI Search for Retail-Produkte, um eine BigQuery-Tabelle mit dem richtigen Format zu erstellen und mit Ihren Katalogdaten zu laden. Anschließend importieren Sie den Katalog.

Produktschema für Vertex AI Search for Retail

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"
      }
    ]
  }
]