Sblocca livelli di prestazioni sulla rete di ricerca

In questa pagina vengono descritti i casi d'uso della ricerca, i rispettivi livelli di prestazioni e come controllare la console di Search for Retail per una valutazione della qualità dei dati e dei livelli di prestazioni sbloccati. Mostra come registrarsi per gli avvisi sulla qualità dei dati.

Cerca casi d'uso

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

  • Ricerca con query di testo, utilizzata quando gli acquirenti cercano articoli nella tua applicazione inserendo query di testo e ricevendo una serie di risultati pertinenti.
  • La ricerca tramite sfoglia, utilizzata quando gli acquirenti vengono indirizzati a una determinata pagina di categoria, ad esempio la pagina web della categoria "Elettrodomestici" del sito di vendita al dettaglio di un negozio di fai da te, e sfogliano gli articoli ordinati di quella categoria.

Per ulteriori informazioni sulle differenze tra questi casi d'uso, consulta Informazioni sulla ricerca testuale e sulla ricerca con navigazione.

Livelli di prestazioni

La ricerca tramite query di testo ed esplora hanno diversi livelli di prestazioni che migliorano sempre più i risultati di ricerca. Lo sblocco dei livelli di rendimento si basa sui dati degli eventi utente e del catalogo che carichi su Vertex AI Search per la vendita al dettaglio.

Ogni livello di rendimento viene attivato automaticamente quando soddisfi tutti i requisiti dei dati che bloccano l'upgrade. Devi inoltre soddisfare i requisiti di tutti i livelli precedenti per eseguire l'upgrade al livello successivo.

Per ogni caso d'uso sono disponibili i seguenti livelli di prestazioni:

  • Caso d'uso della ricerca di query di testo

    • Pertinenza: i risultati vengono restituiti solo in base alla pertinenza alla query
    • Pertinenza e popolarità: i risultati vengono restituiti in base alla pertinenza alla query. I prodotti altrettanto pertinenti sono classificati in base alla popolarità del prodotto sul tuo sito
    • Ottimizzazione per le entrate: i risultati pertinenti sono classificati in base alla probabilità che il prodotto venga acquistato in base all'attività in tutto il sito
    • Personalizzato e 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à in tutto il sito

  • Caso d'uso delle ricerche

    • Popolarità: i risultati vengono restituiti solo in base alla pertinenza alla categoria
    • Ottimizzazione per le entrate: i risultati pertinenti sono classificati in base alla probabilità che il prodotto venga acquistato in base all'attività in tutto il sito
    • Personalizzato e 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à in tutto il sito

La console di Search for Retail fornisce una pagina Qualità dei dati in cui puoi verificare se hai soddisfatto i requisiti dei dati di ogni livello.

Controllare la qualità dei dati

Dopo aver caricato i dati, vai alla console di Search for Retail per visualizzare le metriche del controllo dei dati per ciascun livello di prestazioni per il tuo caso d'uso.

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

    Vai alla pagina Qualità dei dati

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

    • Per le metriche relative alla ricerca testuale, fai clic sulla scheda Cerca.
    • Per consultare le metriche di ricerca, fai clic sulla scheda Sfoglia.

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

    • Se è etichettata come "In uso": hai risolto tutti i problemi di blocco per quel livello e l'hai sbloccato.
    • Se sono presenti 0 problemi che bloccano la migrazione: hai soddisfatto i controlli dei dati per quel livello. Se non sono presenti 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 nuovo livello sbloccato.
    • In caso di problemi che bloccano la migrazione: controlla le metriche di quel livello per vedere quali problemi relativi ai dati risolvere in modo da sbloccare il livello.

  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 del livello o influire sulle prestazioni della ricerca.

  5. Controlla nella colonna Stato 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 le prestazioni: identifica i problemi dei dati che non bloccano un upgrade, ma possono avere un impatto significativo sulle prestazioni della ricerca testuale o ricerca con navigazione.
    • Conforme: indica che questo controllo dei dati è stato superato.
    • Non disponibile: indica che non è stato ancora completato un controllo dei dati che non sono disponibili per il blocco dell'upgrade. I valori per 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 dei dettagli in cui sono riportati la descrizione della metrica, il timestamp del controllo dei dati e i valori della soglia.

  7. Verifica le soglie nel riquadro Details di una metrica per verificare i valori necessari 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 richiesta da raggiungere per soddisfare il controllo dei dati di questa metrica.
    • Soglia critica: una soglia altamente consigliata da 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 raggiungimento di questa soglia può avere un impatto minimo sul rendimento.

Per importare più dati al fine di soddisfare eventuali problemi relativi ai dati, 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 che hanno eseguito l'accesso su tutti i dispositivi.
  • Invia gli eventi utente in tempo reale anziché in caricamenti collettivi con un ritardo. In questo modo la ricerca viene personalizzata in base all'attività più recente di un utente sul tuo sito.
  • Carica tutti gli eventi utente. Ad esempio, non inviare solo gli eventi attribuibili alle ricerche.

Disattiva 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 sulla dashboard passa da soddisfacente a non soddisfacente. Gli avvisi vengono inviati via email.

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

Visualizza qualità dei dati

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

Vai alla pagina Qualità dei dati

Una riga corrisponde a una metrica, mentre una metrica corrisponde 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 a cui vuoi registrarti per gli avvisi. Devono essere conformi al protocollo SMTP (Simple Mail Transfer Protocol). È possibile aggiungere al massimo 20 indirizzi email a un criterio di avviso.

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.

Risolvere i problemi

Di seguito sono riportati alcuni problemi comuni e come risolverli:

Un controllo dei dati non viene superato

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

Se hai già soddisfatto i requisiti dei dati, controlla la sezione Timestamp per sapere quando è stato calcolato l'ultimo calcolo della metrica. Se di recente hai riformattato o importato una quantità significativa di dati, potrebbero essere necessarie diverse ore per ricalcolare questa metrica.

Se non hai soddisfatto i requisiti dei dati, potrebbe essere necessario riformattare i dati o raccogliere più dati per soddisfare i requisiti per il controllo dei dati. Dopo aver verificato che i dati soddisfano la soglia della metrica, reimporta i dati riformattati o importa quelli aggiuntivi, poi attendi che la metrica venga ricalcolata.

Un valore di metrica viene visualizzato 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. Il calcolo di alcuni controlli dei dati potrebbe richiedere fino a 24 ore dopo l'importazione dei dati.

Un livello di prestazioni non presenta problemi di blocco ma non è in uso

Per risolvere il problema, segui questi passaggi:

  1. Controlla se sono presenti problemi che bloccano i dati per 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 nuovo livello sbloccato.

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

Informazioni aggiuntive sui requisiti dei dati

Per saperne di più sui requisiti di Vertex AI Search per i dati di vendita al dettaglio, consulta la documentazione:

Passaggi successivi