Produktattribute

Vertex AI Search für den Einzelhandel kann Produktattribute für Indexierung, dynamische Attribute, Durchsuchbarkeit, Filterung und Modellqualität nutzen. Auf dieser Seite wird erläutert, wie Sie Produktattributkonfigurationen festlegen und wie sie je nach verwendeter Methode und Konfiguration behandelt 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 enthalten. Dazu gehören Produktattribute wie Marke, Verfügbarkeit, Farbe und Größe. Informationen zu allen verfügbaren Systemattributen für Produkte finden Sie in der Referenzdokumentation zu Product.

  • Benutzerdefinierte Attribute: Benutzerdefinierte Attribute sind zusätzliche Attribute, die Sie über das Feld Product.attributes definieren. Dazu gehören beispielsweise Shopnamen, 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 Geschäftsebene liefern. Sie können Attribute auf Inventarebene für Produkte verwenden, deren Eigenschaften sich je nach Geschäft und Region erheblich unterscheiden, z. B. Lebensmittelartikel, oder für Produkte mit geschäftsspezifischen Angeboten.

    inventories.price und inventories.originalPrice sind numerische Systemattribute, die von Vertex AI Search für den Einzelhandel vordefiniert wurden. Sie können benutzerdefinierte Attribute auf Inventarebene erstellen, die im Text- oder numerischen Format vorliegen können. Attribute auf Inventarebene sind standardmäßig indexierbar. Das Festlegen von suchbaren und dynamischen Attributen wird für Attribute auf Inventarebene nicht unterstützt.

Verfügbare Konfigurationseinstellungen

Die Konfigurationseinstellungen für Attribute wirken sich auf das Such- und Empfehlungsverhalten auf Ihrer Website aus.

Die Suche verwendet die folgenden Attributeinstellungen:

  • Indexierbar: Die Suche kann mithilfe dieses Attributs filtern und Attribute erstellen.
  • Dynamische Attribute: Die Suche kann dieses Attribut automatisch als dynamisches Attribut verwenden, das auf dem bisherigen Nutzerverhalten wie Attributklicks und ‐aufrufen basiert. Um das dynamische Attributierung für ein Attribut zu aktivieren, muss indexierbar für dieses Attribut auf „true“ gesetzt werden.
  • Suchbar: Dieses Attribut ist über Suchanfragen suchbar, wodurch die Trefferquote für dieses Attribut erhöht wird. Dieses Steuerelement gilt nur für Textattribute.
  • Abrufbar: Wenn dieser Wert auf „true“ gesetzt ist, gibt die Suche dieses Attribut als Antworten auf Suchanfragen zurück. Wenn „Abrufbar“ für alle Attribute auf „false“ gesetzt ist, enthalten die Suchergebnisse nur den Produktnamen oder (bei Varianten) den Produktnamen und die Farbinformationen.

In Empfehlungen werden die folgenden Attributeinstellungen verwendet:

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

Indexierbar

Wenn ein Attribut auf „Indexierbar“ festgelegt ist, kann die Suche mithilfe des Attributs filtern und Attribute erstellen.

  • Systemattribute: Bei vordefinierten Systemattributen ist die Indexierbarkeit immer aktiviert. Diese Einstellung kann nicht für Systemattribute deaktiviert werden.
  • Benutzerdefinierte Attribute: Standardmäßig aktiviert. Sie können die Indexierbarkeit für jedes benutzerdefinierte Attribut deaktivieren. Wenn Sie ein benutzerdefiniertes Attribut indexierbar machen möchten, muss es dem Regex-Muster [a-zA-Z0-9][a-zA-Z0-9_]* entsprechen. Beispiel: key0LikeThis oder KEY_1_LIKE_THIS.
  • Attribute auf Inventarebene: Diese Einstellung ist für Attribute auf Systeminventarebene immer aktiviert. Diese Einstellung kann nicht geändert werden. Standardmäßig für benutzerdefinierte Attribute auf Inventarebene aktiviert. Diese Einstellung kann deaktiviert werden.
  • Abhängigkeiten: –

Ihre Änderungen an der Indexkonfiguration werden sofort nach dem Importieren von Katalogdaten wirksam. Andernfalls kann es bis zu zwölf Stunden oder länger dauern, bis die Änderungen wirksam werden. Auf der Seite Bewerten können Sie testen, ob Ihre Änderungen übernommen wurden.

Dynamische Attribuierung

Wenn „Dynamische Attribute“ für ein Attribut aktiviert ist, kann die Suche das Attribut als dynamisches Attribut verwenden. Dynamische Attribute lassen sich einer Suche automatisch auf der Grundlage des bisherigen Nutzerverhaltens wie Attributklicks und -ansichten hinzufügen.

  • Systemattribute: Sind standardmäßig aktiviert, wenn die Indexierbarkeit auf „true“ gesetzt ist. Sie können dynamische Attribute für jedes Systemattribut deaktivieren.
  • Benutzerdefinierte Attribute: Standardmäßig aktiviert, wenn die Indexierbarkeit auf „true“ gesetzt ist. Sie können dynamische Attribute für jedes benutzerdefinierte Attribut deaktivieren.
  • Attribute auf Inventarebene: nicht unterstützt
  • Abhängigkeiten: Um dynamische Attribute für ein Attribut zu aktivieren, 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.

Bei numerischen benutzerdefinierten Attributen müssen Buckets in der Anfrage angegeben werden. Numerische Werte werden nicht automatisch gruppiert.

Suchbar

Wenn ein Attribut auf „Suchbar“ gesetzt ist, wird die Recall für dieses Attribut in Suchanfragen verbessert.

Die Sichtbarkeit kann nur für Textattributwerte aktiviert werden. Sie gilt nicht für numerische Attribute.

  • Systemattribute: Die Einstellungen für die Sichtbarkeit vordefinierter Systemattribute in Textform für Product werden von Vertex AI Search für den Einzelhandel konfiguriert. Diese Einstellungen können 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: –

Produkte mit einem durchsuchbaren Attribut erscheinen zwar mit höherer Wahrscheinlichkeit in den Suchergebnissen für dieses Attribut, es kann aber nicht garantiert werden, dass es dort erscheint.

Empfehlungsfilterung

Wenn für ein Attribut die Empfehlungsfilterung aktiviert ist, kann es in Empfehlungsfilterausdrücken verwendet werden, um Produkte in Vorhersagen zu filtern.

  • Systemattribute: Diese sind standardmäßig deaktiviert. Sie können diese Einstellung für alle vordefinierten System-Textattribute für Product aktivieren, mit Ausnahme von FulfillmentInfo und title. Wird für numerische Attribute nicht unterstützt.
  • Benutzerdefinierte Attribute: Diese Option ist standardmäßig deaktiviert. Sie können diese Einstellung für alle benutzerdefinierten Textattribute für Product aktivieren. Wird für numerische Attribute nicht unterstützt.
  • Attribute auf Inventarebene: Diese werden nur für den availability-Wert IN_STOCK unterstützt.
  • Abhängigkeiten: –

Konfigurationsmodi

Der Konfigurationsmodus bestimmt, wie Attributkonfigurationen verarbeitet werden und welche Attributkonfigurationen Sie festlegen.

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

Bisher war die Konfiguration auf Produktebene der Standardmodus. Wenn Sie sich noch im Konfigurationsmodus auf Produktebene befinden und zum Konfigurationsmodus auf Katalogebene wechseln müssen, wenden Sie sich an den Support. Die Suche unterstützt nicht die Rückkehr zum Konfigurationsmodus auf Produktebene, nachdem Sie gewechselt haben.

Rufen Sie die Seite Steuerelemente der Search for Retail-Konsole auf, um den Konfigurationsmodus zu prüfen. Wenn die Option Indexierbar als Spalte auf dem Tab Steuerelemente für die gesamte Website verfügbar ist, entspricht das Konfigurationsmodell auf Katalogebene. Wenn die Spalte Indexierbar auf dem Tab Steuerelemente für die gesamte Website nicht verfügbar ist, erfolgt das Konfigurationsmodell auf Produktebene.

Konfigurationsmethoden

Sie können Attributkonfigurationen auf folgende Arten festlegen:

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

  • Die API-Methode AttributeConfig: Legen Sie mithilfe der API Attributkonfigurationen auf Katalogebene fest. Dadurch werden Attribute für alle Produkte konfiguriert.

  • API-Methode Product (eingestellt): Legen Sie benutzerdefinierte Attribute auf Produktebene mit der API-Methode Product fest. 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 für alle Produkte global festlegen. Rufen Sie dazu in der Search for Retail-Konsole auf dem Tab Steuerelemente für die gesamte Website die Seite Einstellungen auf. Weitere Informationen dazu, wie Sie dies in der Console festlegen, finden Sie unter Websiteweite Attributeinstellungen verwalten.

Damit Sie diese Funktion verwenden können, muss der Konfigurationsmodus auf Katalogebene festgelegt sein.

Änderungen an den Konfigurationseinstellungen für Attribute für „Indexierbar“ und „Suchbar“ werden sofort nach der Katalogaufnahme wirksam. Andernfalls kann es bis zu 12 Stunden oder länger dauern, bis die Änderungen wirksam werden. Auf der Seite Bewerten können Sie testen, ob Ihre Änderungen angewendet wurden.

Attribute mit AttributesConfig konfigurieren

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

In 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 in den Katalog aktualisiert oder eingefügt, wenn sie nicht vorhanden sind. Wenn für ein Katalogattributfeld kein Wert angegeben ist, wird ihm ein Standardwert zugewiesen.

Pro Anfrage sind maximal 1.000 Katalogattribute zulässig.

Einzelnes Attribut aktualisieren

Mit den folgenden Methoden werden einzelne Katalogattribute aktualisiert:

  • AddCatalogAttribute: Einem Katalogattribut wird eine einzelne Attributkonfiguration hinzugefügt.

    Weitere Informationen finden Sie in der API-Referenzdokumentation für AddCatalogAttribute.

  • ReplaceCatalogAttribute: Ändert die Konfiguration einzelner Attribute. Dadurch wird das angegebene CatalogAttribute in AttributesConfig ersetzt, indem das Katalogattribut mit derselben CatalogAttribute.key aktualisiert wird.

    Weitere Informationen finden Sie in der API-Referenzdokumentation für ReplaceCatalogAttribute.

  • RemoveCatalogAttribute: Entfernt eine einzelne Attributkonfiguration aus AttributesConfig.

    Es können nur CatalogAttributes gelöscht werden, die nicht von Produkten verwendet werden. Wenn ein CatalogAttribute verwendet wird, löscht RemoveCatalogAttribute ihn nicht, sondern setzt seine Konfigurationsattribute auf Standardwerte zurück. CatalogAttribute.inUse wird auf True gesetzt, wenn das Attribut von einem Produkt verwendet wird.

    Weitere Informationen finden Sie in der API-Referenzdokumentation für RemoveCatalogAttribute.

Attribute mit der Methode Product konfigurieren (eingestellt)

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 die Einstellungen für „Indexierbar“ und „Suchbar“ für ein bestimmtes Produkt festgelegt: