Búsqueda y navegación

El objetivo de este documento es aclarar las diferencias entre las funciones de búsqueda y exploración en la Búsqueda de comercio potenciada por IA para explorar cómo configurar cada una de manera eficaz y aprovechar al máximo sus beneficios.

Comprende las diferencias principales

Si bien la búsqueda y la exploración ayudan a los clientes a encontrar productos, se adaptan a diferentes recorridos del usuario y requieren configuraciones distintas.

Se basa en la intención del usuario, en la que un comprador ingresa una búsqueda específica, como calzado rojo para correr. La Búsqueda de comercio con IA analiza esta búsqueda para comprender las necesidades del usuario y devuelve productos relevantes optimizados para generar ingresos.

En resumen, en el caso de la búsqueda, la Búsqueda de comercio con IA es responsable de la relevancia de los productos y su clasificación (optimizada para los ingresos).

Explorar

Guiada por categorías predefinidas, en la que un comprador navega por las fichas de productos organizadas por atributos como marca, categoría o promociones, como Camisas en la categoría Ropa para hombres. Tú defines estas categorías y muestras los productos en ellas.

Tú eres responsable de la relevancia de los productos que se muestran (a través de filtros), y la Búsqueda de comercio potenciada por IA es responsable de su clasificación (optimizada para los ingresos).

Configura la búsqueda y la exploración

La belleza de AI Commerce Search radica en su API unificada para las solicitudes de búsqueda y navegación.

Configura la búsqueda

Los eventos de usuario para la búsqueda deben tener estos campos, junto con otros campos obligatorios estándar para los eventos de usuario (eventType = "search"):

  • Consulta de texto: Es el núcleo de una solicitud de búsqueda. Capta la intención de búsqueda del usuario.
  • Filtros (opcional): Permite que los usuarios definan mejor los resultados de la búsqueda aplicando facetas como marca, intervalo de precios o color.
  • Clasificación y personalización: AI Commerce Search optimiza automáticamente la clasificación de los resultados de la búsqueda en función de la relevancia y los ingresos potenciales. La personalización adapta aún más los resultados según el comportamiento individual del usuario.

  # 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)

Para realizar consultas básicas con la Búsqueda, incluidas las búsquedas de consultas de texto, las búsquedas de navegación, la paginación, la optimización y los resultados personalizados, consulta Cómo obtener resultados de la búsqueda.

Configura la función de exploración

Los eventos de usuario para las búsquedas de exploración deben tener estos campos, junto con otros campos obligatorios estándar para los eventos de usuario (eventType = "search" para los eventos de exploración):

  • Categorías de la página: page_categories representa la categoría o el banner en el que aparecen los productos. Sin embargo, en las bibliotecas cliente físicas o en las APIs más antiguas, este campo aún puede aparecer como el singular page_category. De manera opcional, el plural puede ser el mismo que categories[] en el catálogo. Solo debe representar la categoría que representa el filtro.

  • Filtro obligatorio: Define los criterios para que los productos se incluyan en los resultados de la navegación. Esto garantiza que solo aparezcan productos relevantes en la categoría.

  • Alineación entre el evento y la solicitud: El evento del usuario correspondiente a la acción de exploración debe contener los mismos valores de page_categories y de filtro que se pasaron en la solicitud a la API.

  • Navegar y filtrar con el mismo valor: Para establecer los campos pageCategories (navegar) y attributes.pageCategories (filtrar) con el mismo valor, crea un objeto attributes.pageCategories que no se pueda buscar y enumera todas las páginas en las que debería aparecer este producto para facilitar el filtrado.

En el caso de los filtros de exploración, los campos como category o categoryid, como se muestra en estos ejemplos, suelen ser atributos personalizados que proporcionas.

A continuación, se muestran los cuatro ejemplos mencionados de diferentes opciones de solicitudes de exploración. (solo elige un formato).

  # 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)