Sblocca i livelli di prestazioni della ricerca

Questa pagina descrive i casi d'uso di ricerca, i rispettivi livelli di rendimento e come controllare la console Ricerca per la vendita al dettaglio per una valutazione della qualità dei dati e dei livelli di rendimento che hai sbloccato. Ogni livello di prestazioni viene attivato automaticamente quando soddisfi tutti i requisiti relativi ai dati che bloccano l'upgrade. Per eseguire l'upgrade al livello successivo, devi inoltre soddisfare i requisiti di tutti i livelli precedenti.

Cerca casi d'uso

La Ricerca fornisce risultati di ricerca per due casi d'uso:

• Ricerca tramite query di testo, utilizzata quando gli acquirenti cercano articoli nella tua applicazione inserendo query di testo e ottenendo un insieme di risultati pertinenti.
• Ricerca di navigazione, utilizzata quando gli acquirenti arrivano su una pagina di una determinata categoria, ad esempio la pagina web della categoria "Elettrodomestici" del sito di vendita al dettaglio di un negozio di bricolage, e sfogliano gli articoli ordinati in quella categoria.

Per saperne di più sulle differenze tra questi casi d'uso, consulta Informazioni sulla ricerca testuale e ricerca con navigazione.

Livelli di prestazioni

La ricerca tramite query di testo e la ricerca di navigazione hanno diversi livelli di rendimento che migliorano sempre di più i risultati di ricerca. Per sbloccare i livelli di rendimento è necessario caricare i dati del catalogo e sugli eventi utente in Vertex AI Search per il retail.

I seguenti livelli di prestazioni sono disponibili per entrambi i casi d'uso, la ricerca tramite query di testo e la navigazione:

Ricerca di query di testo

LIVELLO 1

Pertinenza:

• I risultati vengono restituiti in base al grado di pertinenza della query, ad esempio come si verifica un abito nero quando viene eseguita una query su un abito nero.

Requisiti minimi per i dati:

• Catalogo
• Query

LIVELLO 2

Pertinenza e popolarità:

• Perfeziona il LIVELLO 1 in base agli elementi più popolari nella ricerca sottoposta a query.
• I prodotti ugualmente pertinenti vengono classificati in base alla popolarità del prodotto sul tuo sito.

Requisiti minimi dei dati: dati sui clic

LIVELLO 3

Ranking ottimizzato per le entrate: i risultati pertinenti vengono classificati in base alla probabilità che il prodotto venga acquistato in base a una specifica attività a livello di sito.

Requisiti minimi dei dati: un volume elevato di eventi utente.

LIVELLO 4

Ranking personalizzato ottimizzato per le entrate:

• I risultati pertinenti vengono ordinati in base alle preferenze del singolo utente e alla probabilità che il prodotto venga acquistato in base all'attività in tutto il sito di questo utente.
• Prodotti classificati in base alla "qualità della corrispondenza" all'utente unico che effettua una ricerca o naviga nel sito.

Requisiti minimi per i dati:

• Un volume elevato di eventi utente.
• visitorID e/o userId corrispondenti, formattati in modo coerente per tutti gli eventi utente.

Sfoglia

BRONZO

Risultati casuali

• Qualsiasi risultato di ricerca che corrisponde ai tuoi filtri, in ordine casuale.

ARGENTO

Popolarità

• I risultati vengono restituiti in base solo alla pertinenza alla categoria.

GOLD

Ranging ottimizzato per le entrate

• I risultati pertinenti vengono classificati in base alla probabilità che il prodotto venga acquistato in base all'attività a livello di sito.

PLATINUM

Ranking personalizzato ottimizzato per le entrate

• I risultati pertinenti vengono classificati in base alle preferenze del singolo utente e alla probabilità che il prodotto venga acquistato in base all'attività a livello di sito.

La console Ricerca per la vendita al dettaglio fornisce una pagina Qualità dei dati in cui puoi verificare se hai soddisfatto i requisiti dei dati di ogni livello.

Le sezioni successive mostrano come registrarti per ricevere avvisi sulla qualità dei dati che ti informano a quali livelli rientrano i tuoi dati, in base ai parametri correnti. Questi avvisi fungono anche da guida per i requisiti specifici dei dati dei casi d'uso al fine di ottimizzare al meglio i risultati di ricerca.

Controllare la qualità dei dati

Dopo aver caricato i dati, vai alla console Ricerca per la vendita al dettaglio per visualizzare le metriche di controllo dei dati per ogni livello di rendimento per il tuo caso d'uso.

1. Vai alla pagina Qualità dei dati nella console Ricerca per la vendita al dettaglio.
   
   Vai alla pagina Qualità dei dati

2. Visualizza le metriche del controllo dei dati per il tuo caso d'uso sulla rete di ricerca:

   • Per le metriche di ricerca di testo, fai clic sulla scheda Ricerca.
   • Per le metriche di ricerca nella visualizzazione di elenco, fai clic sulla scheda Sfoglia.

3. Controlla la scheda dei problemi di ciascun livello di rendimento nella parte superiore della pagina.

   • Se è etichettato come "In uso": hai risolto tutti i problemi di blocco per quel livello e lo hai sbloccato.
   • Se ci sono 0 problemi di blocco, hai soddisfatto i dati controlli per quel livello. Se non ci sono problemi di blocco per questo livello e per tutti i livelli precedenti, sono necessarie circa 24 ore per addestrare e preparare il modello e attivare il livello appena sbloccato.
   • Se si verificano problemi di blocco, controlla le metriche del livello in questione. per capire quali problemi relativi ai dati risolvere per sbloccare il livello.

4. Visualizza la tabella delle metriche di controllo dei dati di ciascun livello di rendimento per visualizzare un elenco problemi che possono bloccare gli upgrade dei livelli o influire sul rendimento della ricerca.

5. Controlla la colonna Stato per il livello di priorità di ogni metrica di controllo dei dati:

   • Blocco dell'upgrade: identifica i problemi dei dati che impediscono alla ricerca di eseguire l'upgrade del tuo caso d'uso al livello di prestazioni successivo. Per sbloccare un livello, devi soddisfare tutti i controlli dei dati che bloccano l'upgrade per quel livello di prestazioni (e quelli dei livelli precedenti).
   • Critico per il rendimento: identifica i problemi dei dati che non bloccano un upgrade, ma possono avere un impatto significativo sulle prestazioni della ricerca testuale o della ricerca con navigazione.
   • Conforme: indica che questo controllo dei dati è stato superato.
   • Non disponibile: indica che un dato che non è stato bloccato a seguito di un upgrade non è stato ancora completato. I valori di queste metriche sono visualizzati come N/D. Il calcolo di alcuni controlli dei dati potrebbe richiedere fino a 24 ore dopo l'importazione dei dati.

6. Per ulteriori informazioni su una metrica, fai clic su Dettagli per visualizzare un riquadro dettagliato che mostra la descrizione della metrica, il timestamp del controllo dei dati e i valori di soglia.

7. Verifica i valori delle soglie nel riquadro Dettagli di una metrica necessarie per soddisfare il controllo dei dati di quella metrica e migliorare i risultati. Non tutte le soglie si applicano a tutte le metriche:

   • Soglia di blocco: una soglia obbligatoria da soddisfare per soddisfare il controllo dei dati di questa metrica.
   • Soglia critica: una soglia che ti consigliamo vivamente di raggiungere. Il mancato raggiungimento di questa soglia può avere un impatto negativo significativo sul rendimento.
   • Soglia di avviso: una soglia consigliata da raggiungere. Il mancato rispetto di questa soglia può avere un impatto minore sulle prestazioni.

Per importare altri dati per risolvere eventuali problemi, consulta Importare gli eventi utente storici o Importare le informazioni del catalogo nella documentazione pubblica.

Best practice

• Nelle richieste di ricerca e negli eventi utente, fornisci gli ID utente oltre agli ID visitatore per gli utenti che hanno eseguito l'accesso. Ciò consente alla ricerca di personalizzare risultati per l'utente in base ai dati di eventi in cui è stato eseguito l'accesso su più dispositivi.
• Invia gli eventi utente in tempo reale anziché nei caricamenti in gruppo con un ritardo. Questo consente di personalizzare la ricerca in base all'attività più recente di un utente sul tuo sito.
• Carica tutti gli eventi utente. Ad esempio, non inviare solo eventi che attribuibili alle ricerche.

Selezione delle funzionalità per i livelli superiori ottimizzati per le entrate

È stato eseguito l'upgrade di Vertex AI Search for Retail per i rivenditori i cui dati hanno raggiunto i livelli di prestazioni superiori che sbloccano funzionalità di ricerca ottimizzate per le entrate. Ora i rivenditori di questi livelli superiori possono utilizzare la selezione delle funzionalità:

• Per la navigazione: SILVER e GOLD
• Per la Ricerca: livelli 3 e 4

Perché l'upgrade del ranking?

I grandi clienti di Vertex AI Search for Retail hanno fino a 10.000 attributi personalizzati nel catalogo dei prodotti, mentre in precedenza il modello di ranking aveva solo 20 caratteristiche statiche del prodotto (come prezzo e valutazione media) condivise tra tutti i clienti. Di conseguenza, il modello di ranking aveva dati di prodotto molto incompleti e non era possibile personalizzare le funzionalità dei prodotti in base a diversi domini di vendita al dettaglio e casi d'uso, come moda, hardware o articoli per la casa.

L'impossibilità di modellare gli attributi personalizzati ha portato alcuni utenti a inserire gli attributi considerati importanti nelle funzionalità di prodotto statiche (fisse). Tuttavia, si trattava di uno sforzo manuale e chiaramente funzionava solo per un numero limitato di attributi.

Selezione di funzionalità personalizzate dinamiche

Vertex AI Search for Retail ha eseguito l'upgrade dei suoi livelli ottimizzati per le entrate agli attributi personalizzati a selezione automatica. L'upgrade comporta l'integrazione di attributi personalizzati pertinenti nel processo di ranking:

• Esamina tutti gli attributi personalizzati per ciascun rivenditore e sceglie quelli più utili da aggiungere all'insieme di caratteristiche statiche del prodotto.
• Mostra gli attributi selezionati per ciascun rivenditore.
• Ripeti la procedura di selezione dei componenti in modo regolare (una volta ogni 30 giorni).

Riepilogando, Vertex AI Search for Retail non solo consente al modello di ranking di accedere fino a 100 volte o più potenziali nuove funzionalità da selezionare per il modello, ma anche gli attributi di ciascun cliente vengono aggiornati regolarmente per adattarsi alle vendite stagionali e ad altre variazioni dei dati dinamici.

La nuova soluzione per il ranking fornisce approfondimenti sulle ricerche più efficaci, utilizzando attributi personalizzati regolarmente aggiornati per migliorare la qualità dei dati.

Conoscenza completa del prodotto

• Selezione delle caratteristiche: l'algoritmo di Vertex AI Search for Retail seleziona fino a 20 attributi personalizzati più importanti per ciascun rivenditore.
• Vantaggi: maggiore precisione del ranking grazie all'utilizzo di informazioni aggiuntive sui prodotti, ad esempio codici promozionali e specifiche di prodotti o stili.
• Visibilità: i rivenditori possono visualizzare gli attributi personalizzati selezionati e assicurarsi che siano aggiornati e gestiti.
• Personalizzazione e apprendimento: i clienti possono identificare schemi in attributi personalizzati selezionati e aggiungerne altri pertinenti per migliorare ulteriormente il rendimento del ranking.

Come vedere quali attributi vengono utilizzati

Se un cliente ha attivato i livelli più elevati con un numero sufficiente di punti dati sugli eventi utente, le nuove informazioni sugli attributi personalizzati sono ora visibili nella console, elencate nella scheda Ricerca di testo e/o Ricerca di navigazione nella pagina Qualità dei dati della Ricerca per la vendita al dettaglio. Qui sono indicati gli attributi personalizzati scelti dal sistema Vertex AI Search for Retail.

Nota: gli attributi non devono essere disponibili per la ricerca, ma devono essere presenti nel tuo catalogo dei prodotti. Nota: il numero di attributi non è limitato. Puoi aggiungere tutti gli attributi che preferisci. Tutti sono idonei alla selezione delle funzionalità.

Che cosa fare con gli attributi personalizzati

• Mantieni e non eliminare o ritirare gli attributi scelti perché potrebbero influire sul modello.
• Migliora la copertura per gli attributi selezionati automaticamente, compilando questi campi per più prodotti
• Esamina le tendenze in cui gli attributi personalizzati sono selezionati automaticamente. Se hai altri attributi simili, aggiungili al tuo catalogo. Diventeranno candidati per la selezione da parte dell'algoritmo di ricerca delle caratteristiche.
• Annota correttamente gli attributi numerici assegnando loro valori numerici anziché valori stringa. Ad esempio, fornisci un valore numerico pari a 10.5, anziché testo ("10,5").

Disattivare la personalizzazione

Per disattivare la personalizzazione, imposta ServingConfig.personalizationSpec su mode.DISABLED.

Avvisi sulla qualità dei dati

Gli avvisi sulla qualità dei dati vengono attivati se il valore di una metrica nella dashboard passa da soddisfacente a non soddisfacente. Gli avvisi vengono inviati via email.

Se vuoi visualizzare gli avvisi relativi a Cloud Monitoring, vai a Configurare gli avvisi.

Visualizza qualità dei dati

1. Vai alla pagina Qualità dei dati nella console di Search for Retail.
   
   Vai alla pagina Qualità dei dati

2. Esamina righe, metriche e avvisi: una riga corrisponde a una metrica e una metrica a un avviso.

Configurare gli avvisi sulla qualità dei dati

REST

Chiama l'API UpdateAlertConfig.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \
 "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \
--data '
{
  "alertPolicies": [
    {
      "alertGroup": "search-data-quality",
      "enrollStatus": "ENROLLED",
      "recipients": [
        {
          "emailAddress": "EMAIL_ADDRESS_1"
        },
        {
          "emailAddress": "EMAIL_ADDRESS_2"
        }
      ]
    }
  ]
}'

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto Google Cloud.
• EMAIL_ADDRESS_1, EMAIL_ADDRESS_2: gli indirizzi email per cui vuoi registrarti per ricevere gli avvisi. Devono essere conformi a SMTP. È possibile aggiungere al massimo 20 indirizzi email a un criterio di avviso.

Console

1. Vai alla pagina Qualità dei dati nella console di Search for Retail.
   
   Vai alla pagina Qualità dei dati

2. In alto, fai clic su Configura avvisi.

3. Aggiungi almeno un indirizzo email. Gli indirizzi email devono essere conformi al protocollo SMTP (Simple Mail Transfer Protocol). In un criterio di avviso puoi aggiungere al massimo 20 indirizzi email.

4. Fai clic su Invia.

Disattivare gli avvisi sulla qualità dei dati

REST

Chiama l'API UpdateAlertConfig.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \
 "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \
--data '
{
  "alertPolicies": [
    {
      "alertGroup": "search-data-quality",
      "enrollStatus": "DECLINED",
      "recipients": [
      ]
    }
  ]
}'

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto Google Cloud.

Console

1. Vai alla pagina Qualità dei dati nella console di Search for Retail.
   
   Vai alla pagina Qualità dei dati

2. Fai clic su Configura avvisi.

3. Elimina tutte le email esistenti.

4. Fai clic su Invia.

Risoluzione dei problemi

Ecco come risolvere i seguenti problemi comuni.

Il controllo dei dati non viene superato

Se un controllo dei dati non viene superato, fai clic su Dettagli per la metrica in questione nella pagina Qualità dei dati per visualizzare una descrizione più dettagliata della metrica e le soglie da soddisfare per soddisfare il controllo dei dati.

Se hai già soddisfatto i requisiti dei dati, controlla la sezione Timestamp quando è stata calcolata l'ultima metrica. Se hai riformattato o importato di recente una quantità significativa di dati, il ricalcolo potrebbe richiedere diverse ore o una metrica di valutazione.

Se non hai soddisfatto i requisiti relativi ai dati, potresti dover riformattare i dati o raccogliere più dati per soddisfare i requisiti di controllo dei dati. Dopo aver verificato i tuoi dati raggiungeranno la soglia delle metriche, reimporta i dati riformattati o importa i dati aggiuntivi, poi attendi che la metrica venga ricalcolare.

Un valore metrica etichettato come N/D

I valori delle metriche vengono visualizzati come N/D se non sono stati caricati dati o se le metriche non sono ancora state calcolate. Potrebbero essere necessarie fino a 24 ore dopo l'importazione dei dati in per calcolare alcuni controlli dei dati.

Il livello di prestazioni non presenta problemi di blocco, ma non è in uso

Per risolvere il problema, segui questi passaggi:

1. Verifica se ci sono problemi di blocco dei dati per i livelli precedenti. Devi Soddisfare i requisiti di tutti i livelli precedenti per eseguire l'upgrade al livello successivo.

2. Attendi 24 ore. Una volta superati tutti i controlli dei dati che bloccano l'upgrade, sono necessarie circa 24 ore per addestrare e preparare il modello e attivare il livello appena sbloccato.

Se il livello di prestazioni non è contrassegnato come in uso entro due giorni dal superamento di tutti i controlli dei dati che ne bloccano l'upgrade, contatta l'assistenza di Vertex AI Search for Retail fornendo il numero e l'ID progetto per ricevere assistenza.

Informazioni aggiuntive sui requisiti dei dati

Per saperne di più sui requisiti dei dati di Vertex AI Search for Retail, consulta la documentazione:

• Requisiti generali di Vertex AI Search for Retail durante il caricamento dei dati sugli eventi utente: Requisiti per gli eventi utente
• Requisiti minimi per gli eventi utente per ottenere risultati per la ricerca: Requisiti di ricerca
• Requisiti dei dati di catalogo: Metriche sulla qualità dei dati del catalogo

Passaggi successivi

• Importare gli eventi utente storici
• Importare le informazioni del catalogo