Produktattribute

AI Commerce Search kann Produktattribute für die Indexierung, dynamische Facettierung, Suchbarkeit, Filterung und Modellqualität verwenden. Auf dieser Seite wird beschrieben, 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. Eine Liste aller verfügbaren Systemattribute 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 können beispielsweise Shopnamen, Anbieter oder der Stil gehören. Beispiele und Limits für benutzerdefinierte Attribute finden Sie in der Referenzdokumentation zu Product.attributes.

    Hier einige Beispiele für die 20 wichtigsten benutzerdefinierten Attribute:

    • Produktlinie, zu der dieses Produkt gehört
    • Umsatzvolumen für dieses Produkt im Geschäft
    • Anlass für Kleidung
    • Für dieses Produkt verfügbare Angebote und Gutscheine
    • Websiteweite Produktbeliebtheit

  • Attribute auf Inventarebene: System- oder benutzerdefinierte Attribute, die Informationen zum Produkt auf Geschäftsebene enthalten. Attribute auf Inventarebene können für Produkte verwendet werden, deren Eigenschaften sich je nach Geschäft und Region erheblich unterscheiden, z. B. Lebensmittel, oder für Produkte mit geschäftsspezifischen Angeboten.

    inventories.price und inventories.originalPrice sind numerische Systemattribute, die von AI Commerce Search vordefiniert werden. Sie können benutzerdefinierte Attribute auf Inventarebene erstellen, die Text oder Zahlen enthalten können. Attribute auf Inventarebene sind standardmäßig indexierbar. Die Einstellungen „Suchbar“ und „Als dynamisches Attribut verwendbar“ werden für Attribute auf Inventarebene nicht unterstützt.

Verfügbare Attribut-Einstellungen

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

Konfiguration Beschreibung Systemattribute Benutzerdefinierte Attribute Attribute auf Inventarebene
Sichtbarkeit Dieses Attribut kann über Suchanfragen durchsucht werden, was den Recall für dieses Attribut erhöht (nur Textattribute). Immer an (nur Text) Standardmäßig deaktiviert (kann aktiviert werden; nur Text) Nicht unterstützt
Indexierbarkeit Die Suche kann mit diesem Attribut filtern und facettieren. Immer aktiviert Standardmäßig aktiviert (kann deaktiviert werden) System: immer aktiviert
Benutzerdefiniert: standardmäßig aktiviert (kann deaktiviert werden)
Dynamische Attribute Search kann dieses Attribut automatisch als dynamische Facette auf Grundlage des bisherigen Nutzerverhaltens wie Facetteklicks und -ansichten verwenden (nur Textattribute). Standardmäßig aktiviert (bei indexability = True) (kann deaktiviert werden) Standardmäßig aktiviert (bei indexability = True) (kann deaktiviert werden) Nicht unterstützt
Filterbar
(Vorschau)		 Dieses Attribut kann in Recommendations AI-Filterausdrücken verwendet werden. Diese Einstellung gilt nur für Textattribute. Standardmäßig deaktiviert (kann für Text aktiviert werden, außer für FulfillmentInfo und Title) Standardmäßig deaktiviert (kann für Text aktiviert werden) Wird nur für availability=IN_STOCK unterstützt.
Genaue Übereinstimmung Diese Eigenschaft gilt nur für benutzerdefinierte Textattribute. Damit die genaue Suche aktiviert werden kann, muss „Indexierbar“ aktiviert sein. Nicht unterstützt Standardmäßig deaktiviert (kann aktiviert werden) Nicht unterstützt

Für die Suche werden die folgenden Attributseinstellungen verwendet:

  • Indexierbar: Mit diesem Attribut kann gefiltert und facettiert werden.
  • Dynamische Facettierung: Search kann dieses Attribut automatisch als dynamische Facette auf Grundlage des bisherigen Nutzerverhaltens wie Facetteklicks 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 ist über Suchanfragen suchbar, was die Erinnerung an dieses Attribut erhöht. Dieses Steuerelement gilt nur für Textattribute.
  • Abrufbar: Wenn diese Option auf „true“ gesetzt ist, wird dieses Attribut in Antworten auf Suchanfragen zurückgegeben. Wenn für alle Attribute „Abrufbar“ auf „Falsch“ gesetzt 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 siteweite Steuerelement.

Für Empfehlungen werden die folgenden Attribut-Einstellungen verwendet:

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

Indexierbar

Wenn ein Attribut auf „indexierbar“ gesetzt ist, kann die Suche mithilfe des Attributs filtern und facettieren.

  • 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 einen benutzerdefinierten Attributindex erstellen möchten, muss er dem Muster des regulären Ausdrucks [a-zA-Z0-9][a-zA-Z0-9_]* entsprechen. Beispiel: key0LikeThis oder KEY_1_LIKE_THIS.
  • Attribute auf Inventarebene: Für Systemattribute auf Inventarebene 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 Import von Katalogdaten wirksam. Andernfalls kann es bis zu 12 Stunden oder länger dauern, bis die Änderungen wirksam werden. Auf der Seite Bewerten können Sie prüfen, ob Ihre Änderungen übernommen wurden.

Dynamische Attribuierung

Wenn die dynamische Facettierung für ein Attribut aktiviert ist, kann es von Search als dynamische Facette 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 „true“ gesetzt ist. Sie können die dynamische Facettierung für jedes Systemattribut deaktivieren.
  • Benutzerdefinierte Attribute: Standardmäßig aktiviert, wenn die Indexierbarkeit auf „true“ gesetzt ist. Sie können die dynamische Facettierung für jedes benutzerdefinierte Attribut deaktivieren.
  • Attribute auf Inventarebene: Nicht unterstützt.
  • Abhängigkeiten: Wenn Sie dynamische Facetten 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 prüfen, ob Ihre Änderungen übernommen wurden.

Für numerische benutzerdefinierte Attribute müssen im Request Bereiche angegeben werden. Numerische Werte werden nicht automatisch in Gruppen eingeteilt.

Suchbar

Wenn ein Attribut auf „suchbar“ gesetzt ist, wird der Recall-Wert für dieses Attribut in Suchanfragen verbessert.

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

  • Systemattribute: Vordefinierte Textsystemattribute für Product haben Suchbarkeitseinstellungen, die von AI Commerce Search konfiguriert werden. 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: –
  • Genau durchsuchbar: Bei der gezielten Suche werden Suchergebnisse für Suchanfragen zurückgegeben, die mit einem beliebigen Produkt in Ihrem Katalog übereinstimmen. Diese Option eignet sich gut für Seriennummern. Weitere Informationen zur Option „Genau durchsuchbar“

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

Empfehlungen filtern

Es gibt zwar ein Limit von 10 filterbaren Attributen, die aus Varianten in primäre Produkte für Empfehlungen zusammengefasst werden können. Wenn für ein Attribut jedoch 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 textuellen Systemattribute 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: Werden nur für den Wert availability IN_STOCK unterstützt.
  • Abhängigkeiten: –

Option für die genaue Suche

Sie können der Option exact-searchable, einem Katalogattributfeld, einen bestimmten Wert für bestimmte String-Anfragen zuweisen. Wenn eine Anfrage mit einem Produkt in Ihrem Katalog übereinstimmt, bei dem der Wert für dieses Feld der in der Anfrage angegebene String ist, wird genau dieses Produkt in der Suchanfrage zurückgegeben. Diese Option eignet sich gut für Seriennummern, bei denen Kunden eine gezielte Suche erwarten.

Normalerweise ist das Feld ExactSearchableOption für benutzerdefinierte Attribute für Produktattribute mit einem genauen Wert (z. B. ModelId oder ManufacturerId) nützlich. Attribute wie product_id sind Primärindexfelder, die standardmäßig exakt durchsuchbar sind. Das Feld item_id ist für den genauen Abgleich immer aktiviert und kann nicht deaktiviert werden.

  • Damit bei Suchanfragen keine irrelevanten Artikel zurückgegeben werden, sollten Sie die Option „Durchsuchbar“ niemals auf einen generischen Wert wie battery festlegen.
  • Um zu vermeiden, dass Suchanfragen zu selten ausgeliefert werden, sollten Sie spezielle Felder wie tag, die als Stringwert z. B. „iPhone“ enthalten können, nicht auf „exact-searchable“ (genaue Suche) festlegen. Dies könnte dazu führen, dass die Ergebnisse für alle iPhones im Produktkatalog eingeschränkt werden.

Weitere Informationen zu Produktattributen

Best Practices für die Attributkonfiguration

Diese Best Practices sind wichtig, um zu verstehen, wie Sie Ihre benutzerdefinierten Attribute richtig indexieren. Dabei sollten Sie bestimmte Mechanismen zur Sprachanalyse berücksichtigen, die sich auf die Suchbarkeit auswirken können.

  • Alphanumerische Zeichen (Teilenummern oder Artikelnummern) verarbeiten: Da die standardmäßige linguistische Analyse für natürliche Sprache optimiert ist, werden möglicherweise Sonderzeichen wie Bindestriche (-) aus Teilenummern entfernt (z. B. wird part-123 in part und 123 umgewandelt). Damit diese durchsuchbar sind, müssen Sie das Attributflag exact-searchable verwenden.
  • N-Gramm-Workaround: Bei sehr komplexen Modellnummern mit Sonderzeichen empfiehlt es sich, den String vor der Aufnahme in Ihrer eigenen Datenpipeline in N-Gramme aufzuteilen und den Originalstring in einem benutzerdefinierten Attribut zu speichern, das als exact searchable: true gekennzeichnet ist. Dadurch wird ein strikter Abgleich mit Ihren N-Gramm-Fragmenten erzwungen.
  • Einschränkungen für benutzerdefinierte Attributschlüssel: Benutzerdefinierte Attributschlüssel dürfen keine Bindestriche oder Sonderzeichen enthalten. Damit der Schlüssel indexiert werden kann, muss er genau dem Muster des regulären Ausdrucks [a-zA-Z0-9][a-zA-Z0-9_]* entsprechen. Weitere Informationen finden Sie auf der Seite Informationen zu Produktattributen.
  • UTF-8-Anforderung: Alle Stringattribute und ‑werte müssen gültige UTF-8-codierte Strings sein.

Attributverhalten

Wenn Sie Ihren Produktkatalog mit primären und Variantennamen strukturieren, sollten Sie wissen, wie Produktattribute für die Filterung behandelt werden. Das Verhalten hängt davon ab, ob Sie die Suche oder Empfehlungen verwenden und wie Sie die Katalogtaxonomie konfigurieren.

Damit das Filterverhalten vorhersehbar und genau ist, müssen die Definitionen der filterbaren Attribute für Hauptprodukte und Artikelvarianten einheitlich und vollständig sein. Dieser Ansatz ermöglicht eine präzise Filterung, was die Auffindbarkeit von Produkten und die Relevanz von Suchergebnissen verbessert.

Verhalten von primären Varianten in der Suche im Vergleich zu Empfehlungen

In Such- und Empfehlungsergebnissen werden zwar nur primäre Artikel zurückgegeben, aber mit AI Commerce Search wird die Qualität von Suchanfragen und Empfehlungen optimiert.

  • Bei Suchmodellen werden Variantenattribute für das primäre Produkt im Suchindex verwendet. In den Suchergebnissen werden verschiedene Optionen für das Hauptprodukt basierend auf den Attributen der Varianten angezeigt.

  • Bei Empfehlungsmodellen werden Produktdetails und ‑attribute nicht vom primären Produkt auf die Variante übertragen. Für eine optimale Qualität der Empfehlungen ist es entscheidend, dass primäre Produkte und Artikelvarianten vollständige und korrekte Details für wichtige Attribute wie product.categories, product.title, product.attributes und product.prices haben.

Attribute bei der Indexierung und Filterung verarbeiten

Wenn dasselbe Attribut in Primär und Variante definiert ist, wird das Attribut in der Variante zum Filtern verwendet. Angenommen, ein Attribut ist für ein primäres Produkt und seine Varianten (Farbe oder Größe) definiert. Attributwerte für Varianten dienen hauptsächlich zum Filtern. Dabei wird geprüft, ob eine der Varianten des Primärelements mit dem Attributwert übereinstimmt. Beispiel: Eine primäre Produktverfügbarkeit kann mit out-of-stock gekennzeichnet sein. Wenn jedoch mindestens eine seiner Varianten in-stock ist, ist das primäre Produkt für Suchergebnisse verfügbar, wenn ein in-stock-Filter angewendet wird.

  • Variantenattribute haben beim Filtern Vorrang. Wenn ein Attribut für ein primäres Produkt und seine Varianten definiert ist, wird das Attribut der Variante zum Filtern verwendet. Wenn ein primäres Produkt beispielsweise eine Platzhalterfarbe hat, seine Varianten aber tatsächliche Farben, sollte die Farbe der Variante angegeben und zum Filtern verwendet werden.

  • Bei inventarbezogenen Attributen wie „Verfügbarkeit“ sollte die Verfügbarkeit des primären Produkts auf OUT_OF_STOCK festgelegt werden, wenn es Varianten gibt. Die tatsächliche Verfügbarkeit (z. B. IN_STOCK) sollte auf Variantebene angegeben werden. So gilt das primäre Produkt als auf Lager, solange mindestens eine Variante auf Lager ist. In diesem Fall wird mit Filtern wie availability: ANY("IN_STOCK") das primäre Produkt korrekt zurückgegeben.

  • Wenn ein Filterausdruck verwendet wird, werden in der Vorhersageantwort primäre Produkte zurückgegeben, die mindestens ein primäres Produkt oder eine Artikelvariante enthalten, das dem Attributwert des Filters entspricht.

Optionale Attribute zum Filtern

Halten Sie das Feld categories sauber und optimiert für die Taxonomie. Wenn weitere Filter erforderlich sind, implementieren Sie sie anhand von allgemeinen Kategorien mit separaten benutzerdefinierten Attributen und nicht im Feld categories. Außerdem wird so verhindert, dass sich dies negativ auf das Training der automatischen Vervollständigung für Kategorievorschläge auswirkt.

Angenommen, Sie legen normalerweise Kategorien wie [lvl1, lvl1>lvl2, lvl1>lvl2>lvl3] für die Filterung fest. Bei der automatischen Vervollständigung werden die häufigsten Kategorien für eine bestimmte Anfrage berücksichtigt. Daher werden lvl1 und lvl2 (alle Ihre Produkte) als vorgeschlagene Kategorien angezeigt.

Best Practices für Attributverhalten

Wenn Ihr Katalog aus Haupt- und Artikelvarianten besteht und dasselbe Attribut in beiden definiert ist, wird das Attribut in der Variante beim Filtern berücksichtigt.

  • Attribute korrekt ausfüllen: Sowohl für primäre Produkte als auch für Artikelvarianten müssen vollständige und korrekte Details für die Attribute angegeben werden, insbesondere für die Attribute, die zum Filtern verwendet werden.

  • Integrierte Felder verwenden: Verlassen Sie sich nicht nur auf benutzerdefinierte Attribute. Ordnen Sie Ihre Produktinformationen den integrierten Product-Feldern zu (brands, colors, sizes und den erforderlichen Feldern). Integrierte Felder haben einen größeren Einfluss auf die Suchbarkeit, Indexierbarkeit und Relevanzoptimierung. Benutzerdefinierte Attribute (Product.attributes) sind für Produktdaten vorgesehen, die nicht in vordefinierte Systemattribute passen.

  • Steuerung für abrufbare Felder auf Websiteebene festlegen: Die API unterstützt variantRollupKeys für Varianten, sodass Sie Details in Suchantworten abrufen können.

  • Konsistente Katalogsprache: Der Produktkatalog sollte nur in einer Sprache vorliegen und Suchanfragen sollten in derselben Sprache gesendet werden. Wenn der Katalog mehrere Sprachen enthält, kann dies die Modellleistung beeinträchtigen. Wenn Sie den Sprachcode nicht festlegen, kann dies Funktionen wie die Rechtschreibkorrektur beeinträchtigen.

  • Preisinformationen: Geben Sie für primäre Produkte und Artikelvarianten korrekte Preisinformationen an, damit Empfehlungen und Filter richtig funktionieren. Wenn für ein Produkt keine Preise auf Produktebene vorhanden sind und es nur auf Preisen für lokales Inventar basiert, füllen Sie die Preise des Hauptprodukts mit dem Median der Preise auf Inventarebene aus.

Konfigurationsmodi

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

  • Konfigurationsmodus auf Katalogebene (Standard): In diesem Modus werden Attributkonfigurationen auf Katalogebene als „Source of Truth“ verwendet.
  • Konfigurationsmodus auf Produktebene (eingestellt): In diesem Modus werden Attributkonfigurationen auf Produktebene als „Source of Truth“ 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öchten, wenden Sie sich an den Support. In der Suche ist es nicht möglich, nach dem Wechsel zum Konfigurationsmodus auf Produktebene zurückzukehren.

Rufen Sie in der Console für AI Commerce Search in Gemini Enterprise for Customer Experience die Seite Steuerelemente auf, um den Konfigurationsmodus zu prüfen. Wenn die Option Indexierbar als Spalte auf dem Tab Website-weite Einstellungen verfügbar ist, wird das Konfigurationsmodell auf Katalogebene verwendet. Wenn die Spalte Indexierbar auf dem Tab Websiteübergreifende Einstellungen nicht verfügbar ist, wird das Konfigurationsmodell auf Produktebene verwendet.

Konfigurationsmethoden

Sie können Attributkonfigurationen auf folgende Arten festlegen:

  • AI Commerce Search in der Gemini Enterprise for Customer Experience-Konsole: Legen Sie Attributkonfigurationen auf Katalogebene über die AI Commerce Search in der Gemini Enterprise for Customer Experience-Konsole fest. Damit werden Attribute global für alle Produkte konfiguriert. Welche dieser Einstellungen in der Konsole verfügbar sind, hängt vom Konfigurationsmodus ab. Im nächsten Abschnitt finden Sie weitere Informationen zum Konfigurieren von Attributen in der Console.

  • Die API-Methode AttributeConfig: Legen Sie Attributkonfigurationen auf Katalogebene über die API fest. Damit werden Attribute für alle Produkte konfiguriert.

  • Die API-Methode Product (eingestellt): Mit der API-Methode Product können Sie benutzerdefinierte Attribute auf Produktebene 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 in der Seite „Einstellungen“ der Konsole für AI Commerce Search in Gemini Enterprise for Customer Experience auf dem Tab Website-weite Einstellungen festlegen. Weitere Informationen zum Festlegen dieser Option in der Console finden Sie unter Websiteweite Attributsteuerung verwalten.

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

Änderungen an den Attributkonfigurationseinstellungen für „Indexierbar“ und „Suchbar“ werden sofort bei der Katalogaufnahme wirksam. Andernfalls kann es bis zu 12 Stunden oder länger dauern, bis Ä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 eines Katalogattributs kein Wert vorhanden ist, wird ihm ein Standardwert zugewiesen.

Die maximale Anzahl von Katalogattributen, die in einer Anfrage zulässig sind, beträgt 1.000.

Einzelnes Attribut aktualisieren

Die folgenden Methoden werden verwendet, um einzelne Katalogattribute zu aktualisieren:

  • AddCatalogAttribute: Fügt einem Katalogattribut eine einzelne Attributkonfiguration hinzu.

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

  • ReplaceCatalogAttribute: Ändert eine einzelne Attributkonfiguration. Dadurch wird die angegebene CatalogAttribute in der 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.

    Es können nur CatalogAttributes gelöscht werden, die nicht von Produkten verwendet werden. Wenn ein CatalogAttribute verwendet wird, wird es durch RemoveCatalogAttribute nicht gelöscht, sondern seine Konfigurationseigenschaften werden auf die Standardwerte zurückgesetzt. CatalogAttribute.inUse wird auf True gesetzt, wenn das Attribut von Produkten verwendet wird.

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

Best Practices für die Benennung und Strukturierung benutzerdefinierter Attribute

Wenn Sie Ihre Produktdaten über das vordefinierte Schema hinaus erweitern, wirkt sich die Benennung und Formatierung Ihrer benutzerdefinierten Attribute direkt auf die Fähigkeit von AI Commerce Search aus, Ihre Produkte zu indexieren, abzurufen und zu filtern.

Beachten Sie die folgenden Best Practices, um eine optimale Suchleistung zu erzielen und Validierungsfehler zu vermeiden:

  1. Native Systemattribute zuerst priorisieren: Bevor Sie ein benutzerdefiniertes Attribut erstellen, sollten Sie prüfen, ob für Ihre Daten bereits ein Standard-Systemattribut wie brands, colorInfo, sizes oder materials vorhanden ist. Die Backend-KI-Modelle verstehen Standardfelder viel besser als benutzerdefinierte Attribute und berücksichtigen sie stark bei der Optimierung von Relevanz und Erinnerung.

    • Beispiel: Geben Sie Markeninformationen nicht als Product.attributes.brand an. Ordnen Sie es stattdessen direkt dem Standardfeld Product.brands zu. Speichern Sie benutzerdefinierte Attribute für eindeutig spezifische Daten wie Product.attributes.sleeve_length.

  2. Strikte Namenskonventionen für die Indexierbarkeit einhalten: Wenn Sie ein benutzerdefiniertes Attribut zum Filtern, Facettieren oder Steigern verwenden möchten, muss es als Indexable gekennzeichnet sein. Damit Ihr benutzerdefinierter Attributschlüssel indexierbar ist, muss er dem Muster des regulären Ausdrucks [a-zA-Z0-9][a-zA-Z0-9_]* entsprechen.

    • Gültige Benennung: sleeve_length oder KEY_1_LIKE_THIS.
    • Ungültige Benennung: sleeve-length (Bindestriche sind nicht zulässig und verhindern die Indexierung).
    • Beschränkungen: Der Attributschlüssel muss ein UTF‑8-codierter String mit einer maximalen Länge von 128 Zeichen sein. Ein einzelnes Produkt kann maximal 200 benutzerdefinierte Attribute haben.

  3. Eindeutige Werttypen (Text oder Zahlen) definieren: Bei AI Commerce Search müssen benutzerdefinierte Attributwerte entweder als Text (text) oder als Zahl (numbers) definiert werden. Sie müssen genau einen dieser Typen für einen bestimmten Schlüssel festlegen. Wenn Sie versuchen, sowohl text als auch numbers für dasselbe Attribut anzugeben, wird ein INVALID_ARGUMENT-Fehler zurückgegeben.

    • Textattribute: Bis zu 400 Werte pro Attribut zulässig. Leere Strings ("") sind nicht zulässig. Jeder Wert muss ein nicht leerer UTF-8-String mit einer maximalen Länge von 256 Zeichen sein.
    • Numerische Attribute: Bis zu 400 Werte pro Attribut sind zulässig.
    • Hinweis zu Facetten:Wenn Sie ein numerisches Attribut als dynamicFacet verwenden möchten, müssen Sie den numerischen Datentyp in Ihrer Datenpipeline vor der Aufnahme in einen Text-String umwandeln (z. B. 10.99 als "10.99" übergeben). Andernfalls können numerische Attribute nur als statische Facetten verwendet werden, bei denen Sie Intervall-Buckets im Suchantrag manuell explizit definieren müssen.

  4. Keyword-Option „Genau passend“ strategisch einsetzen Die Konfiguration für die genaue Suche ist für sehr spezifische, alphanumerische Strings ohne sprachliche Bedeutung vorgesehen, z. B. model_name (z. B. "WA2300AH3000") oder part_number.

    • Beispiel: Wenden Sie den genauen Abgleich nicht auf benutzerdefinierte Attribute an, die gängige englische Substantive oder beliebte Marken enthalten. Dadurch werden die Suchergebnisse eingeschränkt, wenn diese häufigen Wörter in einer Suchanfrage vorkommen. Das führt zu einer geringen Produktwiedererkennung und wirkt sich negativ auf die Klickraten (CTR) aus.