Retail 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 und personalisierte Ergebnisse.

Personalisierte Ergebnisse eines Endnutzers werden nie im Cache gespeichert und es werden keine personalisierten Ergebnisse zurückgegeben. Endanwendenden mitteilen.

Über die Textsuche und die Stöbersuche mit der Suche

Die Suche bietet sowohl die Textabfrage als auch das Durchsuchen Suchfunktionen.

Im Anwendungsfall einer Textabfrage könnte ein Käufer für Ihre Website. Die Suche gibt eine Suchantwort zurück, die Produkte enthält die den Parametern der von Ihnen eingerichteten Steuerelemente entsprechen, sortiert nach Relevanz und Umsatzmaximierung.

Im Anwendungsfall „Browse“ (Durchsuchen) könnte ein Käufer das Websitemenü aufrufen und navigieren Sie zu einer bestimmten Produktkategorie. Automatisch suchen wählt die Sortierreihenfolge mit dem höchsten Umsatz aus, indem es aus dem Nutzerverhalten lernt. und Trends. Die Suchergebnisse können durch die von Ihnen festgelegten Steuerelemente weiter verfeinert werden. nach oben.

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

Suchanfragen mit Textabfrage

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

In der Google Suche werden servingConfigs.search-Anfragen textbasierte Suchanfrage, 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 userEvent.searchQuery-Feld und ein leeres userEvent.pageCategories-Feld wird dies als textbasiertes Suchereignis betrachtet.

Suchanfragen ansehen

Normalerweise liefert das Durchsuchen von Produkten mithilfe der Website-Navigation Ergebnisse, die alle oder nach meistverkauften Artikeln sortiert sind. Die Google Suche nutzt KI, um die Suche nach Ergebnissen zu optimieren werden nach Beliebtheit, Kaufbarkeit und Personalisierung sortiert.

Wenn die Methode servingConfigs.search eine Anfrage sendet, suchen betrachtet dies als Suchanfrage, 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.

Um die richtigen Stöbersuchergebnisse zu erhalten, pageCategories und filter müssen die Werte in Ihren Suchanfragen genau mit pageCategories und filter-Werte in den hochgeladenen Nutzerereignissen. Stimmen sie nicht genau überein, wenn die Daten in den Suchanfragen möglicherweise nicht erkannt werden, die Qualität der Ergebnisse. Bei der Suchfunktion wird nur der erste Kategoriewert in pageCategories erkannt.

Suchen

Verwenden Sie Suchanfragen, um Ergebnisse sowohl für Textsuchen als auch für Stöbersuchen zu 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 Durchsuchen-Suchanfragen muss das Feld pageCategories leer sein.

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 diesem Tutorial erfahren Sie, wie Sie eine textbasierte Suchanfrage an die Vertex AI Search for Retail-Dienst und analysieren die Antwort.

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 verringern.

Anleitung zum Seitenumbruch

In dieser Anleitung erfahren Sie, wie Sie die Paginierung in einer textbasierten Suchanfrage steuern. Wenn ein Käufer in einem Geschäft nach Produkten sucht, kann er seine Navigation verbessern. in den Suchergebnissen. 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
}

Suchleistungsstufen

Die Google Suche bietet mehrere Stufen der Suchleistung, um Ihre Ergebnisse zu verbessern. Für Anwendungsfälle bei der Textabfragesuche sind z. B. Ergebnisse allein auf der Relevanz basieren. Je mehr Leistung Sie nutzen, kann die Suche Ergebnisse zurückgeben, die auf Relevanz, Beliebtheit, Umsatzoptimierung und Personalisierung.

Die Google Suche aktiviert automatisch höhere Leistungsstufen, wenn Sie Katalog- und Nutzerereignisdaten hochladen, die den Mindestanforderungen der einzelnen Stufe.

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 zur Verwendung dieses finden Sie unter Suche aktivieren oder deaktivieren. Leistungsstufen.

Textsuche auswerten und Ergebnisse durchsuchen

Bevor Sie den Code Ihrer Website aktualisieren, um eine Textsuche anzufordern oder eine Suche zu starten erhalten Sie eine Vorschau der Ergebnisse, um zu prüfen, ob Ihre Bereitstellungskonfiguration wie erwartet funktioniert.

Weitere Informationen zu Bereitstellungskonfigurationen finden Sie unter Bereitstellungskonfigurationen

Sie können die Ergebnisse der Bereitstellungskonfiguration entweder auf der Seite Bewerten als Vorschau ansehen oder rufen Sie die Seite Details einer Bereitstellungskonfiguration in der Console auf und klicken Sie auf das Bewerten. Die folgenden Schritte zeigen, wie Sie über das Seite Bewerten:

So sehen Sie sich eine Vorschau der Ergebnisse an, die von Ihrer Bereitstellungskonfiguration zurückgegeben werden:

Textsuche

Rufen Sie in der Search for Retail-Konsole 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 dieser Funktion findest du unter Hinweis
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 anzuzeigen.
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 Attributfilter können auch Attribute enthalten, die Sie in diesem Schritt nicht auswählen. wie dynamische Attribute.
Geben Sie eine textbasierte Suchanfrage ein, um eine Vorschau der Suchergebnisse dafür anzuzeigen.
Klicken Sie auf Vorschau suchen oder drücken Sie die Eingabetaste in einem Eingabefeld, 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 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 desselben Attributs auswählen, werden sie als Der Operator OR wäre und Werte für verschiedene Attribute werden angewendet als den Operator AND. Nachdem Sie beispielsweise die Attribute „Farbe“ ausgewählt haben, und hat den Wert „blue“. und „Gold“ und das Material den Wert „Baumwolle“ und „Polyester“. In den Suchergebnissen muss entweder „blau“ enthalten sein oder „Gold“ als Attribut und muss außerdem entweder "Baumwolle" enthalten oder „Polyester“ als .

Durchsuchen

Rufen Sie in der Search for Retail-Konsole 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 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 Ergebnisse für diesen Nutzer anzuzeigen.
Optional: Geben Sie eine Nutzer-ID ein, um eine Vorschau der Ergebnisse für diesen Nutzer anzuzeigen.
Um eine Vorschau zu sehen, wie die Ergebnisse mit einem bestimmten Filter aussehen würden, geben Sie einen Filterstring ein. Verwenden Sie die Filterausdruckssyntax, die in den Filter.
Optional: Geben Sie eine Suchzeit ein, um eine Vorschau der angezeigten Ergebnisse zu erhalten. 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.
Geben Sie die Seitenkategorie ein, für die Sie Stöberergebnisse testen.
Optional: Wählen Sie Attribute aus, die neben den Ergebnissen 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 Attributfilter können auch Attribute enthalten, die Sie in diesem Schritt nicht auswählen. wie dynamische Attribute.
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 Rastersymbol oder das Listensymbol, um die werden in der Vorschau angezeigt.
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 desselben Attributs auswählen, werden sie als Der Operator OR wäre und Werte für verschiedene Attribute werden angewendet als den Operator AND. Nachdem Sie beispielsweise 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 .

Um die Seite Details für die Bereitstellungskonfiguration aufzurufen, die Sie als Vorschau ansehen, klicken Sie auf Rufen Sie die Bereitstellungskonfiguration im Feld Bereitstellungskonfiguration auswählen auf.