Espansione della query

L'espansione della query è l'allentamento incrementale dei vincoli della query per includere più risultati quando inizialmente non vengono trovati risultati o ne vengono trovati troppo pochi. Ciò comporta una regolazione della dimensione dei risultati per query.

Quando non sono presenti documenti pertinenti per una query, l'espansione della query restituisce documenti meno pertinenti per assicurarsi di non restituire zero risultati di ricerca.

A differenza, ad esempio, del faceting dinamico o dei controlli di pubblicazione , l'espansione della query non può essere configurata direttamente nella console Google Cloud . Dovrai invece configurare l'espansione della query a livello di programmazione per ogni richiesta di ricerca. Continua a leggere per scoprire come configurare l'espansione della query nell'API.

Tutorial sull'espansione della query

Questo tutorial mostra come attivare la funzionalità di espansione della query. Quando un acquirente utilizza una frase di ricerca ambigua o composta da più parole, può ricevere una risposta vuota. Dopo aver attivato l'espansione della query, la richiesta viene analizzata e viene restituito l'elenco espanso di prodotti in base alla query di ricerca analizzata.

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

Procedura guidata

Panoramica dell'espansione della query

L'espansione della query è una funzionalità potente progettata per migliorare il richiamo della ricerca ed evitare scenari con zero risultati, in particolare per le query degli utenti long-tail o complesse.

Anziché non restituire risultati quando non viene trovata una corrispondenza esatta nel catalogo prodotti, l'espansione della query identifica e visualizza prodotti correlati o alternativi. Ciò migliora l'esperienza utente e può aumentare i tassi di conversione.

I casi d'uso principali per l'espansione della query sono:

Query long-tail: per ricerche molto specifiche, ad esempio latte biologico ad alto contenuto proteico e a basso contenuto di grassi per diabetici,il catalogo potrebbe non avere una corrispondenza perfetta. L'espansione della query può restituire prodotti che corrispondono a parti dell'intenzione, ad esempio prodotti taggati con attributi o valori di attributi di latte per diabetici, latte ad alto contenuto proteico.
Prodotti alternativi: se gli utenti cercano un brand o un prodotto non presente nel catalogo, ad esempio caffè Starbucks 100 ml, l'espansione della query può suggerire brand di caffè alternativi disponibili per l'acquisto, evitando una ricerca senza risultati.

Le sezioni successive descrivono la funzionalità, il meccanismo di attivazione e le sfumature di configurazione della funzionalità di espansione della query in AI Commerce Search, con un'attenzione particolare al ruolo fondamentale del filtro canonico.

Meccanismo di attivazione dell'espansione della query

La decisione di attivare l'espansione della query o una determinata query di ricerca è automatizzata e si basa su una regola di filtro canonico configurabile rapidamente.

Condizione di attivazione: l'espansione della query viene attivata solo se la ricerca iniziale con la query del filtro canonico restituisce meno di tre risultati di prodotto.
Soglia: questa soglia di tre per impostazione predefinita può essere modificata. Funziona bene per la maggior parte dei casi d'uso di e-commerce, assicurando che l'espansione della query venga attivata solo se e quando il set di risultati iniziale è effettivamente scarso.

Configurare l'espansione della query nell'API

L'espansione della query viene configurata a livello di programmazione per richiesta utilizzando l'API come segue:

Configurazione API: puoi controllare l'espansione della query includendo l'oggetto queryExpansionSpec in SearchRequest.
Impostazioni: in queryExpansionSpec, imposta il campo condition su AUTO per attivare la funzionalità o su DISABLED per disattivarla, che è l'impostazione predefinita se non specificata.
Blocco: puoi facoltativamente impostare pinUnexpandedResults su true nella richiesta per assicurarti che le corrispondenze esatte per la query originale vengano visualizzate nella parte superiore dei risultati di ricerca, seguite dai risultati espansi. Per ulteriori informazioni, consulta la pagina relativa al blocco.

Configurare i filtri canonici

Affinché l'espansione della query venga attivata in modo efficace, devi configurare correttamente canonical_filter nella richiesta di ricerca.

Per implementare correttamente l'espansione della query, è fondamentale comprendere i due parametri di filtro principali in una richiesta di ricerca: i filtri di primo livello e i filtri canonici.

Filtro di primo livello (filter): questo è il filtro principale applicato ai risultati di ricerca prima che vengano restituiti all'utente. È una combinazione di due potenziali livelli:
- Filtro aziendale/di base: regole predefinite applicate a tutte le ricerche, spesso senza input diretto dell'utente, ad esempio inStock=TRUE, category="groceries", storeId="XYZ".
- Filtri per facet selezionati dall'utente: filtri applicati dinamicamente dall'utente durante l'interazione con l'interfaccia di ricerca, ad esempio selezionando i filtri per facet per brand="Adidas", size="L".
Filtri canonici (canonical_filter): si tratta di un filtro speciale utilizzato esclusivamente dal modulo decisionale di espansione della query. Il suo unico compito è definire la visualizzazione del catalogo rispetto alla quale viene valutata la condizione di attivazione dell'espansione della query (meno di cinque risultati).

**Importante** :il filtro canonico non filtra i risultati di ricerca finali restituiti all'utente. Questo è invece il compito del filtro principale.

Funzioni principali del filtro canonico

Il filtro canonico è progettato per distinguere tra un risultato di ricerca organico di scarsa qualità e un set di risultati intenzionalmente ristretto dall'utente. Può essere ampio per escludere la logica di business per tenere conto dei filtri applicati dall'utente o ristretto per attivare l'espansione della query quando necessario, a seconda dello scenario dell'utente.

Scenario 1

Percorso dell'utente: l'utente cerca t-shirt e ottiene migliaia di risultati. Esiste un business_filter predefinito, in modo che, ad esempio, filtri solo i prodotti disponibili e i prodotti che corrispondono a un attributo personalizzato a livello di negozio. L'utente applica quindi i filtri per facet per brand="Adidas" e size="L", che riducono il numero di risultati a due.
Se canonical_filter fosse impostato in modo da includere le stesse condizioni di filter (ad esempio AVAILABILITY: IN_STOCK AND color: "Red": il sistema decisionale di espansione della query vedrebbe solo due risultati e attiverebbe in modo errato l'espansione della query, inondando l'utente di prodotti correlati ma non pertinenti, ad esempio t-shirt Nike, interrompendo il filtro esplicito dell'utente.
L'impostazione corretta è canonical_filter = business filter. La decisione di espandere la query deve essere presa in base alla query iniziale, escludendo i facet selezionati dall'utente. Mantenendo ampio il canonical_filter, il sistema identifica correttamente che nel catalogo sono presenti molti prodotti corrispondenti, consentendogli di rispettare i filtri rigorosi dell'utente senza forzare un'espansione.

Scenario 2

Percorso dell'utente: l'utente cerca t-shirt Adidas con stampe grafiche nere e ottiene solo uno o due risultati, se presenti. Esiste un business_filter predefinito, in modo che, ad esempio, filtri solo i prodotti disponibili e i prodotti che corrispondono a un attributo personalizzato a livello di negozio.
Se canonical_filter non è impostato o non è configurato correttamente, la ricerca con il filtro canonico potrebbe trovare prodotti che corrispondono alla query ma non sono disponibili o provengono da un altro negozio, il che significa un valore diverso dell'attributo personalizzato a livello di negozio. In questo caso, l'espansione della query non viene attivata.
L'impostazione corretta è canonical_filter = business filter. Con questa impostazione, la decisione di espansione della query trova meno di tre prodotti per la query lunga specificata, quindi attiva un'espansione della query e porta i prodotti correlati alla query originale, ovvero i prodotti disponibili che corrispondono all'attributo a livello di negozio. In questo modo, i risultati di ricerca vengono espansi per includere t-shirt con stampe grafiche nere stampate di un altro brand, t-shirt con stampe grafiche di altri colori stampate o altri prodotti t-shirt del brand della query. Includi i vincoli aziendali per questo caso d'uso di canonical_filter.

Best practice per l'espansione della query

Il filtro canonico deve quasi sempre essere impostato in modo che sia identico al filtro aziendale o di base. In questo modo, il modulo di espansione della query valuta il potenziale della query rispetto alla stessa visualizzazione ampia del catalogo che gli utenti vedono inizialmente prima di iniziare ad applicare i facet.

Flusso di processo di ricerca end-to-end ed espansione della query

Quando viene effettuata una richiesta di ricerca, si verificano diversi processi paralleli:

Richiesta ricevuta: l'API riceve la richiesta di ricerca contenente la query, il filter principale e il canonical_filter.
Ricerca decisionale di espansione della query: in parallelo, il modulo decisionale di espansione della query esegue la propria ricerca interna utilizzando la query combinata con il filtro canonico.
Controllo del numero di risultati: il modulo controlla il numero di prodotti restituiti dalla ricerca interna.
- Se i risultati sono cinque o più: l'espansione della query non viene attivata. I risultati di ricerca standard passano al passaggio di filtro finale.
- Se i risultati sono meno di cinque: l'espansione della query viene attivata. Il modello allenta sistematicamente la query per trovare prodotti correlati. Ad esempio, il modello potrebbe trovare per smartphone Pixel 5, smartphone Pixel 4, auricolari Pixel o persino smartphone Samsung.

Filtro finale: il set di prodotti (il set originale o il set espanso dall'espansione della query) viene passato alla fase finale. In questo caso, il filtro di primo livello, contenente le regole di business e tutti i facet selezionati dall'utente, viene applicato rigorosamente.

Risposta inviata: l'elenco filtrato finale dei prodotti viene restituito nella risposta dell'API.

Caso d'uso avanzato dell'attivazione selettiva dell'espansione della query

Puoi configurare strategicamente i filtri per attivare o disattivare l'espansione della query per parti specifiche del catalogo.

Considera lo scenario di un catalogo di grandi dimensioni contenente generi alimentari, elettronica e abbigliamento alla moda. In questo scenario, devi tenere presente i seguenti aspetti.

Obiettivo

Attiva l'espansione della query per le query relative a generi alimentari difficili da trovare o scarsi, ma mostra zero risultati per gli articoli di elettronica o di moda. L'esigenza aziendale è di attivare l'espansione della query solo in modo selettivo per la parte relativa ai generi alimentari.

Configurazione

Per questo scenario di caso d'uso, l'espansione selettiva della query può essere configurata come segue:

canonical_filter: impostalo su ampio. Deve includere tutte le categorie: generi alimentari, elettronica e moda, oltre a tutte le regole di base come la disponibilità di stock, definendo il filtro canonico con category="groceries" OR category="electronics" OR category="fashion") AND inStock=TRUE)
filter: impostalo su ristretto, in base al contesto dell'utente. Per un utente nella sezione dei generi alimentari, il filtro sarebbe category="groceries" AND inStock=TRUE.

Come funziona

In questo scenario, l'espansione selettiva della query funziona come segue:

L'utente cerca "iPhone 20": il modulo di espansione della query utilizza il `canonical_filter` ampio, trova i modelli di iPhone esistenti (< 5 risultati) e decide di non attivare l'espansione della query. I risultati di ricerca standard (iPhone esistenti) vengono quindi passati al filtro principale, che li blocca perché category="electronics" non corrisponde a category="groceries". L'utente vede correttamente zero risultati.
L'utente cerca *latte per diabetici ad alto contenuto proteico:* il modulo di espansione della query utilizza il canonical_filter ampio e trova < 5 risultati, attivando così l'espansione della query trovando prodotti a base di latte correlati. Questi prodotti vengono passati al filtro principale. Poiché corrispondono a category="groceries", questi prodotti vengono restituiti correttamente all'utente.

Manipolando l'ambito di canonical_filter (la visualizzazione decisionale) e il filter principale (la visualizzazione dell'output finale), ottieni un controllo preciso sull'esperienza di ricerca.

Set di dati di esempio

Questa pagina utilizza il seguente set di dati come esempio. Espandilo per visualizzare i campi all'interno del set di dati di esempio della descrizione del prodotto.

Set di dati di esempio del prodotto

ID	titolo	brand	categorie	price_info.price
"nest_mini_2nd_gen"	"Nest Mini (2ª generazione)"	["Google", "Nest"]	["Nest > speaker e display"]	49 ₪
"nest_audio"	"Nest Audio"	["Google", "Nest"]	["Nest > speaker e display"]	99,99
"nest_hub_max"	"Nest Hub Max"	["Google", "Nest"]	["Nest > speaker e display"]	229 ₪
"nest_hub"	"Nest Hub"	["Google", "Nest"]	["Nest > speaker e display"]	88,99
"google_home_max"	"Google Home Max"	["Google", "Nest"]	["Nest > speaker e display"]	299 ₪
"google_home_mini"	"Google Home Mini"	["Google", "Nest"]	["Nest > speaker e display"]	49 ₪
"google_pixel_5"	"Google Pixel 5"	["Google", "Pixel"]	["Pixel > smartphone"]	699 ₪
"google_pixel_4a_with_5g"	"Google Pixel 4a con 5G"	["Google", "Pixel"]	["Pixel > smartphone"]	499 ₪
"google_pixel_4a"	"Smartphone Google Pixel 4a"	["Google", "Pixel"]	["Pixel > smartphone"]	349 ₪
"google_pixel_stand"	"Google Pixel Stand"	["Google", "Pixel"]	["Pixel > accessori in primo piano"]	79 ₪
"google_pixel_buds"	"Google Pixel Buds"	["Google", "Pixel"]	["Pixel > accessori in primo piano"]	179 ₪
"google_pixel_5_case"	"Custodia per Google Pixel 5"	["Google", "Pixel"]	["Pixel > accessori in primo piano"]	40 ₪
"google_pixel_4a_5g_case"	"Custodia per Google Pixel 4a (5G)"	["Google", "Pixel"]	["Pixel > accessori in primo piano"]	40 ₪
"google_pixel_4a_case"	"Custodia per Google Pixel 4a"	["Google", "Pixel"]	["Pixel > accessori in primo piano"]	40 ₪

L'espansione della query amplia le query di ricerca per ottenere più risultati

L'espansione della query aumenta il richiamo per i termini di query con pochi risultati, in particolare le query long-tail. La query ampliata produce una dimensione dei risultati di ricerca maggiore.

Questa funzionalità dei risultati di ricerca è basata su una specifica che determina le condizioni di espansione della query. Include un'opzione pinUnexpandedResults disattivata per impostazione predefinita. Se impostata su true, visualizza i prodotti non espansi nella parte superiore dei risultati di ricerca. La parte superiore è seguita dai risultati espansi.

Java

import com.google.cloud.retail.v2.SearchRequest;
import com.google.cloud.retail.v2.SearchRequest.QueryExpansionSpec;
import com.google.cloud.retail.v2.SearchRequest.QueryExpansionSpec.Condition;
import com.google.cloud.retail.v2.SearchResponse;
import com.google.cloud.retail.v2.SearchServiceClient;

public static void searchProductsWithQueryExpansion(String query, int pageSize,
    Condition condition) throws IOException, InterruptedException {
  QueryExpansionSpec queryExpansionSpec = QueryExpansionSpec.newBuilder()
      .setCondition(condition)
      .build();

  SearchRequest searchRequest = SearchRequest.newBuilder()
      .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
      .setBranch(DEFAULT_BRANCH_NAME)
      .setVisitorId(VISITOR_ID)
      .setQuery(query)
      .setPageSize(pageSize)
      .setQueryExpansionSpec(queryExpansionSpec)
      .build();

  try (SearchServiceClient searchClient = SearchServiceClient.create()) {
    SearchResponse response = searchClient.search(searchRequest).getPage().getResponse();
    System.out.println("Search response: " + searchResponse);
  }
}

Ad esempio, se cerchi Google Pixel 5 senza espansione della query, il risultato è limitato agli ID google_pixel_5. Tuttavia, con l'espansione della query , potresti ottenere anche gli ID google_pixel_4a_with_5g, google_pixel_4a e google_pixel_5_case nel set di dati di esempio della descrizione del prodotto.