Qualità dei dati

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 di testo e sulla ricerca nella visualizzazione di siti.

Sbloccare i livelli di rendimento nella ricerca

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 for Retail.

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

Ricerca di query di testo

Sfoglia

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 seguenti mostrano come registrarsi per ricevere avvisi sulla qualità dei dati che ti informano di quale livello appartengono i tuoi dati, in base ai parametri correnti. Questi avvisi sono anche una guida per i requisiti dei dati specifici del tuo caso d'uso per 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 di controllo dei dati per il tuo caso d'uso 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 non sono presenti problemi che bloccano: hai soddisfatto i controlli dei dati 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.
   • In caso di problemi che bloccano la migrazione: controlla le metriche del livello per vedere quali problemi relativi ai dati devono essere risolti per sbloccarlo.

4. Visualizza la tabella delle metriche di controllo dei dati di ogni livello di prestazioni per visualizzare un elenco di 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 controllo dei dati che bloccano l'upgrade non è ancora stato completato. I valori di queste metriche vengono 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. Controlla le soglie nel riquadro Dettagli di una metrica per trovare i valori necessari per soddisfare il controllo dei dati della 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. In questo modo, la ricerca può personalizzare i risultati per l'utente in base agli eventi di accesso degli utenti su più dispositivi.
• Invia gli eventi utente in tempo reale anziché con caricamenti collettivi con un ritardo. In questo modo, la ricerca viene personalizzata utilizzando l'attività più recente di un utente sul tuo sito.
• Carica tutti gli eventi utente. Ad esempio, non inviare solo gli eventi attribuibili alle ricerche.

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

È stato eseguito l'upgrade di Vertex AI Search per il retail per i retailer i cui dati hanno raggiunto i livelli di rendimento più elevati che sbloccano le funzionalità di ricerca ottimizzate per le entrate. Ora i rivenditori di questi livelli superiori possono utilizzare la selezione delle funzionalità:

• Per la visualizzazione: ARGENTO e ORO
• Per la Ricerca: livelli 3 e 4

Perché l'upgrade del ranking?

I clienti di grandi dimensioni di Vertex AI Search per la vendita al dettaglio hanno fino a 10.000 attributi personalizzati nel loro catalogo dei prodotti, mentre in precedenza il modello di ranking aveva solo 20 funzionalità di prodotto statiche (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, questo richiedeva un intervento manuale e funzionava chiaramente solo per un numero limitato di attributi.

Selezione di funzionalità personalizzate dinamiche

Vertex AI Search per il retail ha eseguito l'upgrade dei suoi livelli ottimizzati per le entrate in modo da selezionare automaticamente gli attributi personalizzati. L'upgrade prevede 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 funzionalità dei prodotti statici.
• Mostra gli attributi selezionati per ciascun rivenditore.
• Ripeti la procedura di selezione dei componenti in modo regolare (una volta ogni 30 giorni).

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

La soluzione di ranking di cui è stato eseguito l'upgrade fornisce informazioni di ricerca più efficaci, utilizzando attributi personalizzati aggiornati regolarmente per migliorare la qualità dei dati.

Conoscenza completa del prodotto

• Selezione di funzionalità: l'algoritmo Vertex AI Search per il retail seleziona fino a 20 attributi personalizzati più importanti per ciascun rivenditore.
• Vantaggi: maggiore accuratezza del ranking grazie all'utilizzo di informazioni aggiuntive sui prodotti, come codici sconto e specifiche di prodotti o stili.
• Visibilità: i rivenditori possono visualizzare gli attributi personalizzati selezionati e assicurarsi che siano gestiti e aggiornati.
• 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 vengono indicati gli attributi personalizzati scelti dal sistema Vertex AI Search for Retail.

Che cosa fare con gli attributi personalizzati

• Mantieni e non eliminare o ritirare gli attributi scelti perché potrebbero influire sul modello.
• Migliora la copertura degli attributi selezionati automaticamente compilando questi campi per più prodotti
• Esamina le tendenze in cui gli attributi personalizzati vengono selezionati automaticamente. Se hai altri attributi simili, aggiungili al tuo catalogo. Questi elementi diventeranno candidati per la selezione dall'algoritmo di ricerca delle funzionalità.
• Annota correttamente gli attributi numerici assegnando loro valori numerici anziché valori di stringa. Ad esempio, fornisci un valore numerico di 10.5 anziché di 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 Ricerca per la vendita al dettaglio.
   
   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

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"
        }
      ]
    }
  ]
}'

Disattivare gli avvisi sulla qualità dei dati

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": [
      ]
    }
  ]
}'

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 per verificare quando è stata calcolata l'ultima volta la metrica. Se di recente hai riformattato o importato una quantità significativa di dati, potrebbero essere necessarie diverse ore per ricalcolare la metrica.

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 che i dati soddisfino la soglia della metrica, importa di nuovo i dati riformattati o i dati aggiuntivi, quindi attendi il nuovo calcolo della metrica.

Un valore della metrica etichettato come N/A

I valori delle metriche vengono visualizzati come N/D se non sono stati caricati dati o se le metriche non sono ancora state calcolate. Il calcolo di alcuni controlli dei dati potrebbe richiedere fino a 24 ore dopo l'importazione dei dati.

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

Per risolvere il problema, svolgi i passaggi che seguono:

1. Controlla se ci sono problemi con i dati che bloccano i livelli precedenti. Per eseguire l'upgrade al livello successivo, devi soddisfare i requisiti di tutti i livelli precedenti.

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 per il retail, consulta la documentazione:

• Requisiti generali di Vertex AI Search for Retail per 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 del catalogo: Metriche relative alla qualità dei dati del catalogo

Passaggi successivi

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