Il nome del retail verrà rinominato Vertex AI Search per il retail. Stiamo aggiornando i contenuti per riflettere il nuovo branding.

Visualizza i risultati di ricerca

In questa pagina vengono descritte le query di base con la ricerca, tra cui ricerche di query di testo, ricerche di navigazione, impaginazione, ottimizzazione e risultati personalizzati.

Non memorizzare mai nella cache i risultati personalizzati di un utente finale e non restituire mai risultati personalizzati a un utente finale diverso.

Informazioni sulla ricerca testuale e ricerca con navigazione con la ricerca

La Ricerca offre funzionalità di ricerca sia tramite query di testo sia con la ricerca.

Nel caso d'uso della ricerca tramite query di testo, un acquirente potrebbe inserire una query basata su testo nel tuo sito. La ricerca restituisce una risposta di ricerca contenente i prodotti che rientrano nei parametri dei controlli che hai configurato, ordinati per pertinenza e massimizzazione delle entrate.

Nel caso d'uso Sfoglia, un acquirente può accedere al menu del sito e accedere a una categoria di prodotto specifica. La rete di ricerca sceglie automaticamente l'ordinamento in cui è possibile massimizzare le entrate in base al comportamento e alle tendenze degli utenti. I risultati di navigazione possono essere ulteriormente perfezionati dai controlli configurati.

Sia le richieste di ricerca testuale sia quelle di navigazione utilizzano il metodo servingConfigs.search.

Ricerche di query di testo

Quando un utente inserisce una query di testo per effettuare una ricerca sul tuo sito, la ricerca ordina i potenziali risultati di ricerca in base a pertinenza, popolarità, acquistabilità e personalizzazione.

La ricerca considera una richiesta servingConfigs.search come una richiesta di ricerca basata su testo se ha un campo query non vuoto.

Quando carichi un evento utente, invia gli eventi di ricerca con query di testo generati dalla ricerca come eventi utente search. Se l'evento ha un campo userEvent.searchQuery non vuoto e un campo userEvent.pageCategories vuoto, la ricerca lo considera un evento di ricerca basato su testo.

Sfoglia ricerche

In genere, sfogliare i prodotti utilizzando la navigazione del sito produce risultati di pari pertinenza o ordinati in base agli articoli più venduti. La Ricerca sfrutta l'AI per ottimizzare l'ordinamento dei risultati in base a popolarità, comprabilità e personalizzazione.

Quando il metodo servingConfigs.search invia una richiesta, la ricerca la considera una richiesta di consultazione se il campo query è vuoto. In questo caso, i risultati si basano sui campi filter e pageCategories e, se disponibili, vengono ottimizzate ulteriormente ottimizzazioni e personalizzazioni.

Quando carichi un evento utente, assicurati di inviare eventi di ricerca con navigazione generati dalla ricerca come eventi utente search. La ricerca considera un evento utente search come evento basato sulla consultazione se ha un campo userEvent.searchQuery vuoto e un campo userEvent.pageCategories non vuoto.

Per ottenere risultati di ricerca corretti, i valori pageCategories e filter nelle richieste di ricerca devono corrispondere esattamente ai valori pageCategories e filter negli eventi utente caricati. Se non corrispondono esattamente, i dati nelle richieste di ricerca potrebbero non essere riconosciuti, il che può influire negativamente sulla qualità dei risultati.

Cerca

Utilizza le richieste di ricerca per ottenere risultati sia per le ricerche testuali sia per le ricerche di navigazione. Per effettuare una richiesta di ricerca, utilizza il metodo servingConfigs.search.

Tutte le richieste di ricerca richiedono placement, che identifica il nome completo della risorsa della configurazione di pubblicazione che verrà utilizzata. La configurazione di pubblicazione determina quali impostazioni e i controlli associati influiscono sui risultati di ricerca.

Per le richieste di ricerca di query di testo è necessario un campo query non vuoto.

Le richieste di ricerca con esplorazione richiedono un campo pageCategories non vuoto.

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);
  }
}

Per impostazione predefinita, viene restituito un numero ragionevole di risultati ordinati in base alla pertinenza.

Per far sì che gli attributi del prodotto vengano restituiti con la risposta della ricerca, assicurati di specificare i valori degli attributi quando importi i dati del catalogo. L'app Product presenta attributi di sistema predefiniti, come marca, colore e taglia, per i quali puoi specificare dei valori. Puoi anche includere attributi personalizzati che definisci con Product.attributes.

Tutorial sulle query

Questo tutorial mostra come inviare una query di ricerca basata su testo al servizio Vertex AI Search per la vendita al dettaglio e analizzare la risposta.

Per seguire le indicazioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su Aiuto:

Guidami

Impaginazione

Utilizza l'impaginazione per ridurre i tempi di ricerca e le dimensioni delle risposte inviate.

Tutorial sull'impaginazione

Questo tutorial mostra come controllare l'impaginazione in una richiesta di ricerca basata su testo. Quando un acquirente cerca i prodotti in un negozio, può migliorare la navigazione tra i risultati di ricerca. Ad esempio, possono limitare il numero di elementi nella risposta della ricerca utilizzando la funzionalità Dimensioni pagina o passare alla pagina preferita utilizzando la funzionalità Offset.

Per seguire le indicazioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su Aiuto:

Guidami

Impaginazione

Per passare da una pagina all'altra, usa page_token o offset, a seconda del tuo caso d'uso.

Per passare alla pagina successiva, puoi utilizzare page_token. Ad esempio, supponi di inviare il seguente SearchRequest.

JSON

{
  placement: 'projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/placements/default_search'
  visitor_id: 'VISITOR_ID'
  query: 'shoes'
  page_size: 5
}

Da SearchResponse, puoi ottenere i prodotti risultanti con i 5 migliori pertinenza, insieme a un next_page_token.

JSON

{
  results: [
    products{...}, products{...}, products{...}, products{...}, products{...}
  ]
  next_page_token: "wY4ETNkBDOlVjZ0YWLzUmM40SMhVjMtADMwATL5UGN5MGZlVDJaIQ5LaYsQUw9fC6lIwgE1EgC"
  total_size: 100
  search_token: "NtQKDAiXt4_3BRDCg_jnARABGiQ1ZWRjOTRlOC0wMDAwLTI1YTEtODJlMy1mNGY1ZTgwZDUxOGM"
}

Per ottenere i risultati dei prodotti con i prossimi 5 prodotti di pertinenza (dal 6° alla 10°), devi impostare page_token utilizzando le stesse placement, visitor_id e query di next_page_token del precedente 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 questo esempio, SearchRequest ha il seguente aspetto:

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 altri casi, invece di navigare da una pagina all'altra o di ottenere risultati con la massima pertinenza, puoi passare direttamente a una determinata posizione con offset.

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);
  }
}

Ad esempio, se vuoi trovare la decima pagina dei risultati quando la dimensione della pagina è 5, puoi impostare offset su 45, che viene calcolato come segue: (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
}

Cerca livelli di prestazioni

Ricerca offre diversi livelli di prestazioni che migliorano sempre di più i risultati. Ad esempio, per i casi d'uso della ricerca di query di testo, i risultati potrebbero essere basati esclusivamente sulla pertinenza. Man mano che acquisisci livelli di rendimento più avanzati, la ricerca può restituire risultati basati su pertinenza, popolarità, ottimizzazione delle entrate e personalizzazione.

La ricerca sblocca automaticamente livelli di prestazioni più elevati quando carichi dati sul catalogo e sugli eventi utente che soddisfano i requisiti minimi di ogni livello.

La pagina Qualità dei dati nella console di Search for Retail fornisce una valutazione dei requisiti soddisfatti per ogni livello. Per ulteriori informazioni sull'utilizzo di questa pagina per visualizzare la qualità dei dati e i livelli di prestazioni della ricerca, consulta Sblocca i livelli di rendimento della ricerca.

Valuta la ricerca testuale e sfoglia i risultati

Prima di aggiornare il codice del tuo sito web per richiedere una ricerca testuale o sfogliare i risultati di ricerca, puoi visualizzare l'anteprima dei risultati per verificare che la configurazione di pubblicazione funzioni come previsto.

Per ulteriori informazioni sulle configurazioni di pubblicazione, consulta Informazioni sulle configurazioni di pubblicazione.

Puoi visualizzare l'anteprima dei risultati della configurazione di pubblicazione dalla pagina Valuta o accedendo alla pagina Dettagli di una configurazione di pubblicazione nella console e facendo clic sulla scheda Valuta. I passaggi seguenti mostrano come visualizzare l'anteprima dalla pagina Valuta.

Per visualizzare l'anteprima dei risultati restituiti dalla configurazione di pubblicazione:

Ricerca testo

Vai alla pagina Valuta nella console di Search for Retail.

Vai alla pagina Valuta
Fai clic sulla scheda Ricerca.

Nota: la scheda Ricerca è disponibile solo se hai attivato la ricerca. Per istruzioni su come attivarlo, consulta Prima di iniziare.
Seleziona la configurazione di pubblicazione di cui vuoi visualizzare l'anteprima.
Seleziona il ramo del catalogo che contiene il catalogo di cui vuoi visualizzare l'anteprima.
(Facoltativo) Inserisci un ID visitatore per visualizzare l'anteprima dei risultati di ricerca per quell'utente.
(Facoltativo) Inserisci un ID utente per visualizzare l'anteprima dei risultati di ricerca per l'utente in questione.
(Facoltativo) Inserisci un'ora di ricerca per visualizzare l'anteprima dei risultati di ricerca che verrebbero mostrati nel momento specificato.

Ad esempio, se hai promosso determinati prodotti per il Black Friday, puoi vedere i risultati così come appariranno nel giorno in questione.
(Facoltativo) Seleziona i facet da visualizzare accanto ai risultati di ricerca e fai clic su OK per applicarli.

I facet selezionati vengono utilizzati per generare un elenco di filtri dei facet visualizzati in Aggiungi facet dopo aver eseguito la ricerca iniziale. Questi filtri dei facet possono includere facet diversi da quelli selezionati in questo passaggio, ad esempio facet dinamici.
Inserisci una query di ricerca basata su testo per visualizzare l'anteprima dei risultati di ricerca relativi a quella query.
Fai clic su Anteprima ricerca o premi Invio in un campo di immissione per visualizzare i risultati.

I risultati di ricerca vengono visualizzati con le relative immagini in miniatura disponibili.

Se la ricerca attiva un controllo del reindirizzamento, viene visualizzata una notifica che mostra l'URI di reindirizzamento.
(Facoltativo) Fai clic sull'icona Griglia o sull'icona Elenco per cambiare la modalità di visualizzazione dei risultati di ricerca in anteprima.
(Facoltativo) Se hai selezionato i facet da visualizzare accanto ai risultati, seleziona uno o più valori dei facet dall'elenco per filtrare i risultati in base a questi valori. I risultati vengono aggiornati automaticamente al momento della selezione.

Quando selezioni più valori per lo stesso facet, questi vengono applicati come un operatore OR, mentre i valori nei diversi facet vengono applicati come un operatore AND. Ad esempio, dopo aver selezionato i facet "colore" e i valori "blu" e "oro", e i valori del materiale "cotone" e "poliestere". I risultati di ricerca devono avere come attributo "blu" o "oro" e anche "cotone" o "poliestere".

Sfoglia

Vai alla pagina Valuta nella console di Search for Retail.

Vai alla pagina Valuta
Fai clic sulla scheda Sfoglia.

Seleziona la configurazione di pubblicazione di cui vuoi visualizzare l'anteprima.
Seleziona il ramo del catalogo che contiene il catalogo di cui vuoi visualizzare l'anteprima.
(Facoltativo) Inserisci un ID visitatore per visualizzare l'anteprima dei risultati per l'utente in questione.
(Facoltativo) Inserisci un ID utente per visualizzare l'anteprima dei risultati relativi all'utente in questione.
(Facoltativo) Per visualizzare l'anteprima dei risultati con l'aggiunta di un filtro specifico, inserisci una stringa di filtro. Utilizza la sintassi delle espressioni di filtro specificata nella documentazione di Filter.
(Facoltativo) Inserisci un'ora di esplorazione per visualizzare l'anteprima dei risultati che verranno mostrati nel momento specificato.

Ad esempio, se hai promosso determinati prodotti per il Black Friday, puoi vedere i risultati così come appariranno nel giorno in questione.
Inserisci la categoria di pagina per cui stai testando i risultati di navigazione.
(Facoltativo) Seleziona i facet da visualizzare insieme ai risultati e fai clic su OK per applicarli.

I facet selezionati vengono utilizzati per generare un elenco di filtri dei facet visualizzati in Aggiungi facet dopo aver eseguito la ricerca iniziale. Questi filtri dei facet possono includere facet diversi da quelli selezionati in questo passaggio, ad esempio facet dinamici.
Fai clic su Sfoglia anteprima o premi Invio in un campo di immissione per visualizzare i risultati.

I risultati vengono visualizzati con le relative immagini in miniatura disponibili.
(Facoltativo) Fai clic sull'icona Griglia o sull'icona Elenco per cambiare la modalità di visualizzazione dei risultati nell'anteprima.
(Facoltativo) Se hai selezionato i facet da visualizzare accanto ai risultati, seleziona uno o più valori dei facet dall'elenco per filtrare i risultati in base a questi valori. I risultati vengono aggiornati automaticamente al momento della selezione.

Quando selezioni più valori per lo stesso facet, questi vengono applicati come un operatore OR, mentre i valori nei diversi facet vengono applicati come un operatore AND. Ad esempio, dopo aver selezionato i facet "colore" e "materiale", potresti filtrare i risultati di ricerca selezionando i valori di colore "blu" e "oro" e i valori del materiale "cotone" e "poliestere". I risultati devono avere l'attributo "blu" o "oro" e anche "cotone" o "poliestere" come attributo.

Per visualizzare la pagina Dettagli relativa alla configurazione di pubblicazione di cui stai visualizzando l'anteprima, fai clic su Visualizza configurazione di pubblicazione nel campo Seleziona configurazione di pubblicazione.