Migliorare i risultati

AI Commerce Search offre una funzionalità che ti consente di specificare i record da mettere in evidenza nelle ricerche. Puoi controllare la classificazione dei risultati applicando una regola di boost per dare la priorità o ridurre la priorità degli elementi di ricerca restituiti.

Il boost ti consente di controllare la classificazione dei risultati promuovendo (boost) o declassando (bury) elementi specifici in base ai criteri che definisci. A differenza del filtraggio, che rimuove gli elementi dal set di risultati, il boost regola la posizione degli elementi già idonei per essere restituiti.

Override di boost e filtri

Nota: le regole di filtraggio hanno sempre la precedenza sulle regole di boost. Per saperne di più sul filtraggio e sull'ordinamento dei risultati di ricerca, consulta Filtrare e ordinare i risultati.

Di seguito sono riportati alcuni esempi di tipi di filtri comuni che hanno la precedenza sulle regole di boost:

1. Specificati dall'utente. Possono essere elementi come prezzo o brand. Vengono visualizzati all'utente finale come riquadri o facet sul sito web.

• Pertinenza (rilevanza). Questi filtri esistono solo per le query di ricerca (non per la navigazione). Escludono i prodotti meno pertinenti dai risultati di ricerca. Ad esempio, la ricerca frigorifero non restituisce microonde o accessori, come le maniglie del frigorifero. Il filtro riconosce di non aumentare la priorità di un microonde per una ricerca di frigoriferi.

Regole di boost

Le regole di boost possono essere applicate solo quando è presente un punteggio di pertinenza di base, ad esempio nelle ricerche ordinate per pertinenza o nei risultati di navigazione con punteggi di pre-ordinamento. Il boost è una funzione di moltiplicazione applicata ai risultati di ricerca e navigazione. La sintassi e la logica del boost possono essere suddivise in:

• Disponibilità. Il boost non può sostituire le regole di disponibilità. Se un elemento viene filtrato (ad esempio, non è disponibile), il boost non lo farà apparire.

• Operatori. Puoi utilizzare operazioni come maggiore di e minore di per i campi numerici nelle condizioni di boost, che non sono disponibili nel filtraggio rigoroso standard.

Valori di boost o bury

Un prodotto può essere condizionato da più regole di boost o bury, impostate nella boostSpec classe dell'API Search. Un valore di boost è un numero in rappresentazione in virgola mobile compreso tra -1.0 e 1.0.

• Valore positivo (da 0.0 a 1.0): promuove l'elemento, spostandolo più in alto nei risultati. Un valore pari a 1.0 offre la promozione massima.

• Valore negativo (da -1.0 a 0.0): declassa (bury) l'elemento, spostandolo più in basso nei risultati. Un valore pari a -1.0 offre la declassazione massima.

Più regole di boost o bury su un singolo prodotto

Più regole di boost o bury possono influire su un prodotto, con una somma o un valore massimo dei valori di boost che determina il punteggio finale. Quando vengono applicate più regole di boost allo stesso prodotto, controlla sempre se il punteggio di un altro prodotto ha superato quello del prodotto in questione. La modalità massima è impostata come predefinita in modo che questo problema sia meno probabile.

Supponiamo che un prodotto riceva boost di 2, 3 e 0.5 e un altro prodotto riceva un boost di 0.5. Sebbene il prodotto abbia ricevuto solo un punteggio di boost di 0.5, quando viene aumentato ripetutamente, supera l'altro prodotto. Controlla attentamente la specifica di boost per assicurarti che non si sovrapponga o che lo faccia come previsto.

Risoluzione dei conflitti

Se più regole di boost si applicano allo stesso prodotto, puoi definire come interagiscono.

• Regola di boost massima (impostazione predefinita) : AI Commerce Search controlla il valore massimo e ignora le altre regole.

• Somma dell'effetto di boost (impostazione alternativa): se è presente una declassazione più una promozione, AI Commerce Search somma i valori di tutte le regole di boost e bury applicabili. Ciò consente un effetto cumulativo. La somma risultante è un effetto di boost ridotto o di bury netto.

Configurare il boost

Per configurare un set di dati con regole di boost o bury, definisci le condizioni in base agli attributi del prodotto (ad esempio brand o prezzo) e assegna un valore di boost compreso tra -1.0 (bury) e 1.0 (boost) per regolare il punteggio di classificazione degli elementi corrispondenti. I seguenti prodotti sono disponibili per la configurazione dei controlli di boost o bury:

• Ricerca: filtro di pertinenza più eventuali altri filtri applicati dall'utente, ad esempio i facet on-site. Scopri di più su come configurare il boost per la ricerca.

• Navigazione: poiché non esiste una query di testo, vengono applicati solo i filtri applicati dall'utente. Vengono applicati anche i filtri per verificare che il prodotto (ad esempio, le tute) appartenga alla categoria di prodotto corretta (non ai maglioni, ad esempio). Scopri di più su come configurare il boost per i consigli.

Set di dati di esempio

Visualizza il set di dati di esempio dei prodotti

id	titolo	brand	categorie	price_info.price
"nest_mini_2nd_gen"	Nest Mini (2ª generazione.)	["Google", "Nest"]	["Nest > speakers and displays"]	49 ₪
"nest_audio"	"Nest Audio"	["Google", "Nest"]	["Nest > speakers and displays"]	99,99
"nest_hub_max"	"Nest Hub Max"	["Google", "Nest"]	["Nest > speakers and displays"]	229 ₪
"nest_hub"	"Nest Hub"	["Google", "Nest"]	["Nest > speakers and displays"]	88,99
"google_home_max"	"Google Home Max"	["Google", "Nest"]	["Nest > speakers and displays"]	299 ₪
"google_home_mini"	"Google Home Mini"	["Google", "Nest"]	["Nest > speakers and displays"]	49 ₪
"google_pixel_5"	"Google Pixel 5"	["Google", "Pixel"]	["Pixel > phones"]	699 ₪
"google_pixel_4a_with_5g"	Google Pixel 4a con 5G	["Google", "Pixel"]	["Pixel > phones"]	499 ₪
"google_pixel_4a"	"Google Pixel 4a Phones"	["Google", "Pixel"]	["Pixel > phones"]	349 ₪
"google_pixel_stand"	"Google Pixel Stand"	["Google", "Pixel"]	["Pixel > featured accessories"]	79 ₪
"google_pixel_buds"	"Google Pixel Buds"	["Google", "Pixel"]	["Pixel > featured accessories"]	179 ₪
"google_pixel_5_case"	custodia per Google Pixel 5	["Google", "Pixel"]	["Pixel > featured accessories"]	40 ₪
"google_pixel_4a_5g_case"	"Google Pixel 4a (5G) Case"	["Google", "Pixel"]	["Pixel > featured accessories"]	40 ₪
"google_pixel_4a_case"	custodia per Google Pixel 4a	["Google", "Pixel"]	["Pixel > featured accessories"]	40 ₪

Opzioni di configurazione

In AI Commerce Search, il boost viene applicato come moltiplicatore al punteggio di pertinenza di base generato dall'algoritmo di ricerca. Puoi configurare le regole di boost direttamente in una richiesta di ricerca utilizzando una specifica di boost o collegando i controlli di pubblicazione a una configurazione di pubblicazione. Nella risposta, gli elementi che soddisfano queste condizioni ricevono un punteggio di pertinenza modificato, che li fa apparire più in alto o più in basso nell'elenco dei risultati senza essere rimossi completamente. Per configurare un controllo di boost o bury della ricerca:

console Cloud

1. Vai alla pagina Controlli nella console AI Commerce Search in Gemini Enterprise for Customer Experience.
   
   Vai alla pagina Controlli

2. Nella scheda Controlli di pubblicazione, fai clic su Modifica a destra di un controllo.

3. Nel riquadro a comparsa Modifica controllo, fai clic sul campo sotto il campo Nome controllo per modificare il nome del controllo.

4. (Facoltativo) Per la ricerca, nella sezione Attivatori, seleziona il tipo di comportamento dell'utente che attiva questo controllo. Le sezioni Sfoglia categorie e Ricerca sono disattivate.

5. (Facoltativo) Modifica Termini di ricerca corrispondenti.

   Nota: se specifichi una condizione di categoria o termine di query più condizioni di intervallo di tempo, il controllo viene applicato solo quando sono soddisfatte entrambe le condizioni.

6. (Facoltativo) Fai clic sull'opzione Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.

   Nota: se specifichi le condizioni dell'intervallo di tempo oltre a questo tipo di condizione, il controllo viene applicato solo se sono soddisfatte entrambe le condizioni.

7. Fai clic su Continua per passare alla sezione Azioni.

8. Aggiungi filtri per gli attributi del prodotto nel campo Boost/bury prodotto.

   Utilizza la sintassi delle espressioni di filtro documentata in Filtrare e ordinare i risultati. Ad esempio, per specificare le versioni rosse e blu di "product1" e "product2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

9. In Valore di boost/bury, utilizza il cursore per impostare la forza del boost. I valori positivi aumentano la priorità dei risultati, mentre i valori negativi la riducono. Fai clic su Continua.

10. Nella sezione Configurazioni di pubblicazione, seleziona le configurazioni di pubblicazione a cui applicare il controllo.

11. Invia le impostazioni di controllo.

Ora puoi trovare la regola di controllo di boost o bury aggiunta come nuovo Tipo di controllo elencato in Controlli di pubblicazione per il tuo progetto. Scopri come creare un nuovo controllo di boost e bury in Creare controlli.

JSON

Di seguito è riportato un esempio di boost per prezzo.

Supponiamo che tu voglia dare la priorità ai prodotti più economici (meno di 95$) e ridurre la priorità di quelli costosi (più di 95$). Puoi applicare una specifica di boost.

{
  "condition_boost_specs": [
    {
      "condition": "price: IN(*, 95.0e)",
      "boost": 0.5
    },
    {
      "condition": "price: IN(95.0e, *)",
      "boost": -0.5
    }
  ]
}

In questo esempio, i prodotti con un prezzo inferiore a 95 $ ricevono una promozione (0.5), mentre quelli con un prezzo superiore a 95 $ vengono declassati (-0.5).

Nel risultato, "nest_mini_2nd_gen", "google_home_mini" e "nest_hub" potrebbero essere i primi tre, mentre "nest_audio", "nest_hub_max" e "google_home_max" potrebbero essere gli ultimi tre. Tuttavia, non è predeterminato alcun ordine specifico, a differenza dell' ordinamento per prezzo, come descritto in Filtrare e ordinare i risultati.

Boost nella ricerca

Per la ricerca, applica dinamicamente il punteggio di classificazione degli elementi corrispondenti includendo una specifica di boost (boostSpec) con condition_boost_specs direttamente in SearchRequest.

Condizioni e attivatori

Il boost della ricerca può essere condizionale. Puoi attivare una regola di boost in base a queste condizioni:

• Termini di query: applica il boost solo quando l'utente cerca termini specifici (ad esempio, aumenta la priorità dei cappotti invernali quando la query contiene giacca).

• Intervalli di tempo: applica il boost solo durante un periodo promozionale specifico.

• Globale: applica il boost a tutte le query pubblicate da una configurazione specifica.

Esempio di richiesta e risposta di ricerca

Nel set di dati di esempio mostrato in precedenza, se cerchi "Google speaker", otterrai "nest_mini_2nd_gen", "nest_audio", "nest_hub_max", "nest_hub", "google_home_max" e "google_home_mini" senza un ordine specifico.

Visualizza l'esempio di richiesta e risposta di ricerca

Java

import com.google.cloud.retail.v2.SearchRequest;
import com.google.cloud.retail.v2.SearchRequest.BoostSpec;
import com.google.cloud.retail.v2.SearchRequest.BoostSpec.ConditionBoostSpec;
import com.google.cloud.retail.v2.SearchResponse;
import com.google.cloud.retail.v2.SearchServiceClient;

public static void searchProductsWithBoostSpec(String query, int pageSize,
    String condition, float boostStrength) throws IOException, InterruptedException {
  BoostSpec boostSpec = BoostSpec.newBuilder()
      .addConditionBoostSpecs(ConditionBoostSpec.newBuilder()
          .setCondition(condition)
          .setBoost(boostStrength)
          .build())
      .build();

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

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

Boost nei consigli

Il boost per i consigli viene gestito utilizzando i controlli di pubblicazione. A differenza della ricerca, il boost dei consigli non supporta le condizioni basate su query (poiché non esiste una query utente). Il controllo viene invece applicato a tutte le previsioni generate dalla configurazione di pubblicazione a cui è collegato. Per questo motivo, in genere configuri i consigli collegando i controlli di pubblicazione di boost o bury alla configurazione di pubblicazione, anziché passare una specifica di boost nella richiesta.

Campi supportati per i consigli

Quando definisci i prodotti di cui aumentare la priorità nei consigli, utilizza un'espressione di filtro. Mentre il filtraggio standard dei consigli è limitato ai campi di testo, il boost supporta campi numerici aggiuntivi.

Tipo di campo	Campi supportati	Descrizione
Testuale	productId, brands, categories, genders, ageGroups, colorFamilies, colors, sizes, title,materials, patterns, conditions, attributes.key, tags	Campi standard disponibili sia per il filtraggio sia per il boost. Tieni presente che tags sono tag personalizzati associati al prodotto.
Numerico	price, discount, rating, ratingCount	Esclusivo per boost/bury. Questi campi ti consentono di aumentare la priorità dei prodotti in base al prezzo, agli sconti o alle valutazioni degli utenti.

Per saperne di più, consulta la sezione Campi supportati per boost/bury in Filtrare i consigli.

Aumentare la priorità dei prodotti con valutazioni alte

Supponiamo che tu voglia assicurarti che i film con valutazioni alte vengano visualizzati più in alto nel riquadro dei consigli "Altri film che potrebbero piacerti". Per questo caso d'uso, crea un controllo di pubblicazione per aumentare la priorità degli elementi con un conteggio delle valutazioni superiore a 100. Configura i controlli tenendo conto di quanto segue:

• Tipo di controllo: boost o bury

• Selezione prodotto: consiglio

• Azione:

  • Espressione di filtro: ratingCount > 100

  • Valore di boost: 0.5

Questo controllo garantisce che gli elementi più apprezzati e con valutazioni alte abbiano la priorità nell'elenco dei consigli, mantenendo al contempo la pertinenza della personalizzazione per l'utente.

Debug e risoluzione dei problemi

Ogni prodotto è idoneo per un boost illimitato, ma i filtri applicati dall'utente eliminano i prodotti dalla risposta di ricerca. Per risolvere il problema per cui un prodotto con boost potrebbe non essere visualizzato nei risultati di ricerca e navigazione, controlla quanto segue:

• Più regole di boost (incluse le declassazioni di bury): controlla la configurazione della modalità di boost (somma o max) e determina il punteggio finale.
• Pertinenza: un prodotto deve essere pertinente per la query e superare i filtri di pertinenza. Se una query di ricerca riguarda le scarpe Nike e il titolo del prodotto è Air Jordans,le parole non corrispondono, ma la loro stretta relazione semantica genera un punteggio di pertinenza elevato. Un titolo di prodotto come giacca gialla ha un punteggio di pertinenza basso con una query di ricerca Nike. Allo stesso modo, se il titolo del prodotto è un numero di modello criptico che non ha alcuna relazione con nessuna parola, il punteggio di pertinenza sarà basso per qualsiasi query.
• Filtri: le regole di filtraggio sostituiscono qualsiasi regola di boost e impediscono la visualizzazione dei prodotti con boost nei risultati. Il filtro viene sempre applicato sopra il boost. Se un prodotto ha filtri applicati dall'utente o se una categoria di prodotti filtra per la navigazione, il boost non funzionerà.

Tutorial sul boost

In questo tutorial, vedrai alcuni esempi di boost dei prodotti.

---

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

Procedura guidata

---