„Einzelhandel“ wird in „Vertex AI Search for Retail“ umbenannt. Wir aktualisieren derzeit unsere Inhalte gemäß dem neuen Branding.

Diese Seite wurde von der Cloud Translation API übersetzt.

Suchergebnisse abrufen

Auf dieser Seite werden grundlegende Abfragen mit der Suche beschrieben, einschließlich Textabfragen, Suchanfragen, Paginierung, Optimierung und personalisierten Ergebnissen.

Caching von personalisierten Ergebnissen eines Endnutzers ist nicht zulässig. Außerdem dürfen personalisierte Ergebnisse nicht für einen anderen Endnutzer zurückgegeben werden.

Relevanz in Vertex AI Search for Retail

Relevanz unterscheidet sich von Übereinstimmung. Bei der Abgleichsfunktion werden im Index Kandidatenprodukte gefunden, die der Suchanfrage des Nutzers entsprechen. Die Relevanz hingegen ist ein Grad der Übereinstimmung. Dabei werden diese Produkte so bewertet, dass sie die Absicht und Anforderungen der Nutzer am besten erfüllen. Vertex AI Search for Retail verwendet Verfahren, um die Übereinstimmung und Relevanz zu verbessern und so die Nutzerfreundlichkeit der Suche zu erhöhen. Das entspricht den Anforderungen von Einzelhändlern.

Nicht standardmäßige Suche

Bei Vertex AI Search for Retail wird standardmäßig die Relevanz in der Suche verwendet. Die Suche ist jedoch so optimiert, dass auch Artikel mit nur mäßiger Relevanz weiter oben in den Suchergebnissen angezeigt werden, um Einzelhändlern gezieltere Suchergebnisse zu bieten und das Conversion-Potenzial von Nutzerereignissen zu erhöhen.

Diese zusätzlichen Suchfunktionen optimieren den Standardalgorithmus für die Relevanz und bieten nicht standardmäßige Funktionen, die auf das Nutzungsprofil jedes Einzelhändlers abgestimmt sind. Dazu gehören:

Optionen zum Sortieren von Ergebnissen, z. B. nach Preis, nach bestbewerteten oder nach meistverkauften Artikeln Die benutzerdefinierte Suche ist so angepasst, dass bestimmte Suchergebnisse mit den richtigen Produktvarianten zurückgegeben werden. So können Sie beispielsweise die günstigste oder teuerste Variante anzeigen lassen, wenn nach Preis sortiert wird.
Automatische Anwendung eines strengeren Relevanzfilters für nicht standardmäßige Nutzerereignisse
Es können Boost-/Bury-Steuerelemente mit einstellbarer Stärke aktiviert werden, um die Suchergebnisse zu optimieren.

Text- und Navigationssuche mit der Google Suche

Die Suche bietet sowohl Textabfragen als auch Suchfunktionen.

Im Anwendungsfall für die Suche mit Textabfrage gibt ein Käufer möglicherweise eine textbasierte Suchanfrage auf Ihrer Website ein. Die Suche gibt eine Suchantwort mit Produkten zurück, die den von Ihnen festgelegten Parametern entsprechen. Die Produkte werden nach Relevanz und Umsatzmaximierung sortiert.

Im Suchanwendungsfall kann ein Käufer das Menü Ihrer Website aufrufen und zu einer bestimmten Produktkategorie wechseln. Die Google Suche wählt automatisch die Sortierung aus, mit der der Umsatz am besten gesteigert werden kann. Dabei lernt sie aus dem Nutzerverhalten und -trends. Die Suchergebnisse können mithilfe der von Ihnen festgelegten Steuerelemente weiter eingegrenzt werden.

Sowohl für Textsuch- als auch für Suchanfragen wird die Methode servingConfigs.search verwendet.

Suchanfragen mit Text

Wenn ein Nutzer eine Textabfrage für die Suche auf Ihrer Website eingibt, werden die potenziellen Suchergebnisse nach Relevanz, Beliebtheit, Kaufbarkeit und Personalisierung sortiert.

In der Google Suche wird eine servingConfigs.search-Anfrage als textbasierte Suchanfrage betrachtet, wenn das Feld query nicht leer ist.

Senden Sie beim Hochladen von Nutzerereignissen Suchanfragen mit Text, die von der Suche generiert wurden, als search-Nutzerereignisse. Wenn das Ereignis ein nicht leeres Feld userEvent.searchQuery und ein leeres Feld userEvent.pageCategories enthält, wird es als textbasiertes Suchereignis betrachtet.

Suchanfragen ansehen

Bei der Suche werden anhand der Navigation auf der Website Suchergebnisse mit gleicher Relevanz nach den meistverkauften Artikeln sortiert. Bei der Suche wird KI eingesetzt, um die Sortierung der Suchergebnisse zu optimieren. Dabei werden Beliebtheit, Kaufbarkeit und Personalisierung berücksichtigt.

Anfragen und Ereignisse mit einem leeren Abfragefeld und nicht leeren page_categories-Feldern werden als Suchanfragen und Nutzerereignisse betrachtet. Das Feld page_categories gibt die Suchergebnisseite selbst an. Wenn die servingConfigs.search-Methode eine Anfrage sendet, wird sie von der Suche als Suchanfrage für die Navigation betrachtet, wenn das Feld query leer ist. In diesem Fall basieren die Ergebnisse auf den Feldern filter und pageCategories sowie auf weiteren Optimierungs- und Personalisierungsoptionen, sofern verfügbar.

Beachten Sie Folgendes, damit Sie korrekte Suchergebnisse erhalten:

Die Werte für pageCategories und filter in Ihren Suchanfragen müssen genau mit den Werten für pageCategories und filter in Ihren hochgeladenen Nutzerereignissen übereinstimmen. filter-Werte in Ihren hochgeladenen Nutzerereignissen. Wenn die Parameter in den Anfragen nicht mit den Parametern in den Ereignissen übereinstimmen, funktioniert das aus den Ereignissen gelernte, auf Klicks basierende Modell für die Neubewertung für diese bestimmte Suchanfrage nicht sehr gut und wirkt sich negativ auf die Ergebnisqualität aus.
In Vertex AI Search for Retail wird ein search-Nutzerereignis als nutzungsbasiertes Ereignis kategorisiert, wenn das Feld userEvent.searchQuery leer und das Feld userEvent.pageCategories nicht leer ist. Daher müssen Sie beim Hochladen von Suchanfragen, die von Vertex AI Search for Retail generiert wurden, darauf achten, dass Sie sie als search-Nutzerereignisse senden.
Ein Suchfilter muss gültig sein und für jede Suchanfrage angeben, welche Produkte zur Produktkategorie gehören, in der sich der Nutzer befindet. Dazu muss die Kategorie-ID sowohl im Feld filter als auch im Feld page_category definiert sein. Angenommen, Sie möchten, dass die Suchergebnisse auf „Heim & Garten“ ausgerichtet sind. Erstens: Wenn Sie nur einen filter-Wert von "in-stock" haben, wird die Suche nicht ausreichend eingegrenzt, um optimale Stöberergebnisse zu erzielen. Wenn Sie Suchergebnisse einschränken möchten, die nur auf „Haus und Garten“ bezogen sind, müssen Sie nicht nur "Home \& Garden" in der Seitenkategorie, sondern auch im Filter mit categories: ANY("Home & Garden") festlegen. Wenn Sie die Kategorie im Filterbereich nicht definieren, sind die Suchergebnisse möglicherweise zu breit gefasst und enthalten viele Artikel, die nicht zu „Heim & Garten“ gehören.

Sie können die Kategorie in beiden festlegen, wie in diesem Beispiel:

JSON

page_category: "Home & Garden"
filter: "(availability: ANY("IN_STOCK")) AND (categories: ANY("Home & Garden"))"

Andernfalls werden die Produkte in einer bestimmten Kategorie nicht automatisch in den Ergebnissen für eine bestimmte Seitenkategorie angezeigt, da die Suche mit leeren Stringabfragen funktioniert. Wenn der Endnutzer also sucht, ohne etwas in eine Textabfrage einzugeben, liefert die Suche möglicherweise nicht effektiv ausgerichtete Ergebnisse, auch wenn der Nutzer eine Kategorieseite aufruft.

Suchen

Mit Suchanfragen können Sie sowohl Ergebnisse für Textsuchen als auch für Suchanfragen vom Typ „Durchsuchen“ erhalten. Verwenden Sie die Methode servingConfigs.search, um eine Suchanfrage zu stellen.

Für alle Suchanfragen ist placement erforderlich. Damit wird der vollständige Ressourcenname der zu verwendenden Bereitstellungskonfiguration angegeben. In der Bereitstellungskonfiguration wird festgelegt, welche Einstellungen und zugehörigen Steuerelemente sich auf die Suchergebnisse auswirken.

Für Suchanfragen mit Textabfrage ist ein nicht leeres query-Feld erforderlich.

Für Suchanfragen im Shopping-Tab ist ein nicht leeres pageCategories-Feld erforderlich.

Java

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

public static void searchProducts(String query) throws IOException, InterruptedException {
  SearchRequest searchRequest = SearchRequest.newBuilder()
      .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
      .setBranch(DEFAULT_BRANCH_NAME)
      .setVisitorId(VISITOR_ID)
      .setQuery(query)
      .build();

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

Standardmäßig wird eine angemessene Anzahl von Ergebnissen zurückgegeben, sortiert nach Relevanz.

Um Produktattribute abzurufen, die mit der Suchantwort zurückgegeben werden, müssen Sie beim Importieren Ihrer Katalogdaten Attributwerte angeben. Product hat vordefinierte Systemattribute wie Marke, Farbe und Größe, für die Sie Werte angeben können. Sie können auch benutzerdefinierte Attribute hinzufügen, die Sie mit Product.attributes definieren.

Anleitung zu Anfragen

In dieser Anleitung erfahren Sie, wie Sie eine textbasierte Suchanfrage an die Vertex AI Search für den Einzelhandel senden und die Antwort analysieren.

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

Anleitung

Seitenumbruch

Verwenden Sie die Paginierung, um die Suchzeit und die Größe der gesendeten Antworten zu reduzieren.

Anleitung zum Seitenumbruch

In dieser Anleitung erfahren Sie, wie Sie die Paginierung in einer textbasierten Suchanfrage steuern. Wenn ein Käufer nach Produkten in einem Geschäft sucht, kann er die Navigation durch die Suchergebnisse verbessern. So können sie beispielsweise die Anzahl der Elemente in der Suchantwort mithilfe der Seitengröße begrenzen oder mithilfe der Offset-Funktion zur gewünschten Seite springen.

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

Anleitung

Paginieren

Verwenden Sie je nach Anwendungsfall page_token oder offset, um von einer Seite zu einer anderen zu springen.

Mit page_token können Sie zur nächsten Seite springen. Angenommen, Sie senden den folgenden SearchRequest.

JSON

{
  placement: 'projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/placements/default_search'
  visitor_id: 'VISITOR_ID'
  query: 'shoes'
  page_size: 5
}

Von SearchResponse können Sie die resultierenden Produkte mit einer Top-5-Relevanz zusammen mit einem next_page_token abrufen.

JSON

{
  results: [
    products{...}, products{...}, products{...}, products{...}, products{...}
  ]
  next_page_token: "wY4ETNkBDOlVjZ0YWLzUmM40SMhVjMtADMwATL5UGN5MGZlVDJaIQ5LaYsQUw9fC6lIwgE1EgC"
  total_size: 100
  search_token: "NtQKDAiXt4_3BRDCg_jnARABGiQ1ZWRjOTRlOC0wMDAwLTI1YTEtODJlMy1mNGY1ZTgwZDUxOGM"
}

Um die Produktergebnisse mit den nächsten fünf Relevanzstellen (6. bis 10.) abzurufen, geben Sie für page_token dieselben Werte für placement und visitor_id an und query als next_page_token der vorherigen SearchResponse.

Java

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

public static void searchProducts_withNextPageToken(String query, int pageSize)
    throws IOException, InterruptedException {
  try (SearchServiceClient searchClient = SearchServiceClient.create()) {
    SearchRequest firstRequest = SearchRequest.newBuilder()
        .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
        .setBranch(DEFAULT_BRANCH_NAME)
        .setVisitorId(VISITOR_ID)
        .setQuery(query)
        .setPageSize(pageSize)
        .build();

    SearchResponse firstResponse = searchClient.search(firstRequest).getPage()
        .getResponse();
    System.out.println("First search response: " + firstResponse);

    SearchRequest secondRequest = SearchRequest.newBuilder()
        .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
        .setBranch(DEFAULT_BRANCH_NAME)
        .setVisitorId(VISITOR_ID)
        .setQuery(query)
        .setPageSize(pageSize)
        .setPageToken(firstResponse.getNextPageToken())
        .build();

    SearchResponse secondResponse = searchClient.search(secondRequest).getPage()
        .getResponse();
    System.out.println("Second search response: " + secondResponse);
  }
}

In diesem Beispiel sieht SearchRequest so aus:

JSON

{
  placement: 'projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/placements/default_search'
  visitor_id: 'VISITOR_ID'
  query: 'shoes'
  page_size: 5
  page_token: "wY4ETNkBDOlVjZ0YWLzUmM40SMhVjMtADMwATL5UGN5MGZlVDJaIQ5LaYsQUw9fC6lIwgE1EgC"
}

In anderen Fällen können Sie anstatt von Seite zu Seite zu gehen oder Ergebnisse mit hoher Relevanz zu erhalten, mit offset eine bestimmte Position direkt erreichen.

Java

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

public static void searchProducts_withOffset(String query, int pageSize,
    int offset) throws IOException, InterruptedException {
  SearchRequest searchRequest = SearchRequest.newBuilder()
      .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
      .setBranch(DEFAULT_BRANCH_NAME)
      .setVisitorId(VISITOR_ID)
      .setQuery(query)
      .setPageSize(pageSize)
      .setOffset(offset)
      .build();

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

Wenn Sie beispielsweise die 10. Ergebnisseite abrufen möchten und die Seitengröße 5 beträgt, können Sie den Wert offset auf 45 festlegen. Dieser Wert wird folgendermaßen berechnet (10 - 1) * 5.

JSON

{
  placement: 'projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/placements/default_search'
  visitor_id: 'VISITOR_ID'
  query: 'shoes'
  page_size: 5
  offset: 45
}

Leistungsstufen der Google Suche

Die Google Suche bietet mehrere Stufen der Suchleistung, die Ihre Ergebnisse immer weiter verbessern. Bei Anwendungsfällen für die Suche mit Textabfragen können die Ergebnisse beispielsweise ausschließlich auf der Relevanz basieren. Je höher die Stufe der Leistung ist, desto mehr Ergebnisse können auf Relevanz, Beliebtheit, Umsatzoptimierung und Personalisierung basieren.

Wenn Sie Katalog- und Nutzerereignisdaten hochladen, die die Mindestanforderungen der einzelnen Leistungsstufen erfüllen, werden automatisch höhere Leistungsstufen freigeschaltet.

Auf der Seite Datenqualität der Retail Search Console sehen Sie, welche Anforderungen Sie für jede Stufe erfüllt haben. Weitere Informationen dazu, wie Sie auf dieser Seite die Datenqualität und die Leistungsstufen der Suche aufrufen, finden Sie unter Leistungsstufen der Suche freischalten.

Textsuche und Suchergebnisse bewerten

Bevor Sie Ihren Websitecode zum Anfordern von Suchergebnissen für die Textsuche oder die Navigationssuche aktualisieren, können Sie eine Vorschau der Ergebnisse aufrufen, um zu prüfen, ob Ihre Bereitstellungskonfiguration wie erwartet funktioniert.

Weitere Informationen zu Bereitstellungskonfigurationen finden Sie unter Bereitstellungskonfigurationen.

Sie können sich eine Vorschau der Ergebnisse der Bereitstellungskonfiguration entweder auf der Seite Bewerten oder in der Console auf der Seite Details der Bereitstellungskonfiguration auf dem Tab Bewerten ansehen. In den folgenden Schritten wird beschrieben, wie Sie eine Vorschau auf der Seite Bewerten aufrufen.

So rufen Sie eine Vorschau der Ergebnisse auf, die von Ihrer Bereitstellungskonfiguration zurückgegeben werden:

Textsuche

Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Bewerten auf.

Zur Seite „Bewerten“
Klicken Sie auf den Tab Suchen.

Hinweis :Der Tab Suchen ist nur verfügbar, wenn die Suche aktiviert ist. Eine Anleitung zum Aktivieren finden Sie unter Vorbereitung.
Wählen Sie die Bereitstellungskonfiguration aus, für die Sie eine Vorschau sehen möchten.
Wählen Sie den Katalogzweig aus, der den Katalog enthält, dessen Vorschau Sie ansehen möchten.
Optional: Geben Sie eine Besucher-ID ein, um eine Vorschau der Suchergebnisse für diesen Nutzer aufzurufen.
Optional: Geben Sie eine Nutzer-ID ein, um eine Vorschau der Suchergebnisse für diesen Nutzer aufzurufen.
Optional: Geben Sie eine Suchzeit ein, um eine Vorschau der Suchergebnisse aufzurufen, die zu der angegebenen Zeit angezeigt würden.

Wenn Sie beispielsweise bestimmte Produkte für Black Friday beworben haben, sehen Sie die Ergebnisse so, wie sie an diesem Tag angezeigt würden.
Optional: Wählen Sie die Facetten aus, die neben den Suchergebnissen angezeigt werden sollen, und klicken Sie auf OK, um sie anzuwenden.

Anhand der von Ihnen ausgewählten Facets wird eine Liste von Facettenfiltern generiert, die nach der ersten Suche unter Facets hinzufügen angezeigt werden. Diese Facettenfilter können auch andere Facetten enthalten als die, die Sie in diesem Schritt auswählen, z. B. dynamische Facetten.
Geben Sie eine textbasierte Suchanfrage ein, um eine Vorschau der Suchergebnisse für diese Suchanfrage aufzurufen.
Klicken Sie auf Suchvorschau oder drücken Sie in einem beliebigen Eingabefeld die Eingabetaste, um die Ergebnisse zu sehen.

Die Suchergebnisse werden mit den verfügbaren Miniaturansichten angezeigt.

Wenn Ihre Suche eine Weiterleitungssteuerung auslöst, wird eine Benachrichtigung mit dem Weiterleitungs-URI angezeigt.
Optional: Klicken Sie auf das Symbol Raster oder Liste, um die Darstellung der Suchergebnisse in der Vorschau zu ändern.
Optional: Wenn Sie Facetten ausgewählt haben, die neben den Ergebnissen angezeigt werden sollen, wählen Sie einen oder mehrere Facettenwerte aus der Liste der Facetten aus, um die Ergebnisse nach diesen Werten zu filtern. Die Ergebnisse werden automatisch aktualisiert, sobald Sie eine Auswahl getroffen haben.

Wenn Sie mehrere Werte derselben Facette auswählen, werden sie wie ein ODER-Operator angewendet. Werte verschiedener Facetten werden wie ein UND-Operator angewendet. Beispiel: Sie haben die Facetten Farbe mit den Werten „Blau“ und „Gold“ sowie die Werte Material „Baumwolle“ und „Polyester“ ausgewählt. Ihre Suchergebnisse müssen entweder „blau“ oder „gold“ als Attribut und entweder „Baumwolle“ oder „Polyester“ als Attribut haben.

Durchsuchen

Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Bewerten auf.

Zur Seite „Bewerten“
Klicken Sie auf den Tab Durchsuchen.

Wählen Sie die Bereitstellungskonfiguration aus, für die Sie eine Vorschau sehen möchten.
Wählen Sie den Katalogzweig aus, der den Katalog enthält, dessen Vorschau Sie ansehen möchten.
Optional: Geben Sie eine Besucher-ID ein, um eine Vorschau der Ergebnisse für diesen Nutzer aufzurufen.
Optional: Geben Sie eine Nutzer-ID ein, um eine Vorschau der Ergebnisse für diesen Nutzer aufzurufen.
Wenn Sie sich eine Vorschau der Ergebnisse mit einem bestimmten Filter ansehen möchten, geben Sie einen Filterstring ein. Verwenden Sie die in der Filter-Dokumentation angegebene Syntax für Filterausdrücke.
Optional: Geben Sie eine Suchzeit ein, um eine Vorschau der Ergebnisse zu sehen, die zu der angegebenen Zeit angezeigt würden.

Wenn Sie beispielsweise bestimmte Produkte für ein Spitzenverkaufsereignis beworben haben, sehen Sie die Ergebnisse so, wie sie an diesem Tag angezeigt würden.
Geben Sie die Seitenkategorie ein, für die Sie die Suchergebnisse testen.
Optional: Wählen Sie die Facetten aus, die neben den Ergebnissen angezeigt werden sollen, und klicken Sie auf OK, um sie anzuwenden.

Anhand der von Ihnen ausgewählten Facets wird eine Liste von Facettenfiltern generiert, die nach der ersten Suche unter Facets hinzufügen angezeigt werden. Diese Facettenfilter können auch andere Facetten enthalten als die, die Sie in diesem Schritt auswählen, z. B. dynamische Facetten.
Klicken Sie auf Vorschau ansehen oder drücken Sie in einem beliebigen Eingabefeld die Eingabetaste, um die Ergebnisse zu sehen.

Die Ergebnisse werden mit den verfügbaren Thumbnail-Bildern angezeigt.
Optional: Klicken Sie auf das Symbol Raster oder Liste, um die Darstellung der Ergebnisse in der Vorschau zu ändern.
Optional: Wenn Sie Facetten ausgewählt haben, die neben den Ergebnissen angezeigt werden sollen, wählen Sie einen oder mehrere Facettenwerte aus der Liste der Facetten aus, um die Ergebnisse nach diesen Werten zu filtern. Die Ergebnisse werden automatisch aktualisiert, sobald Sie eine Auswahl getroffen haben.

Wenn Sie mehrere Werte derselben Facette auswählen, werden sie wie ein ODER-Operator angewendet. Werte aus verschiedenen Facetten werden wie ein UND-Operator angewendet. Nachdem Sie beispielsweise die Facetten Farbe und Material ausgewählt haben, können Sie Ihre Suchergebnisse filtern, indem Sie die Farbwerte „Blau“ und „Gold“ sowie die Materialwerte „Baumwolle“ und „Polyester“ auswählen. Ihre Ergebnisse müssen entweder „blau“ oder „gold“ als Attribut und entweder „Baumwolle“ oder „Polyester“ als Attribut haben.

Wenn Sie die Seite Details für die Bereitstellungskonfiguration aufrufen möchten, die Sie sich gerade in der Vorschau ansehen, klicken Sie unter dem Feld Bereitstellungskonfiguration auswählen auf Bereitstellungskonfiguration ansehen.