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 consente di eseguire ricerche e navigare tramite query di testo funzionalità di ricerca.
Nel caso d'uso della ricerca tramite query di testo, un acquirente potrebbe inserire una query testuale nel tuo sito. La ricerca restituisce una risposta contenente prodotti che rientrano nei parametri dei controlli impostati, ordinati per pertinenza e la massimizzazione delle entrate.
Nel caso d'uso relativo alla navigazione, un acquirente potrebbe accedere al menu del sito e apri una categoria di prodotto specifica. Cerca automaticamente sceglie l'ordinamento che massimizza le entrate apprendendo dal comportamento degli utenti e tendenze. I risultati di navigazione possono essere perfezionati ulteriormente con i controlli impostati verso l'alto.
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, 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 eventi di ricerca di query di testo generati da
cerca come search
eventi utente. 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 AI per ottimizzare il modo in cui sfoglia i risultati vengono ordinati tenendo conto di popolarità, acquistabilità e personalizzazione.
Quando il metodo servingConfigs.search
invia una richiesta, cerca
la considera una richiesta di ricerca con consultazione se il campo query
è vuoto.
In questo caso, i risultati si basano sui valori filter
e
pageCategories
, oltre a ulteriori ottimizzazioni e personalizzazioni, se
disponibili.
Durante il caricamento dell'evento utente, assicurati di inviare eventi di ricerca di navigazione
generati dalla ricerca come search
eventi utente.
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ò comportare
impatto sulla qualità dei risultati. La ricerca di navigazione 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
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
le impostazioni e i controlli associati influiscono sui risultati di ricerca.
Le richieste di ricerca tramite query di testo richiedono un campo query
non vuoto.
Le richieste di ricerca basata sulla navigazione richiedono un campo pageCategories
non vuoto.
Java
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 dimensioni per cui puoi fornire un valore. Puoi anche includere attributi personalizzati
definiti 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 una guida passo passo per questa attività direttamente nel Editor di Cloud Shell, fai clic su 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 tramite i risultati di ricerca. Ad esempio, possono limitare il numero di elementi in la risposta alla ricerca utilizzando la funzionalità 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:
Impagina
Per passare da una pagina all'altra, utilizza page_token
o offset
, a seconda
al tuo caso d'uso.
Per passare alla pagina successiva, puoi usare 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
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
Ad esempio, se vuoi che venga visualizzata la decima pagina dei risultati quando la dimensione della pagina è 5,
puoi impostare offset
su 45, calcolato con la formula (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 della rete di ricerca
La rete di ricerca offre diversi livelli di rendimento della ricerca che migliorare i tuoi 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 livelli di prestazioni più elevati caricare dati di catalogo ed eventi utente che soddisfino i requisiti minimi di ogni 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'uso di questa pagina per visualizzare i livelli di qualità dei dati e di rendimento della ricerca, consulta Sbloccare la ricerca ai livelli di prestazioni.
Valutare la ricerca testuale e i risultati di navigazione
Prima di aggiornare il codice del tuo sito web per richiedere la ricerca testuale o la ricerca tramite navigazione puoi visualizzare l'anteprima per verificare che la configurazione di pubblicazione sia funzionando 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 ValutaFai clic sulla scheda Ricerca.
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 in questione.
(Facoltativo) Inserisci un'ora di ricerca per visualizzare l'anteprima dei risultati di ricerca 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.
(Facoltativo) Seleziona i facet da visualizzare accanto ai risultati di ricerca e fai clic su OK per applicarle.
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 I filtri dei facet possono includere facet diversi da quelli selezionati in questo passaggio, ad esempio i 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 della ricerca o premi Invio in un campo di immissione per visualizzare che consentono di analizzare i dati e 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 della griglia o sull'icona Elenco per cambiare la modalità i risultati di ricerca vengono visualizzati 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 operatoreAND
. 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 contenere il simbolo "blu" o "oro" come attributo e devono anche avere "cotone" o "poliestere" come .
Sfoglia
Vai alla pagina Valuta nella console di Search for Retail.
Vai alla pagina ValutaFai 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.
(Facoltativo) Inserisci un ID utente per visualizzare l'anteprima dei risultati per l'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 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 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 relative immagini in miniatura disponibili.
(Facoltativo) Fai clic sull'icona della griglia o sull'icona Elenco per cambiare la modalità i risultati vengono visualizzati 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 operatoreAND
. 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 includere "blu" o "oro" come e deve contenere anche "cotone" o "poliestere" come .
Per visualizzare la pagina Dettagli della configurazione di pubblicazione visualizzata in anteprima, fai clic su Visualizza la configurazione di pubblicazione nel campo Seleziona configurazione di pubblicazione.