Suchen und surfen

In diesem Dokument werden die Unterschiede zwischen den Such- und Browsingfunktionen in AI Commerce Search erläutert. Außerdem wird beschrieben, wie Sie die Funktionen effektiv konfigurieren und optimal nutzen können.

Die wichtigsten Unterschiede

Mit der Such- und Browsingfunktion können Kunden Produkte finden. Sie sind jedoch für unterschiedliche Nutzerpfade konzipiert und erfordern unterschiedliche Konfigurationen.

Die Suche basiert auf der Nutzerabsicht. Der Käufer gibt eine bestimmte Suchanfrage ein, z. B. rote Laufschuhe. AI Commerce Search analysiert diese Suchanfrage, um die Bedürfnisse des Nutzers zu verstehen, und gibt relevante Produkte zurück, die für den Umsatz optimiert sind.

Kurz gesagt: Bei der Suche ist AI Commerce Search für die Relevanz der Produkte und ihr Ranking verantwortlich (umsatzoptimiert).

Durchsuchen

Die Browsingfunktion basiert auf vordefinierten Kategorien. Der Käufer navigiert durch Produktangebote, die nach Attributen wie Marke, Kategorie oder Werbeaktionen organisiert sind, z. B. Shirts in der Kategorie Herrenbekleidung. Sie definieren diese Kategorien und legen fest, welche Produkte darin angezeigt werden.

Sie sind für die Relevanz der aufgeführten Produkte verantwortlich (über Filter) und AI Commerce Search für das Ranking (umsatzoptimiert).

Suche und Browsing konfigurieren

Der Vorteil von AI Commerce Search liegt in der einheitlichen API für Such- und Browsinganfragen.

Suche konfigurieren

Nutzerereignisse für die Suche müssen neben anderen obligatorischen Standardfeldern für Nutzerereignisse (eventType = "search") die folgenden Felder enthalten:

  • Textabfrage: Der Kern einer Suchanfrage. Sie erfasst die Suchabsicht des Nutzers.
  • Filter (optional): Ermöglichen Sie Nutzern, Suchergebnisse durch Anwenden von Facets wie Marke, Preisspanne oder Farbe zu verfeinern.
  • Ranking und Personalisierung: AI Commerce Search optimiert das Ranking der Suchergebnisse automatisch basierend auf Relevanz und potenziellem Umsatz. Durch die Personalisierung werden die Ergebnisse weiter an das individuelle Nutzerverhalten angepasst.

  # Construct the search request
  search_request = {
      "query": "red running shoes", # User's search query
      "filter": "brand:ANY('Nike')", # Optional filter
      "page_size": 10 # Number of results per page
  }



# Send the request to the VAIS:Commerce API
  search_response = client.search(search_request)



# Process the search results
  for product in search_response.results:
      print(product.title, product.price)

Informationen zu grundlegenden Abfragen mit der Suche, einschließlich Textabfragen, Browsing-Suchen, Paginierung, Optimierung und personalisierten Ergebnissen, finden Sie unter Suchergebnisse abrufen.

Browsing konfigurieren

Nutzerereignisse für Browsing-Suchen müssen neben anderen obligatorischen Standardfeldern für Nutzerereignisse (eventType = "search" für Browsing-Ereignisse) die folgenden Felder enthalten:

  • Seitenkategorien: page_categories steht für die Kategorie oder das Banner, unter dem Produkte angezeigt werden. In physischen Clientbibliotheken oder älteren APIs wird dieses Feld möglicherweise noch als Singular page_category angezeigt. Der Plural kann optional mit categories[] im Katalog identisch sein. Er muss lediglich die Kategorie darstellen, die der Filter repräsentiert.

  • Obligatorischer Filter: Definiert die Kriterien für Produkte, die in die Browsing-Ergebnisse aufgenommen werden sollen. So werden in der Kategorie nur relevante Produkte angezeigt.

  • Übereinstimmung zwischen Ereignis und Anfrage: Das Nutzerereignis, das der Browsing-Aktion entspricht, sollte dieselben page_categories und Filterwerte enthalten wie in der API-Anfrage.

  • Browsing- und Filtersatz mit demselben Wert: Wenn Sie die Felder pageCategories (Browsing) und attributes.pageCategories (Filter) mit demselben Wert festlegen möchten, erstellen Sie ein nicht durchsuchbares attributes.pageCategories-Objekt und listen Sie alle Seiten auf, auf denen dieses Produkt angezeigt werden soll, um das Filtern zu erleichtern.

Bei Browsing-Filtern sind Felder wie category oder categoryid, wie in diesen Beispielen gezeigt, in der Regel benutzerdefinierte Attribute, die Sie angeben.

Hier sind die oben genannten vier Beispiele für verschiedene Optionen für Browsing-Anfragen. Wählen Sie einfach ein Format aus.

  # a browse request with a custom category attribute
  browse_request = {
      "page_categories": ["Men's > Clothing > Shirts"], # Represents full taxonomy Path on the site
      "filter": "category:ANY('Shirts') AND gender: ANY('Male')", # Compulsory filter on custom attribute
      "page_size": 10
  }
  # a browse request showing category ID (Men's shirts custom id)
  browse_request = {
      "page_categories": ["Men's > Clothing > Shirts"],
      "filter": "categoryid:ANY(1234)", # Another custom attribute for categories
      "page_size": 10
  }
  # another example showing category ID's (Men's shirts custom id)
  browse_request = {
      "page_categories": ["1234"],  # Also ok to use unique category id's here
      "filter": "categoryid:ANY(1234)",
      "page_size": 10
  }
  # browse and filter set with the same value
  browse_request = {
      "page_category": ["Men's > Clothing > Shirts"], # Browse category
      "filter": "attributes.pageCategories:ANY('Men's > Clothing > Shirts')", # Compulsory filter
      "page_size": 10 # Number of results per page
  }
  # Send the request to the API
  browse_response = client.search(browse_request)
  # Process the browse results
  for product in browse_response.results:
      print(product.title, product.price)