La funzionalità Retail verrà rinominata in Vertex AI Search for Retail. Stiamo aggiornando i contenuti in base al nuovo branding.

Questa pagina è stata tradotta dall'API Cloud Translation.

Visualizza i risultati di ricerca

Questa pagina descrive le query di base con la ricerca, inclusi i testi eseguire query, sfogliare le ricerche, impaginazione, ottimizzazione risultati personalizzati.

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

Informazioni sulla ricerca testuale e la ricerca sfogliata con la ricerca

La ricerca offre sia funzionalità di ricerca di query di testo sia di ricerca di navigazione.

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

Nel caso d'uso di navigazione, un acquirente potrebbe andare al menu del tuo sito e accedere a una categoria di prodotti specifica. La Ricerca sceglie automaticamente l'ordinamento che massimizza le entrate in base alle tendenze e al comportamento degli utenti. I risultati di ricerca possono essere perfezionati ulteriormente in base ai controlli che hai configurato.

Sia le richieste di ricerca testuale che di ricerca tramite esplorazione utilizzano i campi Metodo servingConfigs.search.

Ricerche di query di testo

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

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

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

Sfoglia ricerche

In genere, sfogliare i prodotti utilizzando la navigazione sul sito produce risultati che sono tutti di pari pertinenza o ordinati in base agli articoli più venduti. La Ricerca sfrutta l'IA per ottimizzare l'ordinamento dei risultati di ricerca in base a popolarità, possibilità di acquisto e personalizzazione.

Quando il metodo servingConfigs.search invia una richiesta, la ricerca la considera una richiesta di ricerca di navigazione se il campo query è vuoto. In questo caso, i risultati si basano sui campi filter e pageCategories, nonché su un'ulteriore ottimizzazione e personalizzazione, se disponibile.

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

Per ottenere i risultati di ricerca corretti, pageCategories e filter nelle richieste di ricerca devono corrispondere esattamente ai valori pageCategories e filter valori negli eventi utente caricati. Se non corrispondono esattamente, i dati nelle richieste di ricerca potrebbero non essere riconosciuti, il che può provocare impatto sulla qualità dei risultati. La ricerca nella visualizzazione elenco riconosce solo il primo valore della categoria in pageCategories.

Cerca

Utilizza le richieste di ricerca per ottenere risultati sia per le ricerche di testo 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 controlli associati influiscono sui risultati di ricerca.

Le richieste di ricerca di query di testo richiedono un campo query non vuoto.

Le richieste di ricerca basata sulla navigazione 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 per pertinenza.

Per ottenere gli attributi del prodotto restituiti con la risposta di ricerca, assicurati di fornisci i valori degli attributi quando importi i dati del catalogo. Product ha attributi di sistema predefiniti come marca, colore e taglia per i quali puoi fornire valori. Puoi anche includere attributi personalizzati che definisci con Product.attributes.

Tutorial sulle query

Questo tutorial mostra come inviare una query di ricerca testuale a Servizio Vertex AI Search for Retail e analizza la risposta.

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

Procedura guidata

Impaginazione

Utilizza l'impaginazione per ridurre il tempo di ricerca e la dimensione 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 prodotti in un negozio, può migliorare la navigazione tra i risultati di ricerca. Ad esempio, possono limitare il numero di elementi in la risposta alla ricerca utilizzando la funzione delle dimensioni della pagina o passare al relativo pagina utilizzando la funzione di offset.

Per seguire una guida passo passo per questa attività direttamente nel Editor di Cloud Shell, fai clic su Procedura guidata:

Procedura guidata

Impagina

Per passare da una pagina all'altra, utilizza page_token o offset, in base al tuo caso d'uso.

Per passare alla pagina successiva, puoi utilizzare page_token. Ad esempio, supponiamo che invia i seguenti SearchRequest.

JSON

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

A partire da SearchResponse, puoi visualizzare i prodotti risultanti con i primi 5 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 con la successiva 5 pertinenza (dal 6° al 10°), dovresti imposta page_token utilizzando gli stessi valori di placement, visitor_id e query come next_page_token dal valore SearchResponse precedente.

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 alcuni altri casi, anziché navigare da una pagina all'altra o 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 la decima pagina dei risultati quando la dimensione di pagina è 5, puoi impostare offset su 45, che viene calcolato con (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
}

Livelli di rendimento nella Ricerca

La Ricerca offre diversi livelli di rendimento che migliorano progressivamente i risultati. Ad esempio, per i casi d'uso della ricerca di query di testo, potrebbe basarsi esclusivamente sulla pertinenza. Man mano che ottieni prestazioni più avanzate diversi livelli, la ricerca può restituire risultati basati sulla pertinenza, popolarità, ottimizzazione delle entrate e personalizzazione.

La rete di ricerca sblocca automaticamente i livelli di prestazioni più elevati quando carichi i dati del catalogo e degli eventi utente che soddisfano i requisiti minimi di ciascun livello.

La pagina Qualità dei dati su Search for Retail Console fornisce una valutazione i requisiti che hai soddisfatto per ogni livello. Per ulteriori informazioni sull'utilizzo di questa pagina per visualizzare la qualità dei dati e i livelli di rendimento nella ricerca, consulta Sbloccare i livelli di rendimento nella ricerca.

Valutare la ricerca di testo e i risultati di navigazione

Prima di aggiornare il codice del tuo sito web per richiedere la ricerca di testo o sfogliare i risultati di ricerca, puoi visualizzare un'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 oppure andando alla pagina Dettagli di una configurazione di pubblicazione nella console e facendo clic Scheda Valuta. I seguenti passaggi mostrano come visualizzare l'anteprima dal 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 attivarla, vai a 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 l'utente.
(Facoltativo) Inserisci un ID utente per visualizzare l'anteprima dei risultati di ricerca per l'utente.
(Facoltativo) Inserisci un'ora di ricerca per visualizzare l'anteprima dei risultati di ricerca che verrebbero visualizzati all'ora specificata.

Ad esempio, se promuovi determinati prodotti per il Black Friday, possono vedere i risultati così come apparirebbero quel giorno.
(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 che vengono visualizzati in Aggiungi facet dopo aver eseguito la ricerca iniziale. Questi filtri delle sfaccettature possono includere sfaccettature diverse da quelle selezionate in questo passaggio, ad esempio le sfaccettature dinamiche.
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 l'URI di reindirizzamento.
(Facoltativo) Fai clic sull'icona Griglia o sull'icona Elenco per modificare la modalità di visualizzazione dei risultati di ricerca nell'anteprima.
(Facoltativo) Se hai selezionato facet da visualizzare accanto ai risultati, seleziona Uno o più valori dei facet dall'elenco dei facet per filtrare i risultati in base a tali e i relativi valori. I risultati vengono aggiornati automaticamente al momento della selezione.

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

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 quell'utente.
(Facoltativo) Inserisci un ID utente per visualizzare l'anteprima dei risultati per quell'utente.
Per visualizzare l'anteprima dell'aspetto dei risultati con l'aggiunta di un filtro specifico: inserisci una stringa di filtro. Utilizza la sintassi delle espressioni di filtro specificata nel Filtra la documentazione.
(Facoltativo) Inserisci un'ora di navigazione per visualizzare l'anteprima dei risultati che verrebbero visualizzati. all'orario specificato.

Ad esempio, se promuovi determinati prodotti per il Black Friday, possono vedere i risultati così come apparirebbero quel giorno.
Inserisci la categoria di pagina per cui stai testando i risultati della navigazione.
(Facoltativo) Seleziona i facet da visualizzare accanto ai risultati e fai clic su OK per applicarle.

I parametri selezionati vengono utilizzati per generare un elenco di filtri per parametri che viene visualizzato in Aggiungi parametri dopo l'esecuzione della ricerca iniziale. Questi I filtri dei facet possono includere facet diversi da quelli selezionati in questo passaggio, ad esempio i facet dinamici.
Fai clic su Sfoglia anteprima o premi Invio in un campo di immissione per visualizzare che consentono di analizzare i dati e visualizzare i risultati.

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

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

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