„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 Suchanfragen in der Google Suche beschrieben, einschließlich Textsuche. Suchanfragen, das Durchsuchen von Suchanfragen, die Paginierung, Optimierung personalisierte Ergebnisse.

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.

Über die Textsuche und die Stöbersuche mit der 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 Anwendungsfall „Browse“ (Durchsuchen) könnte ein Käufer das Websitemenü aufrufen und navigieren Sie zu einer bestimmten Produktkategorie. Die Sortierung, die den Umsatz am besten steigert, wird automatisch ausgewählt. Dabei wird das Nutzerverhalten und aktuelle Trends berücksichtigt. Die Suchergebnisse können mithilfe der von Ihnen festgelegten Steuerelemente weiter eingegrenzt werden.

Sowohl bei Text- als auch bei Suchanfragen wird die Methode servingConfigs.search-Methode.

Suchanfragen mit Textabfrage

Wenn ein Nutzer eine Textanfrage eingibt, um auf Ihrer Website zu suchen, Sortiert potenzielle Suchergebnisse nach Relevanz, Beliebtheit, Kaufbarkeit Personalisierung.

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

Beim Hochladen eines Nutzerereignisses Textabfrage-Suchereignisse senden, die von als search-Nutzerereignisse suchen. 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

Wenn Sie Produkte über die Navigation der Website suchen, sind die Ergebnisse in der Regel alle gleich relevant oder 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.

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 filter und pageCategories-Feldern sowie weitere Optimierung und Personalisierung, falls verfügbar.

Achten Sie beim Hochladen von Nutzerereignissen darauf, dass Sie Suchereignisse die durch die Suche als search-Nutzerereignisse generiert wurden. In der Suche wird ein search-Nutzerereignis als surfbasiertes Ereignis betrachtet wenn es ein leeres userEvent.searchQuery-Feld und ein nicht leeres userEvent.pageCategories.

Damit Sie korrekte Ergebnisse für die Stöbersuche erhalten, müssen die pageCategories- und filter-Werte in Ihren Suchanfragen genau mit den pageCategories- und filter-Werten in Ihren hochgeladenen Nutzerereignissen übereinstimmen. Wenn sie nicht genau übereinstimmen, werden die Daten in den Suchanfragen möglicherweise nicht erkannt, was sich negativ auf die Qualität der Ergebnisse auswirken kann. Bei der Suchfunktion wird nur der erste Kategoriewert in pageCategories erkannt.

Suchen

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

Alle Suchanfragen erfordern placement, das den vollständigen Ressourcennamen identifiziert der verwendeten Bereitstellungskonfiguration an. Die Bereitstellungskonfiguration bestimmt, und die zugehörigen Steuerelemente auf die Suchergebnisse auswirken.

Für Suchanfragen für Textabfragen darf das Feld query nicht leer sein.

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. Sie können beispielsweise die Anzahl der Elemente in mit der Funktion für die Seitengröße zu sehen, oder springen Sie zu einer mithilfe der Versatzfunktion.

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 Suche bietet mehrere Stufen der Suchleistung, um Ihre Ergebnisse zu verbessern. Bei Anwendungsfällen für die Suche mit Textabfragen können die Ergebnisse beispielsweise ausschließlich auf der Relevanz basieren. Je mehr Leistung Sie nutzen, kann die Suche Ergebnisse zurückgeben, die auf Relevanz, Beliebtheit, Umsatzoptimierung und Personalisierung.

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

Die Seite Datenqualität zu können Sie in der Search for Retail-Konsole ermitteln, die Sie für die einzelnen Stufen erfüllen. 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 auswerten und Ergebnisse durchsuchen

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 sehen Sie sich eine Vorschau der Ergebnisse an, 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 du die Suche aktiviert ist. Eine Anleitung zum Aktivieren finden Sie unter Vorbereitung.
Wählen Sie die Bereitstellungskonfiguration aus, die Sie als Vorschau ansehen möchten.
Wählen Sie den Katalogzweig aus, der den Katalog enthält, für den Sie eine Vorschau anzeigen 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 anzuzeigen.
Optional: Geben Sie eine Suchzeit ein, um eine Vorschau der angezeigten Suchergebnisse zu sehen. zur angegebenen Zeit.

Wenn Sie beispielsweise bestimmte Produkte zum Black Friday beworben haben, können die Ergebnisse so sehen, wie sie an diesem Tag angezeigt werden.
Optional: Wählen Sie Attribute aus, die neben den Suchergebnissen angezeigt werden sollen, und klicken Sie auf OK, um sie anzuwenden.

Mit den ausgewählten Attributen wird eine Liste von Attributfiltern generiert, die werden nach der ersten Suche unter Attribute hinzufügen angezeigt. 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 Vorschau suchen oder drücken Sie in einem beliebigen Eingabefeld die Eingabetaste, um die Ergebnisse.

Die Suchergebnisse werden mit den verfügbaren Miniaturansichten angezeigt.

Wenn Ihre Suche ein Steuerelement für die Weiterleitung auslöst, wird ein Hinweis angezeigt, Weiterleitungs-URI
Optional: Klicken Sie auf das Rastersymbol oder das Listensymbol, um die Suchergebnisse werden in der Vorschau angezeigt.
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, wenn Sie eine Auswahl treffen.

Wenn Sie mehrere Werte derselben Facette auswählen, werden sie wie ein OR-Operator angewendet. Werte aus verschiedenen Facetten werden wie ein AND-Operator angewendet. Beispiel: Sie haben die Facetten „Farbe“ und die Werte „Blau“ und „Gold“ sowie die Materialwerte „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.
Um eine Vorschau zu sehen, wie die Ergebnisse mit einem bestimmten Filter aussehen würden, 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 angezeigten Ergebnisse zu erhalten. zur angegebenen Zeit.

Wenn Sie beispielsweise bestimmte Produkte für Black Friday 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 Attribute 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 durchsuchen oder drücken Sie in einem beliebigen Eingabefeld die Eingabetaste, um die Ergebnisse.

Die Ergebnisse werden mit den verfügbaren Miniaturansichten angezeigt.
Optional: Klicken Sie auf das Symbol Raster oder Liste, um die Darstellung der Ergebnisse in der Vorschau zu ändern.
Optional: Wenn Sie Attribute ausgewählt haben, die neben Ihren Ergebnissen angezeigt werden sollen, wählen Sie Ein oder mehrere Attributwerte aus der Attributliste, um die Ergebnisse danach zu filtern Werte. Die Ergebnisse werden automatisch aktualisiert, sobald Sie die Auswahl getroffen haben.

Wenn Sie mehrere Werte derselben Facette auswählen, werden sie wie ein OR-Operator angewendet. Werte aus verschiedenen Facetten werden wie ein AND-Operator angewendet. Nachdem Sie z. B. die Attribute „Farbe“ ausgewählt haben, und "Material" eingeben, können Sie die Suchergebnisse filtern, indem Sie Farbwert „blue“ und „Gold“ und das Material den Wert „Baumwolle“ und „Polyester“. Ihre Ergebnisse müssen entweder „blau“ sein oder „Gold“ als Attribut und muss außerdem entweder "Baumwolle" enthalten oder „Polyester“ als .

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.