Automatische Vervollständigung für die Suche

Auf dieser Seite wird die Funktion und Verwendung der automatischen Vervollständigung erläutert. Search bietet eine automatische Vervollständigung der Suchbegriffe mit bestimmten Vorschlägen.

Die automatische Vervollständigung ist eine Funktion zur Vorhersage der restlichen Anfrage, die ein Nutzer eingibt. Dies kann die Nutzerfreundlichkeit verbessern und den Einkaufsprozess vor dem Bezahlen beschleunigen. Außerdem kann die Qualität der Suchantworten verbessert und so der Umsatz gesteigert werden, indem gut formatierte Anfragen bereitgestellt werden.

Übersicht

Wenn ein Endnutzer beginnt, einen Suchbegriff auf Ihrer Website einzugeben, kann die Suche eine Liste mit Vorschlägen bereitstellen, aus denen der Nutzer auswählen kann. Wenn der Nutzer sh eingibt, werden möglicherweise Schuhe und Shirts vorgeschlagen.

Datenquelle

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

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

Hochgeladenes Dataset

Eine BigQuery-Vorschlagstabelle, die Sie als Dataset hochladen und mit der Anfragen vorgeschlagen werden. Informationen zum Hochladen eines Datasets finden Sie unter Daten zur automatischen Vervollständigung importieren.

Dataset für automatisches Lernen

Ein auf maschinellem Lernen basierendes Vorschlags-Dataset, das von der Suche basierend auf den Suchereignissen der Nutzer generiert wird.

So aktivieren Sie das automatische Lernen:

Cloud 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 die automatische Lernfunktion 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 automatische Lernen von Datasets

Beim automatischen Lernen werden Vorschläge aus Nutzerereignissen des Suchtyps (eventType = "search") generiert. Dabei werden die Nutzerereignisse der letzten 180 Tage verwendet. Dazu sind importierte Nutzerereignisse in guter Qualität und ausreichender Menge erforderlich.

Beim automatischen Lernen werden seltene Vorschläge herausgefiltert. Wenn die Anzahl der Nutzerereignisse für den Suchtyp zu gering ist (weniger als 20.000), werden möglicherweise viele Vorschlagskandidaten herausgefiltert. In diesem Fall sollten Sie die Vervollständigungsfunktion zuerst mit einer häufiger verwendeten Suchanfrage testen.

Zeitplan für die Veröffentlichung von Datasets für automatisches Lernen

Das Dataset für automatisches Lernen wird täglich generiert und dann für die Indexierung und Veröffentlichung bereitgestellt. Der gesamte Zyklus dauert etwa zwei Tage.

Funktionen für automatisches Lernen

Bei der Suche werden Machine-Learning-Techniken verwendet, um Anfragen und Vorschlagsdaten nur für das Dataset für automatisches Lernen zu bereinigen und zu formatieren.

Funktion Beschreibung Beispiel
Suchanfragen ohne Ergebnisse entfernen
  • Entfernen Sie Anfragen, die keine Suchergebnisse liefern.
Für den Lebensmitteleinzelhändler gibt es für Gucci-Handtaschen keine Suchergebnisse, daher wird der Begriff entfernt.
Tippfehler korrigieren
  • Korrigieren Sie Tippfehler in Wörtern.
  • Bereinigen Sie auch Echtzeit-Eingabeabfragen vor dem Abgleich.
Milc → Milk
Zulassungslistenanfragen hinzufügen
  • Suchanfragen, die Sie explizit zulassen, werden hinzugefügt.
Abschnitt Weitere Informationen
Abfragen aus der Sperrliste entfernen
  • Abfragen, die Sie explizit blockieren, werden entfernt.
Abschnitt Weitere Informationen
Nicht sichere Begriffe entfernen
  • Es wird SafeSearch von Google verwendet.
  • Entfernen Sie unangemessene Anfragen.
Pornografische, anzügliche, vulgäre oder gewalttätige Inhalte
Sehr seltene Begriffe entfernen
  • Das KI-System passt den Grenzwert basierend auf Abfragestatistiken an.
  • Wenn Begriffe ungewöhnlich selten sind, werden sie entfernt.
74 × 39 × 9 Zoll große, zweilagige Luftmatratze mit 120-V-Handpumpe.
Begriffe deduplizieren
  • Basierend auf KI-gestütztem semantischem Verständnis
  • Bei nahezu identischen Begriffen wird jeder Begriff abgeglichen, aber nur der beliebtere wird vorgeschlagen.
Schuhe für Damen, Damenschuhe und Frauenschuhe werden dedupliziert, sodass nur einer der Begriffe 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 Einstellungen für die automatische Vervollständigung

In diesem Abschnitt wird erläutert, welche Optionen und Steuerelemente für die automatische Vervollständigung verfügbar sind. In der folgenden Tabelle finden Sie eine Übersicht und weitere Informationen.

Steuerung Details Standort
Sperrliste
  • Entfernt Anfragen manuell aus den Vorschlagsdaten.
API-Anfrage: CompletionData:import. Weitere Informationen finden Sie unter Daten für die automatische Vervollständigung importieren.
Zulassungsliste
  • Fügt den Vorschlagsdaten manuell Abfragen hinzu.
API-Anfrage: CompletionData:import (siehe auch Vervollständigungsdaten importieren )
Mindestlänge zum Auslösen der automatischen Vervollständigung
  • Steuert die Anzahl der Zeichen, bevor die automatische Vervollständigung ausgelöst wird.
Google Cloud console > Controls
Abgleichreihenfolge
  • Die Reihenfolge des Abgleichs bestimmt, wie Nutzeranfragen und Vorschläge abgeglichen werden.
Google Cloud console > Controls
Anzahl der Vorschläge
  • Dies ist die Anzahl der Vorschläge, die von der automatischen Vervollständigung zurückgegeben werden.
Google Cloud console > Controls oder
API-Anfrage: completeQuery.maxSuggestions
Gerätetyp
  • Wenn Gerätetypen angegeben werden, werden die Vorschläge basierend auf der Beliebtheit der angegebenen 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 bei der Abfrage auswählen, welche verwendet werden soll.
API-Anfrage: completeQuery.dataset
Sprache
  • Sie können festlegen, in welcher Sprache oder in welchen Sprachen Vorschläge angezeigt werden.
API-Anfrage: completeQuery.languageCodes[]

Zulassungsliste (Liste nicht entfernen)

Search führt eine Nachbearbeitung wie Rechtschreibkorrektur für Vorschläge zur automatischen Vervollständigung durch. Sie können eine Zulassungsliste mit Begriffen erstellen, die bei der Nachbearbeitung von Suchanfragen übersprungen werden.

Zugelassene Begriffe werden nie aus Vorschlägen herausgefiltert. Die Zulassungsliste funktioniert sowohl für hochgeladene Datasets als auch für Datasets 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 die Google Cloud Console > Steuerelemente > Steuerelemente für die automatische Vervollständigung > Liste „Nicht entfernen“ oder CompletionData:import in der API verwenden.

Ä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 in einer Sperrliste werden nie in Vorschlägen angezeigt.

Wenn Sie eine Sperrliste importieren möchten, können Sie die Google Cloud Console > Einstellungen > Einstellungen für die automatische Vervollständigung > Sperrliste verwenden oder die API CompletionData:import. Eine ausführliche Anleitung zum Importieren einer Sperrliste finden Sie unter Abschlussdaten importieren.

Änderungen werden nach etwa zwei Tagen wirksam.

Mindestlänge zum Auslösen

Sie können die Anzahl der Zeichen festlegen, die erforderlich sind, bevor Abfragen mit automatischer Vervollständigung Ergebnisse zurückgeben. Sie finden die Einstellung unter Google Cloud console > Einstellungen > Einstellungen für die automatische Vervollständigung > Mindestlänge für die Auslösung.

Änderungen treten sofort in Kraft.

Abgleichreihenfolge

Damit wird festgelegt, wie Vorschläge mit Begriffen aus der Nutzereingabe abgeglichen werden.

Wenn diese Option auf Vorschlag beginnt mit dem Begriff festgelegt ist, wird der vom Nutzer eingegebene Begriff als genaues Präfix für Vorschläge verwendet. Die Nutzereingabe „sh“ stimmt beispielsweise mit den Vorschlägen „Schuhe“ und „Shirts“, aber nicht mit dem Vorschlag „rote Schuhe“ überein.

Wenn Vorschlag kann an beliebiger Stelle im Begriff beginnen festgelegt ist, wird der vom Nutzer eingegebene Begriff in Wörter zerlegt und mit den Wörtern in Vorschlägen abgeglichen, unabhängig von der Wortreihenfolge. Beispiel: Der Nutzereingabeterm „rotsh“ stimmt mit den Vorschlägen „shirts rot“, „rote schuhe“ und „kinder rote schuhe“ überein. Der eingegebene Begriff „hoes“ wird jedoch nicht mit diesen Vorschlägen abgeglichen, da keines der Wörter in den Vorschlägen mit „hoes“ beginnt.

Die Einstellung finden Sie in der Google Cloud -Konsole > Steuerelemente > Steuerelemente für die automatische Vervollständigung > Reihenfolge der Übereinstimmungen.

Änderungen treten sofort in Kraft.

Anzahl der Vorschläge

Dies ist die Anzahl der Vorschläge, die für Abfragen mit automatischer Vervollständigung zurückgegeben werden. Sie darf 20 nicht überschreiten. Die Einstellung finden Sie in der Google Cloud -Konsole > Steuerelemente > Steuerelemente für die automatische Vervollständigung > Anzahl der Vorschläge oder sie kann in completeQuery festgelegt werden.

Ä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 nicht in completeQuery angegeben ist, gilt der Vorschlag für alle Gerätetypen.

Legen Sie für ein Dataset für automatisches Lernen basierend auf Suchnutzerereignissen 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 zur automatischen Vervollständigung beschrieben, die bei der Suche verfügbar sind. Sie können beispielsweise Vorschläge zur automatischen Vervollständigung von Suchanfragen mit anderen Vorschlägen wie Marken und Kategorien ergänzen.

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

Suggestion FeatureSet

Für jeden Vorschlagsterm stellen wir ein zusätzliches FeatureSet bereit, damit Kunden erweiterte Funktionen auf ihren Websites anzeigen können.

Das FeatureSet wird in der Antwort als Schlüssel/Wert-Zuordnung angezeigt. Vertex AI Search for Commerce gibt in der API-Antwort completeQuery.completionResults.attributes bis zu fünf beliebte Kategorien und Marken zurück, die sich auf die einzelnen Vorschläge für Suchanfragen beziehen. FeatureSet-Vorschläge müssen nicht mit den vom Endnutzer eingegebenen Suchanfragen übereinstimmen.

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

  • Die Abschnitte Beliebte Marken und Beliebte Kategorien werden zusammengefasst und erstellt. Sie werden unter der Liste mit Suchvorschlägen angezeigt.
  • Die beliebteste Marke oder Kategorie neben Suchvorschlägen anzeigen

Nachdem Sie Änderungen am Katalog vorgenommen haben, z. B. die Kategorien für Produkte geändert haben, kann es zwei Wochen bis 30 Tage dauern, bis die FeatureSet-Vorschläge die Änderungen am Produktkatalog widerspiegeln. Diese Wartezeit ist erforderlich, weil das automatische Lernen auf den Suchereignisdaten der letzten 30 Tage basiert.

Attributvorschläge

Die Google Suche bietet Attributvorschläge, die mit den Eingabestrings der Nutzer übereinstimmen. Unterstützte Vorschlagstypen für Attribute sind Marken und Kategorien.

Attributvorschläge unterscheiden sich von einem Vorschlags-FeatureSet. Attributvorschläge sind Listen mit vorgeschlagenen Produktattributen (z. B. Marken und Kategorien), ähnlich wie Suchvorschläge Listen mit vorgeschlagenen Suchanfragen sind. Attributvorschläge können unabhängig von Abfragevorschlägen verwendet werden. Ein Vorschlags-FeatureSet ist ein Metadatenobjekt für einen Vorschlag und daher von Vorschlägen abhängig.

Mithilfe von Attributvorschlägen können Marken oder Kategorien, die ein Endnutzer eingibt, in separaten Abschnitten unter der Liste mit Suchvorschlägen automatisch vervollständigt werden.

Vorschlagsattribut mit Produktanzahl (experimentell)

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

Wenn das Vorschlagsattribut mit der Funktion zur Produktanzahl aktiviert ist, wird mit dem zurückgegebenen completeQuery.completionResults wie gewohnt eine Liste mit Vorschlägen für die automatische Vervollständigung zurückgegeben. Außerdem werden die Produktanzahlen für jeden Vorschlag mit der Gesamtzahl und der Produktanzahl nach Attribut (z. B. color, category) zurückgegeben.

Wenn die Suchanfrage beispielsweise „Schuh“ lautet, könnten die zurückgegebenen Vorschläge für die automatische Vervollständigung so aussehen:

  • Damenschuhe
  • Herrenschuhe

Wenn der Facetten-Schlüssel color ist, werden mit jedem Vorschlag zur automatischen Vervollständigung auch eine Produktanzahl 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 müssen Sie dem Käufer die Anzahl der Produkte nicht präsentieren. Sie können die Liste der Vorschläge jedoch nach der Anzahl der Produkte sortieren, anstatt die Reihenfolge aus completeQuery.completionResults zu verwenden. Sie möchten beispielsweise, dass Nutzer sich grüne Schuhe für Herren ansehen. Daher soll dieser Artikel oben in der Vorschlagsbox angezeigt werden, obwohl er nicht der beliebteste Artikel ist.

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 Anzahl der Facetten werden als Liste von Facets in completeQuery.completionResults.facets für jede vorgeschlagene Suchanfrage angezeigt. Jede Facette hat eine FacetValues-Liste, die die Anzahl der Produkte pro Facettenwert enthält. Die Gesamtzahl der Produkte für jede vorgeschlagene Suchanfrage wird in completeQuery.completionResults.totalProductCount zurückgegeben.

So aktivieren und verwenden Sie Vorschlagsfacetten mit Produktanzahl:

  1. Wenden Sie sich an das Supportteam und bitten Sie es, die Funktion Vorschlagsfacette mit Produktanzahl zu aktivieren. Geben Sie an, für welche FacetKeys Sie Produktanzahlen abrufen möchten. Es sind nur textual_fields-Facetten zulässig.

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

    Diese Wartezeit ist erforderlich, weil Attributinformationen anhand der Suchverlaufsdaten der letzten Woche berechnet werden.

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

Vorschlag nach Entität gefiltert

Mit Entitäten können Sie automatisch vervollständigte Suchvorschläge filtern. Eine Entität kann beispielsweise eine Website für eine andere Marke oder Region sein. Die automatische Vervollständigung soll das Verhalten der Nutzer widerspiegeln, die Produkte dieser Marke oder auf der regionalen Website kaufen. Weitere Informationen zu Entitäten finden Sie unter Entitäten.

Die Filterung von Entitäten gilt nur für completion_results (relevant für UserEvent). Dieser Filter wird nicht auf attribute_results (relevant für Product) angewendet. Unabhängig vom Wert von entity ist attribute_results also gleich.

So nehmen Sie Einheiten in Vorschläge für die automatische Vervollständigung auf:

  1. Fügen Sie das Feld entity in Ihre Suchnutzerereignisse (eventType = "search") ein. Weitere Informationen finden Sie im vollständigen Objektbeispiel für das Nutzerereignis Search.

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

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

  3. Achten Sie darauf, dass die Einheit (sowohl in Suchnutzerereignissen als auch in AutoComplete-Anfragen) maximal 256 Zeichen lang ist. Eine längere wird beim Verarbeiten der Ereignisse oder Anfragen auf 256 Zeichen gekürzt, was zu einem Abgleichsfehler führen kann.

Normalerweise sind 30 bis 90 Tage mit Daten zu Nutzerereignissen erforderlich, bevor die Funktion für Entitäten optimale Vorschläge für die automatische Vervollständigung liefern kann.