Suchanfragenerweiterung

Bei der Suchanfragenerweiterung werden die Einschränkungen für Suchanfragen schrittweise gelockert, um mehr Ergebnisse zu erhalten, wenn anfangs keine oder zu wenige Ergebnisse gefunden werden. Dadurch wird die Größe der Ergebnisse pro Suchanfrage angepasst.

Wenn es keine relevanten Dokumente für eine Suchanfrage gibt, werden bei der Suchanfragenerweiterung weniger relevante Dokumente zurückgegeben, damit nicht null Suchergebnisse zurückgegeben werden.

Im Gegensatz zu dynamischen Facetten oder Steuerelementen für die Bereitstellung kann die Suchanfragenerweiterung beispielsweise nicht direkt in der Google Cloud Konsole konfiguriert werden. Stattdessen müssen Sie die Suchanfragenerweiterung für jede Suchanfrage programmatisch konfigurieren. Im Folgenden erfahren Sie, wie Sie die Suchanfragenerweiterung in der API konfigurieren .

Anleitung zur Suchanfragenerweiterung

In dieser Anleitung erfahren Sie, wie Sie die Suchanfragenerweiterung aktivieren. Wenn ein Käufer eine mehrdeutige oder mehrteilige Suchwortgruppe verwendet, kann er eine leere Antwort erhalten. Nachdem Sie die Suchanfragenerweiterung aktiviert haben, wird die Anfrage analysiert und die erweiterte Liste der Produkte basierend auf der analysierten Suchanfrage wird zurückgegeben.

Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt im Cloud Shell-Editor zu erhalten:

Anleitung

Übersicht über die Suchanfragenerweiterung

Die Suchanfragenerweiterung ist eine leistungsstarke Funktion, mit der die Suchergebnisse verbessert und Szenarien mit null Ergebnissen vermieden werden können, insbesondere bei Longtail- oder komplexen Suchanfragen von Nutzern.

Anstatt keine Ergebnisse zurückzugeben, wenn im Produktkatalog keine genaue Übereinstimmung gefunden wird, werden bei der Suchanfragenerweiterung verwandte oder alternative Produkte ermittelt und angezeigt. Dadurch wird die Nutzererfahrung verbessert und die Conversion-Raten können steigen.

Wichtige Anwendungsfälle für die Suchanfragenerweiterung sind:

Longtail-Suchanfragen: Bei sehr spezifischen Suchanfragen wie zuckerfreie, proteinreiche,fettarme Bio-Milch gibt es im Katalog möglicherweise keine perfekte Übereinstimmung. Bei der Suchanfragenerweiterung können Produkte zurückgegeben werden, die mit Teilen der Suchanfrage übereinstimmen, z. B. Produkte, die mit Attributen oder Attributwerten von zuckerfreier Milch oder proteinreicher Milch getaggt sind.
Alternative Produkte: Wenn Ihre Nutzer nach einer Marke oder einem Produkt suchen, das nicht im Katalog enthalten ist, z. B. Starbucks-Kaffee 100 ml, können bei der Suchanfragenerweiterung alternative Kaffeemarken vorgeschlagen werden, die gekauft werden können. So wird verhindert, dass die Suche ins Leere läuft.

In den folgenden Abschnitten werden die Funktionalität, der Auslösemechanismus und die Konfigurationsnuancen der Suchanfragenerweiterung in AI Commerce Search beschrieben, wobei der Schwerpunkt auf der entscheidenden Rolle des kanonischen Filters liegt.

Auslösemechanismus für die Suchanfragenerweiterung

Die Entscheidung, die Suchanfragenerweiterung für eine bestimmte Suchanfrage zu aktivieren, wird automatisch getroffen und basiert auf einer schnell konfigurierbaren kanonischen Filterregel.

Auslösebedingung: Die Suchanfragenerweiterung wird nur ausgelöst, wenn die erste Suche mit der kanonischen Filterabfrage weniger als drei Produktergebnisse liefert.
Schwellenwert: Dieser Standardwert von drei kann geändert werden. Er eignet sich gut für die meisten E-Commerce-Anwendungsfälle, da die Suchanfragenerweiterung nur dann aktiviert wird, wenn die erste Ergebnismenge wirklich gering ist.

Suchanfragenerweiterung in der API konfigurieren

Die Suchanfragenerweiterung wird programmatisch pro Anfrage über die API konfiguriert:

API-Konfiguration: Sie steuern die Suchanfragenerweiterung, indem Sie das Objekt queryExpansionSpec in Ihre SearchRequest einfügen.
Einstellungen: Legen Sie im Feld queryExpansionSpec die Option condition auf AUTO fest, um die Funktion zu aktivieren, oder auf DISABLED, um sie zu deaktivieren. Dies ist die Standardeinstellung, wenn nichts angegeben ist.
Anheften: Optional können Sie pinUnexpandedResults auf true in der Anfrage setzen, damit genaue Übereinstimmungen für die ursprüngliche Suchanfrage oben in den Suchergebnissen angezeigt werden, gefolgt von den erweiterten Ergebnissen. Weitere Informationen finden Sie auf der Seite zum Anheften.

Kanonische Filter konfigurieren

Damit die Suchanfragenerweiterung effektiv ausgelöst wird, müssen Sie den canonical_filter in Ihrer Suchanfrage richtig konfigurieren.

Für die korrekte Implementierung der Suchanfragenerweiterung ist es wichtig, die beiden primären Filterparameter in einer Suchanfrage zu verstehen: Filter auf oberster Ebene und kanonische Filter.

Filter auf oberster Ebene (filter): Dies ist der Hauptfilter, der auf die Suchergebnisse angewendet wird, bevor sie an den Nutzer zurückgegeben werden. Er besteht aus zwei möglichen Ebenen:
- Geschäfts-/Basisfilter: Vordefinierte Regeln, die auf alle Suchanfragen angewendet werden, oft ohne direkte Nutzereingabe, z. B. inStock=TRUE, category="groceries", storeId="XYZ".
- Vom Nutzer ausgewählte Attributfilter: Filter, die vom Nutzer dynamisch angewendet werden, während er mit der Suchoberfläche interagiert, z. B. durch Auswahl von Attributfiltern für brand="Adidas", size="L".
Kanonische Filter (canonical_filter): Dies ist ein spezieller Filter, der ausschließlich vom Entscheidungsmodul für die Suchanfragenerweiterung verwendet wird. Seine einzige Aufgabe besteht darin, die Katalogansicht zu definieren, anhand derer die Auslösebedingung für die Suchanfragenerweiterung (weniger als fünf Ergebnisse) ausgewertet wird.

**Wichtig**: Der kanonische Filter filtert nicht die endgültigen Suchergebnisse, die an den Nutzer zurückgegeben werden. Das ist die Aufgabe des Hauptfilters.

Wichtige Funktionen des kanonischen Filters

Der kanonische Filter soll zwischen einem organisch schlechten Suchergebnis und einer Ergebnismenge unterscheiden, die vom Nutzer absichtlich eingeschränkt wurde. Er kann entweder breit sein, um Geschäftslogik auszuschließen und vom Nutzer angewendete Filter zu berücksichtigen, oder eingeschränkt, um die Suchanfragenerweiterung bei Bedarf auszulösen, je nach Nutzerszenario.

Szenario 1

User Journey: Der Nutzer sucht nach T-Shirt und erhält Tausende von Ergebnissen. Es gibt einen Standard-business_filter, der beispielsweise nur Produkte filtert, die auf Lager sind und die einem benutzerdefinierten Attribut auf Shop-Ebene entsprechen. Der Nutzer wendet dann Attributfilter für brand="Adidas" und size="L" an, wodurch die Anzahl der Ergebnisse auf zwei reduziert wird.
Wenn canonical_filter so festgelegt wäre, dass er dieselbe Bedingungen wie filter enthält (z. B. AVAILABILITY: IN_STOCK AND color: "Red": Das Entscheidungssystem für die Suchanfragenerweiterung würde nur zwei Ergebnisse sehen und fälschlicherweise die Suchanfragenerweiterung auslösen, wodurch der Nutzer mit verwandten, aber irrelevanten Produkten wie Nike-T-Shirts überflutet würde. Die explizite Filterung des Nutzers würde dadurch aufgehoben.
Die richtige Einstellung ist canonical_filter = business filter. Die Entscheidung zur Suchanfragenerweiterung sollte auf der ursprünglichen Suchanfrage basieren, ohne die vom Nutzer ausgewählten Attribute zu berücksichtigen. Wenn der canonical_filter breit gehalten wird, erkennt das System korrekt, dass es viele passende Produkte im Katalog gibt. So können die strengen Filter des Nutzers berücksichtigt werden, ohne eine Erweiterung zu erzwingen.

Szenario 2

User Journey: Der Nutzer sucht nach Adidas-T-Shirt mit schwarzem Grafikdruck und erhält nur ein oder zwei Ergebnisse, wenn überhaupt. Es gibt einen Standard-business_filter, der beispielsweise nur Produkte filtert, die auf Lager sind und die einem benutzerdefinierten Attribut auf Shop-Ebene entsprechen.
Wenn canonical_filter nicht festgelegt oder nicht richtig konfiguriert ist, können bei der Suche mit dem kanonischen Filter Produkte gefunden werden, die der Suchanfrage entsprechen, aber nicht auf Lager sind oder aus einem anderen Shop stammen, d. h. einen anderen Wert für das benutzerdefinierte Attribut auf Shop-Ebene haben. In diesem Fall wird die Suchanfragenerweiterung nicht ausgelöst.
Die richtige Einstellung ist canonical_filter = business filter. Mit dieser Einstellung findet die Entscheidung zur Suchanfragenerweiterung weniger als drei Produkte für die angegebene lange Suchanfrage, löst dann eine Suchanfragenerweiterung aus und fügt der ursprünglichen Suchanfrage ähnliche Produkte hinzu, d. h. Produkte, die auf Lager sind und dem Attribut auf Shop-Ebene entsprechen. Dadurch werden die Suchergebnisse erweitert und enthalten jetzt auch T-Shirts mit schwarzem Grafik druck einer anderen Marke, T-Shirts mit Grafik druck in anderen Farben oder andere T-Shirt-Produkte der abgefragten Marke. Fügen Sie für diesen Anwendungsfall von canonical_filter geschäftliche Einschränkungen hinzu.

Best Practices für die Suchanfragenerweiterung

Der kanonische Filter sollte fast immer mit Ihrem Geschäfts- oder Basisfilter identisch sein. So wird sichergestellt, dass das Modul für die Suchanfragenerweiterung das Potenzial der Suchanfrage anhand derselben breiten Katalogansicht bewertet, die Ihre Nutzer anfangs sehen, bevor sie Attribute anwenden.

End-to-End-Prozessablauf für Suche und Suchanfragenerweiterung

Wenn eine Suchanfrage gestellt wird, laufen mehrere parallele Prozesse ab:

Anfrage erhalten: Die API empfängt die Suchanfrage mit der Suchanfrage, dem Haupt-filter und dem canonical_filter.
Suche zur Entscheidung über die Suchanfragenerweiterung: Parallel dazu führt das Entscheidungsmodul für die Suchanfragenerweiterung eine eigene interne Suche durch, wobei die Suchanfrage mit dem kanonischen Filter kombiniert wird.
Anzahl der Ergebnisse prüfen: Das Modul prüft die Anzahl der Produkte, die bei der internen Suche zurückgegeben wurden.
- Wenn fünf oder mehr Ergebnisse zurückgegeben werden: Die Suchanfragenerweiterung wird nicht ausgelöst. Die Standard-Suchergebnisse werden an den letzten Filterschritt weitergeleitet.
- Wenn weniger als fünf Ergebnisse zurückgegeben werden: Die Suchanfragenerweiterung wird ausgelöst. Das Modell lockert die Suchanfrage systematisch, um ähnliche Produkte zu finden. Beispielsweise kann das Modell für Pixel 5 Smartphone Pixel 4 Smartphones, Pixel-Ohrhörer oder sogar Samsung-Smartphones finden.

Endgültige Filterung: Die Produktmenge (die ursprüngliche Menge oder die erweiterte Menge aus der Suchanfragenerweiterung) wird an die letzte Phase weitergeleitet. In diesem Fall wird der Filter auf oberster Ebene, der Geschäftsregeln und alle vom Nutzer ausgewählten Attribute enthält, streng angewendet.

Antwort gesendet: Die endgültige gefilterte Liste der Produkte wird in der API-Antwort zurückgegeben.

Erweiterter Anwendungsfall der selektiven Aktivierung der Suchanfragenerweiterung

Sie können die Filter strategisch konfigurieren, um die Suchanfragenerweiterung für bestimmte Teile Ihres Katalogs zu aktivieren oder zu deaktivieren.

Stellen Sie sich ein Szenario mit einem großen Katalog vor, der Lebensmittel, Elektronik und Modeartikel enthält. In einem solchen Szenario sollten Sie die folgenden Aspekte berücksichtigen.

Ziel

Aktivieren Sie die Suchanfragenerweiterung für schwer zu findende oder knappe Lebensmittel, zeigen Sie aber keine Ergebnisse für Elektronik- oder Modeartikel an. Die geschäftliche Anforderung besteht darin, die Suchanfragenerweiterung nur selektiv für den Lebensmittelbereich zu aktivieren.

Konfiguration

Für dieses Anwendungsfallszenario kann die selektive Suchanfragenerweiterung so konfiguriert werden:

canonical_filter: Legen Sie ihn auf breit fest. Er sollte alle Kategorien enthalten: Lebensmittel, Elektronik und Mode sowie alle Basisregeln wie die Verfügbarkeit auf Lager. Definieren Sie den kanonischen Filter mit category="groceries" OR category="electronics" OR category="fashion") AND inStock=TRUE.
filter: Legen Sie ihn basierend auf dem Kontext des Nutzers auf eingeschränkt fest. Für einen Nutzer im Lebensmittelbereich wäre der Filter category="groceries" AND inStock=TRUE.

Funktionsweise

Die selektive Suchanfragenerweiterung funktioniert in diesem Szenario so:

Nutzer sucht nach „iPhone 20“ : Das Modul für die Suchanfragenerweiterung verwendet den breiten `canonical_filter`, findet vorhandene iPhone-Modelle (< 5 Ergebnisse) und entscheidet, die Suchanfragenerweiterung nicht auszulösen. Die Standard-Suchergebnisse (vorhandene iPhones) werden dann an den Hauptfilter weitergeleitet, der sie blockiert, weil category="electronics" nicht mit category="groceries" übereinstimmt. Der Nutzer sieht korrekterweise null Ergebnisse.
Nutzer sucht nach *proteinreicher, zuckerfreier Milch:* Das Modul für die Suchanfragenerweiterung verwendet den breiten canonical_filter und findet weniger als fünf Ergebnisse. Dadurch wird die Suchanfragenerweiterung ausgelöst und es werden verwandte Milchprodukte gefunden. Diese Produkte werden an den Hauptfilter weitergeleitet. Da sie mit category="groceries" übereinstimmen, werden diese Produkte erfolgreich an den Nutzer zurückgegeben.

Durch die Manipulation des Umfangs des canonical_filter (der Ansicht für die Entscheidungsfindung) und des Haupt- filter (der Ansicht für die endgültige Ausgabe) erhalten Sie eine präzise Kontrolle über die Suchergebnisse.

Beispieldatensatz

Auf dieser Seite wird das folgende Dataset als Beispiel verwendet. Maximieren Sie es, um die Felder im Beispieldatensatz für die Produktbeschreibung zu sehen.

Beispiel für ein Produkt-Dataset

ID	Titel	Marken	Kategorien	price_info.price
"nest_mini_2nd_gen"	"Nest Mini (2. Generation)"	["Google", "Nest"]	[„Nest > Lautsprecher und Displays“]	49,00
"nest_audio"	"Nest Audio"	["Google", "Nest"]	[„Nest > Lautsprecher und Displays“]	99.99
"nest_hub_max"	"Nest Hub Max"	["Google", "Nest"]	[„Nest > Lautsprecher und Displays“]	229,00
"nest_hub"	"Nest Hub"	["Google", "Nest"]	[„Nest > Lautsprecher und Displays“]	88,99
„google_home_max“	„Google Home Max“	["Google", "Nest"]	[„Nest > Lautsprecher und Displays“]	299,00
„google_home_mini“	„Google Home Mini“	["Google", "Nest"]	[„Nest > Lautsprecher und Displays“]	49,00
"google_pixel_5"	"Google Pixel 5"	["Google", "Pixel"]	[„Pixel > Smartphones“]	699,00
"google_pixel_4a_with_5g"	"Google Pixel 4a with 5G"	["Google", "Pixel"]	[„Pixel > Smartphones“]	499,00
"google_pixel_4a"	"Google Pixel 4a Phones"	["Google", "Pixel"]	[„Pixel > Smartphones“]	349,00
"google_pixel_stand"	"Google Pixel Stand"	["Google", "Pixel"]	["Pixel > hervorgehobenes Zubehör"]	79,00
"google_pixel_buds"	"Google Pixel Buds"	["Google", "Pixel"]	["Pixel > hervorgehobenes Zubehör"]	179,00
"google_pixel_5_case"	"Google Pixel 5 Case"	["Google", "Pixel"]	["Pixel > hervorgehobenes Zubehör"]	40,00
"google_pixel_4a_5g_case"	"Google Pixel 4a (5G) Case"	["Google", "Pixel"]	["Pixel > hervorgehobenes Zubehör"]	40,00
"google_pixel_4a_case"	"Google Pixel 4a Case"	["Google", "Pixel"]	["Pixel > hervorgehobenes Zubehör"]	40,00

Suchanfragenerweiterung erweitert Suchanfragen für mehr Ergebnisse

Die Suchanfragenerweiterung erhöht die Anzahl der Ergebnisse für Suchbegriffe mit wenigen Ergebnissen, insbesondere für Longtail-Suchanfragen. Die erweiterte Suchanfrage führt zu einer größeren Anzahl von Suchergebnissen.

Diese Suchfunktion wird durch eine Spezifikation gesteuert, die die Bedingungen für die Suchanfragenerweiterung festlegt. Sie enthält die Option pinUnexpandedResults, die standardmäßig deaktiviert ist. Wenn sie auf true gesetzt ist, werden nicht erweiterte Produkte oben in den Suchergebnissen angezeigt. Darauf folgen die erweiterten Ergebnisse.

Java

import com.google.cloud.retail.v2.SearchRequest;
import com.google.cloud.retail.v2.SearchRequest.QueryExpansionSpec;
import com.google.cloud.retail.v2.SearchRequest.QueryExpansionSpec.Condition;
import com.google.cloud.retail.v2.SearchResponse;
import com.google.cloud.retail.v2.SearchServiceClient;

public static void searchProductsWithQueryExpansion(String query, int pageSize,
    Condition condition) throws IOException, InterruptedException {
  QueryExpansionSpec queryExpansionSpec = QueryExpansionSpec.newBuilder()
      .setCondition(condition)
      .build();

  SearchRequest searchRequest = SearchRequest.newBuilder()
      .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
      .setBranch(DEFAULT_BRANCH_NAME)
      .setVisitorId(VISITOR_ID)
      .setQuery(query)
      .setPageSize(pageSize)
      .setQueryExpansionSpec(queryExpansionSpec)
      .build();

  try (SearchServiceClient searchClient = SearchServiceClient.create()) {
    SearchResponse response = searchClient.search(searchRequest).getPage().getResponse();
    System.out.println("Search response: " + searchResponse);
  }
}

Wenn Sie beispielsweise ohne Suchanfragenerweiterung nach Google Pixel 5 suchen, ist das Ergebnis auf google_pixel_5-IDs beschränkt. Mit der Suchanfrage erweiterung erhalten Sie im Beispieldatensatz für die Produktbeschreibung jedoch möglicherweise auch google_pixel_4a_with_5g, google_pixel_4a und google_pixel_5_case-IDs.