Cerca e sfoglia

Questo documento ha lo scopo di chiarire le distinzioni tra le funzionalità di ricerca e navigazione all'interno di AI Commerce Search per esplorare come configurare ciascuna in modo efficace e ottenere di più.

Comprendere le differenze principali

Sebbene la ricerca e la navigazione aiutino i clienti a trovare i prodotti, si rivolgono a percorsi utente diversi e richiedono configurazioni distinte.

Basate sull'intento dell'utente, in cui un acquirente inserisce una query specifica, ad esempio scarpe da corsa rosse. AI Commerce Search analizza questa query per comprendere le esigenze dell'utente e restituisce prodotti pertinenti ottimizzati per le entrate.

In breve, per la ricerca, AI Commerce Search è responsabile della pertinenza dei prodotti e del loro ranking (ottimizzato per le entrate).

Sfoglia

Guidata da categorie predefinite, in cui un acquirente naviga tra le schede di prodotto organizzate per attributi come brand, categoria o promozioni, ad esempio Camicie nella categoria Abbigliamento da uomo. Definisci queste categorie e visualizzi i prodotti al loro interno.

Sei responsabile della pertinenza dei prodotti elencati (tramite i filtri), mentre la ricerca AI Commerce è responsabile del ranking (ottimizzato per le entrate).

Configurare la ricerca e la navigazione

Il bello di AI Commerce Search è la sua API unificata per le richieste di ricerca e navigazione.

Configurare la ricerca

Gli eventi utente per la ricerca devono avere questi campi, insieme ad altri campi obbligatori standard per gli eventi utente (eventType = "search"):

  • Query di testo: il fulcro di una richiesta di ricerca. Acquisisce l'intenzione di ricerca dell'utente.
  • Filtri (facoltativo): consentono agli utenti di perfezionare i risultati di ricerca applicando facet come brand, fascia di prezzo o colore.
  • Ranking e personalizzazione: AI Commerce Search ottimizza automaticamente il ranking dei risultati di ricerca in base alla pertinenza e alle entrate potenziali. La personalizzazione adatta ulteriormente i risultati in base al comportamento dei singoli utenti.

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

Per le query di base con la ricerca, incluse le ricerche di query di testo, le ricerche di navigazione, la paginazione, l'ottimizzazione e i risultati personalizzati, consulta Ottenere risultati di ricerca.

Configura la navigazione

Gli eventi utente per le ricerche di navigazione devono avere questi campi, insieme ad altri campi obbligatori standard per gli eventi utente (eventType = "search" per gli eventi di navigazione):

  • Categorie di pagine: page_categories rappresenta la categoria o il banner in cui vengono visualizzati i prodotti. Tuttavia, nelle librerie client fisiche o nelle API precedenti, questo campo potrebbe ancora essere visualizzato come page_category al singolare. Il plurale può facoltativamente essere uguale a categories[] nel catalogo. Deve solo rappresentare la categoria rappresentata dal filtro.

  • Filtro obbligatorio: definisce i criteri per l'inclusione dei prodotti nei risultati di navigazione. In questo modo, nella categoria vengono visualizzati solo i prodotti pertinenti.

  • Allineamento tra evento e richiesta: l'evento utente corrispondente all'azione di navigazione deve contenere gli stessi valori di page_categories e filtro corrispondenti a quelli passati nella richiesta API.

  • Sfoglia e filtra impostati con lo stesso valore: per impostare i campi pageCategories (sfoglia) e attributes.pageCategories (filtro) con lo stesso valore, crea un oggetto attributes.pageCategories non ricercabile ed elenca ogni pagina in cui deve essere visualizzato questo prodotto per facilitare il filtraggio.

Per i filtri di navigazione, i campi come category o categoryid, come mostrato in questi esempi, sono in genere attributi personalizzati che fornisci.

Di seguito sono riportati i quattro esempi menzionati di diverse opzioni di richiesta di navigazione. Scegli un solo 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)