Produktattribute

Vertex AI Search for Retail kann Produktattribute für die Indexierung, die dynamische Attributierung, 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. , die weitere Informationen zum Produkt enthalten. 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 Beschränkungen für benutzerdefinierte Attribute finden Sie unter die Referenzdokumentation zu Product.attributes

  • Attribute auf Inventarebene: Systemattribute oder benutzerdefinierte Attribute, mit denen Informationen zum Produkt im jeweiligen Geschäft. Sie können Inventarebene Attribute für Produkte, deren Eigenschaften sich zwischen den Geschäften und Regionen, wie z. B. für Lebensmittel, oder für Produkte, die geschäftsspezifische Werbeaktionen

    inventories.price und inventories.originalPrice sind numerische Systeme Attribute, die in Vertex AI Search for Retail vordefiniert sind. Sie können benutzerdefinierte auf Inventarebene festlegen, die text- oder numerisch sein können. Inventarebene Attribute sind standardmäßig indexierbar. Durchsuchbare und dynamische Attribute festlegen wird für Attribute auf Inventarebene nicht unterstützt.

Verfügbare Konfigurationseinstellungen

Konfigurationseinstellungen von Attributen wirken sich auf das Such- und Empfehlungsverhalten aus auf Ihrer Website.

Die Google Suche verwendet die folgenden Attributeinstellungen:

  • Indexierbar: Die Suche kann mit diesem Attribut filtern und facettieren.
  • 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 die Richtlinie auf „true“ gesetzt ist, gibt die Suche Folgendes zurück: in Antworten auf Suchanfragen. 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 eingestellt. Verwenden Sie stattdessen das websiteweite Steuerelement „Abrufbar“.

Für Empfehlungen werden die folgenden Attributeinstellungen verwendet:

  • Filterbar (öffentliche Vorschau): Dieses Attribut kann in Empfehlungen verwendet werden. Filterausdrücken. 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: Diese Option ist standardmäßig aktiviert. Sie können die Indexierung für ein beliebiges benutzerdefiniertes Attribut. Wenn Sie benutzerdefinierte Attribute indexierbar machen möchten, muss dem Regex-Muster „[a-zA-Z0-9][a-zA-Z0-9_]*“ entsprechen. Beispiel: key0LikeThis oder KEY_1_LIKE_THIS.
  • Attribute auf Inventarebene: Immer aktiviert für Systeminventarebene Attribute kann diese Einstellung 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 Import der 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 „Indexierbarkeit“ auf „wahr“ gesetzt ist. Ich kann dynamische Attribute für jedes benutzerdefinierte Attribut deaktivieren.
  • Attribute auf Inventarebene: Nicht unterstützt.
  • Abhängigkeiten: Um die dynamische Attributsuche für ein Attribut zu aktivieren, müssen Sie zuerst die Indexierbarkeit für dieses Attribut zu 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 gruppiert.

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: Vordefinierte Textsystemattribute für Product haben Einstellungen für die Sichtbarkeit, die von Vertex AI Search for Retail konfiguriert wurden. 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: –

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 Empfehlungsfilterung aktiviert ist, kann es in Empfehlungsfilterausdrücken 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: 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: Wird nur für den Wert availability unterstützt. IN_STOCK.
  • Abhängigkeiten: –

Konfigurationsmodi

Der Konfigurationsmodus bestimmt, wie behandelt werden und welche Attributkonfigurationen festgelegt.

  • Konfigurationsmodus auf Katalogebene (Standardeinstellung): In diesem Modus Attributkonfigurationen auf Katalogebene auf Katalogebene werden als die „Source of Truth“.
  • 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. Suche unterstützt nicht die Rückkehr zum Konfigurationsmodus auf Produktebene, gewechselt.

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

Konfigurationsmethoden

Sie haben folgende Möglichkeiten, Attributkonfigurationen festzulegen:

  • Search for Retail-Konsole: Legen Sie fest, Attributkonfigurationen auf Katalogebene mithilfe des Search for Retail-Konsole. 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 mit der API-Methode Product auf Produktebene festlegen. Attribute mit diesem Attribut festlegen ist für neue Nutzer nicht verfügbar wird empfohlen.

Attribute in der Konsole konfigurieren

Attributoptionen können global für alle Produkte über die Search for Retail-Konsole Seite Einstellungen in der Websiteweite Einstellungen. Weitere Informationen zum in der Konsole finden Sie unter Websiteweite Attributeinstellungen verwalten

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

Änderungen an den Konfigurationseinstellungen für Attribute für indexierte und suchbare Seiten unmittelbar nach der Katalogaufnahme. Andernfalls kann es bis zu 12 Stunden dauern, damit 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:

Um alle Attributkonfigurationen abzurufen, verwenden Sie die Methode GetAttributesConfig-Methode.

Mehrere Attribute aktualisieren

Verwenden Sie zum Aktualisieren die Methode updateAttributesConfig. mehrere Attribute auf Katalogebene.

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

Die maximal zulässige Anzahl von Katalogattributen in einer Anfrage beträgt 1.000.

Einzelnes Attribut aktualisieren

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

  • AddCatalogAttribute: Fügt einer einzelnen Attributkonfiguration eine Katalogattribut.

    In der API-Referenzdokumentation finden Sie AddCatalogAttribute

  • ReplaceCatalogAttribute: Ändert die Konfiguration einzelner Attribute. Dadurch wird die angegebene CatalogAttribute in der AttributesConfig durch Aktualisieren des Katalogattributs mit derselben CatalogAttribute.key.

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

  • RemoveCatalogAttribute: entfernt eine einzelne Attributkonfiguration von AttributesConfig.

    Es können nur CatalogAttributes gelöscht werden, die nicht von Produkten verwendet werden. Wenn ein CatalogAttribute wird verwendet, wird aber durch RemoveCatalogAttribute nicht gelöscht, setzt seine Konfigurationsattribute auf die Standardwerte zurück. 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 (eingestellt)

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

Mit den folgenden Feldern werden die Einstellungen für indexierbare und suchbare Elemente für ein bestimmtes über die API-Methode Product: