Produktattribute

Vertex AI Search for Retail kann Produktattribute für die Indexierung, die dynamische Darstellung, die Suchbarkeit, die Filterung und die Modellqualität nutzen. Auf dieser Seite wird erläutert, wie Sie Produktattributkonfigurationen festlegen und wie sie je nach verwendeter Methode und Konfiguration angewendet werden.

Attributtypen

Produktattribute können je nach Typ unterschiedliche Standardeinstellungen und zulässige Optionen haben.

  • Systemattribute: Vordefinierte Systemattribute sind vorhandene Product Felder, die weitere Informationen zum Produkt liefern. Dazu gehören Produktattribute wie Marke, Verfügbarkeit, Farbe und Größe. Eine vollständige Liste der verfügbaren Systemattribute für Produkte finden Sie in der Product-Referenzdokumentation.

  • Benutzerdefinierte Attribute: Benutzerdefinierte Attribute sind zusätzliche Attribute, die Sie mit dem Feld Product.attributes definieren. Dazu gehören beispielsweise Geschäftsnamen, Anbieter oder Stil. Beispiele und Limits für benutzerdefinierte Attribute finden Sie in der Referenzdokumentation zu Product.attributes.

  • Attribute auf Inventarebene: System- oder benutzerdefinierte Attribute, die Informationen zum Produkt auf Ladengeschäftsebene liefern. Attribute auf Inventarebene eignen sich für Produkte, deren Eigenschaften sich zwischen Geschäften und Regionen stark unterscheiden, z. B. Lebensmittel, oder für Produkte mit geschäftsspezifischen Angeboten.

    inventories.price und inventories.originalPrice sind numerische Systemattribute, die von Vertex AI Search for Retail vordefiniert wurden. Sie können benutzerdefinierte Attribute auf Inventarebene erstellen, die textbasiert oder numerisch sein können. Attribute auf Inventarebene sind standardmäßig indexierbar. Die Einstellung „Suchbar“ und „Dynamische Facetten“ wird für Attribute auf Inventarebene nicht unterstützt.

Verfügbare Konfigurationseinstellungen

Die Einstellungen für die Attributekonfiguration wirken sich auf das Such- und Empfehlungsverhalten Ihrer gesamten Website aus.

Für die Suche werden die folgenden Attributeinstellungen verwendet:

  • Indexierbar: Die Suche kann mit diesem Attribut gefiltert und facettiert werden.
  • Dynamische Attributierung: Die Suche kann dieses Attribut automatisch als dynamisches Attribut auf Grundlage des bisherigen Nutzerverhaltens wie Attributklicks und -ansichten verwenden. Um das dynamische Attributierung für ein Attribut zu aktivieren, muss indexierbar für dieses Attribut auf „true“ gesetzt werden.
  • Suchbar: Dieses Attribut kann für Suchanfragen verwendet werden. Damit wird die Trefferquote für dieses Attribut erhöht. Dieses Steuerelement gilt nur für Textattribute.
  • Abrufbar: Wenn diese Option aktiviert ist, wird dieses Attribut in Suchantworten zurückgegeben. Wenn für alle Attribute „Abrufbar“ auf „falsch“ festgelegt ist, enthalten die Suchergebnisse nur den Produktnamen oder (bei Varianten) den Produktnamen und die Farbinformationen. Das REST-Feld „RetrievableFields“ wird für Produkte nicht mehr unterstützt. Verwenden Sie stattdessen das abrufbare websiteweite Steuerelement.

Für Empfehlungen werden die folgenden Attributeinstellungen verwendet:

  • Filterbar (öffentliche Vorabversion): Dieses Attribut kann in Filterausdrücken für Empfehlungen verwendet werden. Dieses Steuerelement gilt nur für Textattribute.

Indexierbar

Wenn ein Attribut auf „indexierbar“ gesetzt ist, kann die Suche mithilfe des Attributs gefiltert und facettiert werden.

  • Systemattribute: Die Indexierbarkeit ist für vordefinierte Systemattribute immer aktiviert. Diese Einstellung kann für Systemattribute nicht deaktiviert werden.
  • Benutzerdefinierte Attribute: Standardmäßig aktiviert. Sie können die Indexierbarkeit für jedes benutzerdefinierte Attribut deaktivieren. Wenn Sie benutzerdefinierte Attribute indexierbar machen möchten, müssen sie dem regulären Ausdruck [a-zA-Z0-9][a-zA-Z0-9_]* entsprechen. Beispiel: key0LikeThis oder KEY_1_LIKE_THIS.
  • Attribute auf Inventarebene: Diese Einstellung ist immer für Attribute auf Inventarebene aktiviert und kann nicht geändert werden. Standardmäßig für benutzerdefinierte Attribute auf Inventarebene aktiviert; diese Einstellung kann deaktiviert werden.
  • Abhängigkeiten: –

Änderungen an der Indexkonfiguration werden sofort nach dem Importieren von Katalogdaten wirksam. Andernfalls kann es bis zu 12 Stunden dauern, bis die Änderungen wirksam werden. Auf der Seite Bewerten können Sie testen, ob Ihre Änderungen angewendet wurden.

Dynamische Attribuierung

Wenn die dynamische Attributierung für ein Attribut aktiviert ist, kann es in der Suche als dynamisches Attribut verwendet werden. Dynamische Attribute lassen sich einer Suche automatisch auf der Grundlage des bisherigen Nutzerverhaltens wie Attributklicks und -ansichten hinzufügen.

  • Systemattribute: Standardmäßig aktiviert, wenn die Indexierbarkeit auf „wahr“ gesetzt ist. Sie können die dynamische Attributierung für jedes Systemattribut deaktivieren.
  • Benutzerdefinierte Attribute: Standardmäßig aktiviert, wenn die Indexierbarkeit auf „wahr“ gesetzt ist. Sie können die dynamische Attributierung für jedes benutzerdefinierte Attribut deaktivieren.
  • Attribute auf Inventarebene: Nicht unterstützt.
  • Abhängigkeiten: Wenn Sie die dynamische Attributsuche für ein Attribut aktivieren möchten, müssen Sie zuerst die Indexierbarkeit für dieses Attribut aktivieren.

Die Festlegung der dynamischen Attribuierung für ein Attribut ist immer global. Die dynamische Attribuierungskonfiguration, die Sie auf dieses Attribut anwenden, wird von Produkten im Katalog verwendet, die dieses Attribut verwenden.

Änderungen der Konfiguration der dynamischen Attributierung dauern bis zu zwei Tage. Auf der Seite Bewerten können Sie testen, ob Ihre Änderungen angewendet wurden.

Für numerische benutzerdefinierte Attribute müssen in der Anfrage Buckets angegeben werden. Numerische Werte werden nicht automatisch in Gruppen zusammengefasst.

Suchbar

Wenn ein Attribut suchbar ist, wird die Trefferquote für dieses Attribut in Suchanfragen verbessert.

Die Suchbarkeit kann nur für Werte von Textattributen aktiviert werden. Sie ist nicht auf numerische Attribute anwendbar.

  • Systemattribute: Die Einstellungen für die Suchbarkeit vordefinierter Textsystemattribute für Product werden von Vertex AI Search for Retail konfiguriert. Diese Einstellung kann nicht geändert werden.
  • Benutzerdefinierte Attribute: Standardmäßig deaktiviert. Sie können diese Konfiguration für jedes benutzerdefinierte Textattribut aktivieren.
  • Attribute auf Inventarebene: Nicht unterstützt.
  • Abhängigkeiten: –
  • Genau passend: Bei der gezielten Suche werden Suchanfragen zurückgegeben, die mit einem bestimmten Produkt in Ihrem Katalog übereinstimmen. Diese Option eignet sich gut für Seriennummern. Weitere Informationen zur Option „Genau passend“

Produkte mit einem suchbaren Attribut werden zwar mit höherer Wahrscheinlichkeit in den Suchergebnissen für dieses Attribut angezeigt, aber nicht garantiert.

Filterung von Empfehlungen

Wenn für ein Attribut die Filterung von Empfehlungen aktiviert ist, kann es in Filterausdrücken für Empfehlungen verwendet werden, um Produkte in Vorhersagen zu filtern.

  • Systemattribute: Standardmäßig deaktiviert. Sie können diese Einstellung für alle vordefinierten systeminternen Textattribute für Product aktivieren, mit Ausnahme von FulfillmentInfo und title. Für numerische Attribute nicht unterstützt.
  • Benutzerdefinierte Attribute: Standardmäßig deaktiviert. Sie können diese Einstellung für alle benutzerdefinierten Textattribute für Product aktivieren. Für numerische Attribute nicht unterstützt.
  • Attribute auf Inventarebene: Unterstützt nur für den availability-Wert IN_STOCK.
  • Abhängigkeiten: –

Konfigurationsmodi

Der Konfigurationsmodus bestimmt, wie Attributkonfigurationen angewendet werden und welche Attributkonfigurationen Sie festlegen können.

  • Konfigurationsmodus auf Katalogebene (Standardeinstellung): In diesem Modus werden Attributkonfigurationen auf Katalogebene als „Source of Truth“ verwendet.
  • Konfigurationsmodus auf Produktebene (veraltet): In diesem Modus werden Attributkonfigurationen auf Produktebene als „Source of Truth“ verwendet.

Bisher war die Konfiguration auf Produktebene der Standardmodus. Wenn Sie noch den Konfigurationsmodus auf Produktebene haben und zum Konfigurationsmodus auf Katalogebene wechseln müssen, wenden Sie sich an den Support. Nach dem Wechsel ist keine Rückkehr zum Konfigurationsmodus auf Produktebene möglich.

Den Konfigurationsmodus finden Sie auf der Seite Einstellungen der Retail Search Console. Wenn die Option Indexierbar auf dem Tab Websiteweite Steuerelemente als Spalte verfügbar ist, ist das Konfigurationsmodell auf Katalogebene. Wenn die Spalte Indexierbar auf dem Tab Websiteweite Steuerelemente nicht verfügbar ist, gilt das Konfigurationsmodell für die Produktebene.

Konfigurationsmethoden

Sie haben folgende Möglichkeiten, Attributkonfigurationen festzulegen:

  • Retail Search Console: Mit der Retail Search Console können Sie Attributkonfigurationen auf Katalogebene festlegen. Dadurch werden Attribute global für alle Produkte konfiguriert. Welche dieser Einstellungen in der Konsole verfügbar sind, hängt vom Konfigurationsmodus ab.

  • Die API-Methode AttributeConfig: Sie können Attributkonfigurationen mithilfe der API auf Katalogebene festlegen. Dadurch werden Attribute für alle Produkte konfiguriert.

  • Die API-Methode Product (veraltet): Sie können benutzerdefinierte Attribute auf Produktebene mit der API-Methode Product festlegen. Das Festlegen von Attributen mit dieser Methode ist für neue Nutzer nicht verfügbar und wird nicht empfohlen.

Attribute in der Console konfigurieren

Sie können Attributoptionen global für alle Produkte über die Retail-Konsole auf der Seite Steuerelemente auf dem Tab Websiteweite Steuerelemente festlegen. Weitere Informationen zum Festlegen in der Konsole finden Sie unter Websiteweit Steuerelemente für Attribute verwalten.

Um diese Funktion verwenden zu können, muss der Konfigurationsmodus auf Katalogebene sein.

Änderungen an der Attributkonfiguration für indexierbare und suchbare Attribute werden sofort nach der Katalogaufnahme wirksam. Andernfalls kann es bis zu 12 Stunden dauern, bis die Änderungen wirksam werden. Auf der Seite Bewerten können Sie testen, ob Ihre Änderungen übernommen wurden.

Attribute mit AttributesConfig konfigurieren

Mit der AttributesConfig API-Ressource können Sie Attributkonfigurationen auf Katalogebene verwalten.

Mit den folgenden Feldern werden Attributoptionen auf Katalogebene festgelegt:

Verwenden Sie die Methode GetAttributesConfig, um alle Attributkonfigurationen abzurufen.

Mehrere Attribute aktualisieren

Verwenden Sie die Methode updateAttributesConfig, um mehrere Attribute auf Katalogebene zu aktualisieren.

Die Katalogattribute, die Sie in die Anfrage aufnehmen, werden im Katalog aktualisiert oder eingefügt, falls sie nicht vorhanden sind. Wenn für ein Feld mit einem Katalogattribut kein Wert angegeben ist, wird ihm ein Standardwert zugewiesen.

In einer Anfrage sind maximal 1.000 Katalogattribute zulässig.

Einzelnes Attribut aktualisieren

Mit den folgenden Methoden können Sie einzelne Katalogattribute aktualisieren:

  • AddCatalogAttribute: Hiermit wird einem Katalogattribut eine individuelle Attributkonfiguration hinzugefügt.

    Weitere Informationen finden Sie in der API-Referenzdokumentation zu AddCatalogAttribute.

  • ReplaceCatalogAttribute: Hiermit wird die Konfiguration eines einzelnen Attributs geändert. Dadurch wird die angegebene CatalogAttribute in AttributesConfig ersetzt, indem das Katalogattribut mit derselben CatalogAttribute.key aktualisiert wird.

    Weitere Informationen finden Sie in der API-Referenzdokumentation zu ReplaceCatalogAttribute.

  • RemoveCatalogAttribute: Entfernt eine einzelne Attributkonfiguration aus AttributesConfig.

    Nur CatalogAttributes, die von Produkten nicht verwendet werden, können gelöscht werden. Wenn eine CatalogAttribute bereits verwendet wird, wird sie durch RemoveCatalogAttribute nicht gelöscht, sondern ihre Konfigurationseigenschaften werden auf die Standardwerte zurückgesetzt. CatalogAttribute.inUse ist auf True festgelegt, wenn das Attribut von Produkten verwendet wird.

    Weitere Informationen finden Sie in der API-Referenzdokumentation zu RemoveCatalogAttribute.

Attribute mit der Methode Product konfigurieren (veraltet)

Das Festlegen von Attributen mit dieser Methode ist für neue Nutzer nicht verfügbar und wird nicht empfohlen.

In den folgenden Feldern werden über die API-Methode Product Einstellungen für indexierbare und suchbare Produkte festgelegt: