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
Rufen Sie den Tab Steuerelemente für die automatische Vervollständigung auf.
Klicken Sie auf Einstellungen bearbeiten.
Aktivieren Sie Automatisches Lernen.
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 |
|
Für den Lebensmitteleinzelhändler gibt es für Gucci-Handtaschen keine Suchergebnisse, daher wird der Begriff entfernt. |
Tippfehler korrigieren |
|
Milc → Milk |
Zulassungslistenanfragen hinzufügen |
|
Abschnitt Weitere Informationen |
Abfragen aus der Sperrliste entfernen |
|
Abschnitt Weitere Informationen |
Nicht sichere Begriffe entfernen |
|
Pornografische, anzügliche, vulgäre oder gewalttätige Inhalte |
Sehr seltene Begriffe entfernen |
|
74 × 39 × 9 Zoll große, zweilagige Luftmatratze mit 120-V-Handpumpe. |
Begriffe deduplizieren |
|
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 |
|
API-Anfrage: CompletionData:import. Weitere Informationen finden Sie unter Daten für die automatische Vervollständigung importieren. |
Zulassungsliste |
|
API-Anfrage: CompletionData:import (siehe auch Vervollständigungsdaten importieren ) |
Mindestlänge zum Auslösen der automatischen Vervollständigung |
|
Google Cloud console > Controls |
Abgleichreihenfolge |
|
Google Cloud console > Controls |
Anzahl der Vorschläge |
|
Google Cloud console > Controls oder API-Anfrage: completeQuery.maxSuggestions |
Gerätetyp |
|
API-Anfrage: completeQuery.deviceType |
Datenquelle für Vorschläge |
|
API-Anfrage: completeQuery.dataset |
Sprache |
|
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:
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 nurtextual_fields
-Facetten zulässig.Achten Sie mindestens 7 Tage lang darauf, dass Sie bei Verwendung der
search
API den Facettenschlüssel inFacetSpecs
undsearch.searchRequest.facetSpecs
einfügen.Diese Wartezeit ist erforderlich, weil Attributinformationen anhand der Suchverlaufsdaten der letzten Woche berechnet werden.
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:
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.Legen Sie das Feld
entity
in IhrerCompleteQuery
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.
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.