Automatische Vervollständigung für die Suche

Auf dieser Seite wird die Funktion zur automatischen Vervollständigung und ihre Verwendung vorgestellt. Die Suche bietet eine automatische Vervollständigung, um Händler bei der automatischen Vervollständigung im Suchfeld zu unterstützen.

Die automatische Vervollständigung ist eine Funktion, mit der der Rest einer Abfrage vorhergesagt werden kann, die ein Nutzer eingibt. Dies kann das Sucherlebnis verbessern und den Kaufvorgang vor dem Bezahlen beschleunigen. Außerdem kann damit die Qualität der Suchantworten verbessert und somit höhere Einnahmen erzielt werden, wenn gut formatierte Abfragen bereitgestellt werden.

Überblick

Wenn ein Endnutzer beginnt, einen Suchbegriff auf Ihrer Website einzugeben, kann die Suche eine Liste mit Vorschlägen anzeigen, die der Nutzer möglicherweise sehen möchte. Beispielsweise können „Schuhe“ und „Hemden“ vorgeschlagen werden, wenn der Nutzer „sch“ eingibt.

Datenquelle

Sie können eine der folgenden Datenquellen für Ihre Vorhersagevorschläge auswählen:

  • Ein BigQuery-Dataset, das Sie hochladen.
  • Ein Dataset, das mithilfe von maschinellem Lernen aus Nutzerereignissen und anderen Metadaten generiert wird.

Hochgeladenes Dataset

Eine BigQuery-Vorschlagstabelle, die Sie als Dataset hochladen und die zum Vorschlagen von Abfragen verwendet wird. Informationen zum Hochladen eines Datasets finden Sie unter Daten für die automatische Vervollständigung importieren.

Dataset für automatisches Lernen

Ein durch maschinelles Lernen unterstütztes Vorschlags-Dataset, das durch eine Suche anhand der Suchereignisse von Nutzern generiert wird.

So aktivieren Sie das automatische Lernen:

Console

  1. Zur Seite "Steuerelemente"

  2. Rufen Sie den Tab Steuerelemente für die automatische Vervollständigung auf.

  3. Klicken Sie auf Einstellungen bearbeiten.

  4. Aktivieren Sie Automatisches Lernen.

  5. Klicken Sie auf Einstellungen speichern.

    Es kann ein bis zwei Tage dauern, bis das automatische Lernen aktualisiert wird.

cURL

curl -X PATCH -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "Content-Type: application/json" \
  "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/completionConfig?update_mask.paths=auto_learning"  --data "{auto_learning: true}"

Voraussetzung für das Auto-Learning-Dataset

Durch das automatische Lernen werden Vorschläge basierend auf dem Suchtyp Nutzerereignisse (eventType = „Suche“) generiert. Die Generierung verwendet die Nutzerereignisse der letzten 180 Tage. Sie erfordert eine hohe Qualität und Quantität der importierten Nutzerereignisse.

Beim automatischen Lernen werden seltene Vorschläge herausgefiltert. Wenn die Anzahl der Nutzerereignisse zu niedrig ist (weniger als 20.000), werden unter Umständen viele Vorschlagskandidaten herausgefiltert. In diesem Szenario sollten Sie die Funktion zur automatischen Vervollständigung zuerst mit einer häufigeren Suchanfrage testen.

Releasezeitplan für das Auto-Learning-Dataset

Das Dataset mit automatischem Lernen wird täglich generiert, an die Indexierung übertragen und veröffentlicht. Der vollständige Zyklus dauert etwa zwei Tage.

Funktionen für automatisches Lernen

Bei der Suche werden Techniken des maschinellen Lernens angewendet, um Abfragen und Vorschlagsdaten nur für das Dataset für automatisches Lernen zu bereinigen und zu formatieren.

Feature Beschreibung Beispiel
Sonderzeichen entfernen
  • Entfernen Sie Sonderzeichen aus Vorschlagsdaten und eingegebenen Abfragen. Standardzeichen, die in den Vorschlagsdaten und in eingegebenen Abfragen enthalten sind, sind: %, $, & und . (Punkt).
„Weltbeste #*! Milch“ → „weltbeste Milch“
Suchanfragen ohne Ergebnisse entfernen
  • Suchanfragen ohne Suchergebnisse entfernen
Für Lebensmitteleinzelhändler hat „Gucci Handtaschen“ keine Suchergebnisse und wird daher entfernt
Tippfehler korrigieren
  • Korrektur von Tippfehlern
  • Auch Eingabeabfragen in Echtzeit vor dem Abgleich bereinigen
„Milc“ → „Milch“
Abfragen der Zulassungsliste hinzufügen
  • Abfragen, die Sie explizit zulassen, werden
Weitere Informationen finden Sie unten im Abschnitt Weitere Informationen.
Sperrlistenabfragen entfernen
  • Abfragen, die Sie explizit blockieren, werden entfernt
Weitere Informationen finden Sie unten im Abschnitt Weitere Informationen.
Unsichere Begriffe entfernen
  • Powered by Google Safe Search
  • Unangemessene Suchanfragen entfernen
Sexuelle Inhalte, nicht jugendfreie Inhalte, vulgäre, Gewalt usw.
Sehr seltene Begriffe entfernen
  • Das KI-System passt den Grenzwert je nach Abfragestatistik an
  • Begriffe, die ungewöhnlich selten sind, werden entfernt.
„2 Schicht-Twin-Luftmatratze mit 120-V-Handpumpe (1,8 x 93 x 23 cm)“
Begriffe deduplizieren
  • Unterstützt durch KI-gesteuertes semantisches Verständnis
  • Bei nahezu identischen Begriffen wird jeder Begriff als Übereinstimmung angezeigt, aber nur der beliebteste wird vorgeschlagen
„Schuhe für Damen“, „Damenschuhe“ und „Damenschuhe“ werden dedupliziert, sodass nur einer vorgeschlagen wird.

Vervollständigungsvorschläge erhalten

Verwenden Sie die completeQuery API, um die Vorschläge abzurufen. Beispiel:

cURL

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog:completeQuery?query=sho&dataset=user-data&deviceType=DESKTOP&maxSuggestions=5"

Optionen und Steuerelemente für die automatische Vervollständigung

In diesem Abschnitt werden die Optionen und Steuerelemente für die automatische Vervollständigung erläutert. Eine Übersicht finden Sie in der folgenden Tabelle. Weitere Informationen finden Sie weiter unten.

Kontrolle Details Standort
Sperrliste
  • Entfernt Abfragen manuell aus den Vorschlagsdaten
API-Anfrage: CompletionData:import. Weitere Informationen finden Sie unter Daten zur automatischen Vervollständigung importieren.
Zulassungsliste
  • Fügt den Vorschlagsdaten manuell Abfragen hinzu
API Request: CompletionData:import (siehe auch Import Autocomplete Data )
Mindestlänge zum Auslösen der automatischen Vervollständigung
  • Steuert die Anzahl von Zeichen, bevor die automatische Vervollständigung ausgelöst wird
Cloud Console > Steuerelemente
Abgleichreihenfolge
  • Die Reihenfolge der Übereinstimmungen bestimmt, wie Nutzeranfrage und Vorschläge abgeglichen werden.
Cloud Console > Steuerelemente
Anzahl der Vorschläge
  • Dies ist die Anzahl der Vorschläge, die von der automatischen Vervollständigung zurückgegeben werden
Cloud Console > Steuerelemente oder
API-Anfrage: completeQuery.maxSuggestions
Gerätetyp
  • Wenn Gerätetypen angegeben sind, werden die Vorschläge basierend auf der Beliebtheit der jeweiligen Gerätetypen generiert
  • Wenn Sie dies nicht angeben, werden Vorschläge auf Grundlage der kombinierten Beliebtheit aller Gerätetypen zurückgegeben.
API-Anfrage: completeQuery.deviceType
Datenquelle für Vorschläge
  • Wenn Sie sowohl automatisch generierte als auch hochgeladene Datenquellen haben, können Sie auswählen, welche zum Zeitpunkt der Abfrage verwendet werden soll
API-Anfrage: completeQuery.dataset
Sprache
  • Du kannst angeben, in welchen Sprachen Vorschläge angezeigt werden sollen
API-Anfrage: completeQuery.languageCodes[]

Zulassungsliste (Liste nicht entfernen)

Bei der Suche erfolgt eine Nachbearbeitung, z. B. eine Rechtschreibkorrektur, für Daten zu automatisch vervollständigten Vorschlägen. Dazu erstellen Sie eine Zulassungsliste mit Begriffen, die bei der Nachbearbeitung übersprungen werden.

Begriffe auf der Zulassungsliste werden niemals aus Vorschlägen herausgefiltert. Die Zulassungsliste funktioniert sowohl für hochgeladene Datasets als auch für das Dataset für automatisches Lernen.

Beispiele: Es gibt einige Markennamen mit absichtlich falsch geschriebenen Begriffen, wie z. B. "Froot Loops" anstelle von "Fruit" oder "Foot". Eine ausführliche Upload-Anleitung finden Sie unter Abschlussdaten für den Import.

Für den Datenimport können Sie Cloud Console > Steuerung > Autocomplete-Steuerelemente > Liste nicht entfernen verwenden oder CompletionData:import verwenden.

Die Änderungen werden nach etwa zwei Tagen wirksam.

Sperrliste

Die Sperrliste funktioniert nur für Datasets für automatisches Lernen. Die Sperrliste funktioniert nicht für hochgeladene Datasets.

Die Begriffe auf einer Sperrliste werden nie in Vorschlägen angezeigt.

Verwenden Sie zum Importieren einer Sperrliste Cloud Console > Steuerelemente > Autocomplete-Steuerelemente > Ablehnungsliste oder die API CompletionData:import. Eine ausführliche Anleitung zum Importieren einer Sperrliste finden Sie unter Abschlussdaten importieren.

Die Änderungen werden nach etwa zwei Tagen wirksam.

Mindestlänge zum Auslösen

Sie können die Anzahl der erforderlichen Zeichen festlegen, bevor Abfragen durch die automatische Vervollständigung Ergebnisse zurückgeben. Sie finden die Einstellung unter Cloud Console > Steuerung > Steuerelemente für die automatische Vervollständigung > Mindestlänge zum Auslösen.

Änderungen treten sofort in Kraft.

Abgleichreihenfolge

Dadurch wird festgelegt, wie Vorschläge mit von Nutzern eingegebenen Begriffen abgeglichen werden.

Wenn die Option auf „Vorschlag beginnt mit dem Begriff“ festgelegt ist, gleicht die automatische Vervollständigung den vom Nutzer eingegebenen Begriff als exaktes Präfix den Vorschlägen ab. Die Nutzereingabe „sh“ stimmt beispielsweise mit den Vorschlägen „schuhe“ und „hemden“ überein, aber nicht mit den Vorschlägen „rote schuhe“.

Wenn die Option auf „Vorschlag kann an einer beliebigen Stelle im Begriff beginnen“ festgelegt ist, tokenisiert die automatische Vervollständigung den Nutzereingabebegriff in Wörter und gleicht ihn unabhängig von der Wortreihenfolge mit den Wörtern in Vorschlägen ab. Der vom Nutzer eingegebene Begriff „rote sh“ stimmt beispielsweise mit den Vorschlägen „hemden rot“, „rote schuhe“ und „rote schuhe für kinder“ überein. Der Eingabebegriff "hoes" stimmt jedoch nicht mit diesen Vorschlägen überein, da keines der Wörter in den Vorschlägen mit "hoes" beginnt.

Sie finden die Einstellung in der Cloud Console unter Steuerelemente > Steuerelemente für die automatische Vervollständigung > Reihenfolge der Übereinstimmung.

Änderungen treten sofort in Kraft.

Anzahl der Vorschläge

Dies ist die Anzahl der Vorschläge, die bei Abfragen mit automatischer Vervollständigung zurückgegeben werden. Sie darf 20 nicht überschreiten. Die Einstellung finden Sie in der Cloud Console unter Steuerelemente > Autocomplete-Steuerelemente > Vorschläge (Anzahl). Sie können sie aber auch in completeQuery festlegen.

Änderungen treten sofort in Kraft.

Gerätetyp

Die automatische Vervollständigung der Suche unterstützt verschiedene Gerätetypen, z. B. MOBILE und DESKTOP. Sie können je nach Gerätetyp verschiedene Vorschläge hochladen oder abrufen. Wenn deviceType in completeQuery nicht angegeben ist, gilt der Vorschlag für alle Gerätetypen.

Für ein Dataset mit automatischem Lernen, das auf Nutzerereignissen der Suche basiert, legen Sie user_agent in UserEvent.user_info fest, um verschiedene Gerätetypen zu unterstützen. Siehe User-Agent im Wiki.

Erweiterte Funktionen

In diesem Abschnitt werden die erweiterten Funktionen der automatischen Vervollständigung für die Suche beschrieben. Sie können beispielsweise Vorschläge für die automatische Vervollständigung von Abfragen durch andere Vorschläge wie Marken und Kategorien ergänzen.

Diese erweiterten Funktionen sind nur für Datasets mit automatischem Lernen verfügbar.

FeatureSet für Vorschläge

Für jeden Begriff der vorgeschlagenen Suchanfrage wird ein zusätzliches FeatureSet bereitgestellt, damit Kunden erweiterte Funktionen auf ihren Websites anzeigen können.

Das FeatureSet wird in der Antwort als Schlüsselwertzuordnung angezeigt. Derzeit gibt Vertex AI Search for Retail zu jedem Abfragevorschlag in der API-Antwort completeQuery.completionResults.attributes bis zu fünf beliebte Kategorien und Marken zurück. FeatureSet-Vorschläge müssen nicht mit den vom Endnutzer eingegebenen Abfragestrings übereinstimmen.

Sie können das FeatureSet in der Antwort verwenden, um Suchvorschläge anzureichern. Beispiel:

  • Aggregieren und erstellen Sie die Bereiche „Beliebte Marken“ und „Beliebte Kategorien“, die unter der Liste mit Suchvorschlägen angezeigt werden.
  • Blenden Sie die beliebteste Marke oder Kategorie neben den Suchbegriffen ein.

Nachdem Sie Änderungen am Katalog vorgenommen, z. B. Kategorien für Produkte geändert haben, sollten Sie zwei Wochen bis 30 Tage warten, bis die FeatureSet-Vorschläge die Änderungen des Produktkatalogs widerspiegeln. Das liegt daran, dass beim automatischen Lernen die Suchereignisdaten der letzten 30 Tage trainiert werden.

Attributvorschläge

Die Suche liefert Attributvorschläge, die mit Nutzereingabestrings übereinstimmen. Unterstützte Typen für Attributvorschläge sind Marken und Kategorien.

Attributvorschläge unterscheiden sich von einem FeatureSet. Attributvorschläge sind Listen vorgeschlagener Produktattribute (z. B. Marken und Kategorien), ähnlich wie Anfragevorschläge sind Listen mit vorgeschlagenen Abfragen. Attributvorschläge können unabhängig von Abfragevorschlägen verwendet werden. Ein FeatureSet zum Vorschlagen umfasst Metadaten für einen Abfragevorschlag und ist daher von Abfragevorschlägen abhängig.

Attributvorschläge können verwendet werden, um Marken oder Kategorien, die ein Endnutzer eingibt, automatisch in separaten Abschnitten unter der Liste mit Suchvorschlägen zu vervollständigen.

Vorschlagsattribut mit Produktanzahl (experimentell)

Dies ist eine experimentelle Funktion, die nur für bestimmte Kunden verfügbar ist. Wenden Sie sich an das Supportteam, um sie zu verwenden.

Wenn das Vorschlagsattribut mit der Funktion zum Zählen von Produkten aktiviert ist, liefert der zurückgegebene completeQuery.completionResults eine Liste mit Vorschlägen zur automatischen Vervollständigung, aber auch die Produktzahlen für jeden Vorschlag mit der Gesamtzahl und Produktanzahl nach Attribut (z. B. „Farbe“ oder „Kategorie“).

Wenn die Suchanfrage beispielsweise „Schuh“ ist, werden die Vorschläge der automatischen Vervollständigung wie folgt zurückgegeben:

  • damen schuhe
  • herren schuhe

Wenn der relevante Attributschlüssel „Farbe“ lautet, werden bei jedem Autocomplete-Vorschlag auch eine Produkt- und eine Produktanzahl nach Farbe zurückgegeben:

  • damenschuhe (32)
    • Schwarz (10)
    • Taupe (16)
    • Weiß (10)
  • Herrenschuhe (43)
    • Schwarz (10)
    • Braun (5)
    • Grün (17)

Als Einzelhändler musst du dem Käufer die Produktanzahl nicht vorlegen. Du kannst die Liste aber anhand der Anzahl der Produkte und nicht anhand der in completeQuery.completionResults zurückgegebenen Bestellung sortieren. Sie könnten z. B. Käufer anregen, nach grünen Schuhen für Herren zu suchen, indem Sie grüne Schuhe oben im Vorschlagsfeld anzeigen lassen, obwohl diese nicht der beliebteste Artikel sind.

Beispiel:

{
  "completion_results": [{ 
    "suggestion": "womens shoes"
    "facets": [ 
      {
        "key": "color"
        "values": [ 
          {
            "value": "black"
            "count": 10
          }
          {
            "value": "taupe"
            "count": 16
          }
          {
            "value": "white"
            "count": 10
          }
        ]
      }
    ]
    "total_product_count": 32
  },
  (...)
  ],
}

Die Informationen zur Attributanzahl werden für jede vorgeschlagene Suchanfrage in completeQuery.completionResults.facets als Liste von Facets angezeigt. Jedes Attribut hat eine FacetValues-Liste, die die Produktanzahl pro Attributwert enthält. Die Gesamtzahl der Produkte für jede vorgeschlagene Suchanfrage wird in completeQuery.completionResults.totalProductCount zurückgegeben.

Gehen Sie so vor, um Vorschlagsattribute mit Produktzahlen zu aktivieren und zu verwenden:

  1. Bitten Sie das Supportteam, das Feature „Vorschlagsattribut mit Anzahl der Produkte“ zu aktivieren. Geben Sie an, für welche FacetKeys die Anzahl der Produkte angezeigt werden soll. Es sind nur textual_fields Attribute zulässig.

  2. Achten Sie darauf, dass Sie bei Verwendung der search API mindestens 7 Tage lang den Attributschlüssel in FacetSpecs und den Attributschlüssel in search.searchRequest.facetSpecs einbeziehen.

    Diese Wartezeit ist darauf zurückzuführen, dass Attributinformationen anhand der Suchverlaufsdaten der letzten Woche berechnet werden.

  3. Nachdem die Funktion für Sie aktiviert wurde, enthalten die zurückgegebenen Vorschläge der completeQuery API die Produktanzahl nach Attribut und Vorschlag.

Vorschlag nach Entität gefiltert

Mit Entitäten können Sie Suchvorschläge mit automatischer Vervollständigung filtern. Eine Entität kann eine Website einer anderen Marke oder Region sein. Die automatische Vervollständigung soll das Verhalten der Nutzer, die die jeweilige Marke oder regionale Website kaufen, bestmöglich widerspiegeln. Weitere Informationen zu Entitäten finden Sie unter Entitäten.

So schließen Sie Entitäten in Vorschläge für die automatische Vervollständigung ein:

  1. Fügen Sie das Feld entity in die Nutzerereignisse der Suche ein (eventType = „search“). Weitere Informationen findest du im vollständigen Objektbeispiel für das Nutzerereignis Search.

  2. Legen Sie das Feld entity in der CompleteQuery API-Anfrage fest, um nur Vorschläge für diese Entität zu erhalten.

    Der Entitätsstring in den Nutzerereignissen und API-Anfragen muss genau übereinstimmen. Andernfalls gibt die automatische Vervollständigung leere Vorschläge zurück.

In der Regel dauert es 30 bis 90 Tage an Nutzerereignisdaten, bis die Entitätsfunktion optimale Vorschläge für die automatische Vervollständigung zurückgeben kann.