Sblocca i livelli di prestazioni della ricerca

In questa pagina vengono descritti i casi d'uso della rete di ricerca, i rispettivi livelli di prestazioni e come controllare se nella console Search for Retail una valutazione della qualità dei dati e dei livelli di prestazioni che hai sbloccato. Viene spiegato come registrarsi per ricevere avvisi sulla qualità dei dati.

Cerca casi d'uso

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

  • Ricerca di query di testo, utilizzata quando gli acquirenti cercano articoli sui tuoi l'applicazione inserendo query di testo e ottenendo una serie di risultati pertinenti.
  • Sfoglia ricerche, utilizzato quando i tuoi acquirenti vengono indirizzati a una determinata categoria. come "Appliances" pagina web di categoria di un bricolage sito di vendita al dettaglio del negozio e sfogliare 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 con navigazione hanno diversi livelli di rendimento che migliorare sempre di più i risultati di ricerca. Lo sblocco dei livelli di prestazioni si basa gli eventi utente e i dati del catalogo che carichi su Vertex AI Search for Retail.

Ogni livello di prestazioni viene attivato automaticamente quando soddisfi tutti i suoi requisiti dei dati per il blocco dell'upgrade. Devi inoltre soddisfare i requisiti per tutti ai livelli precedenti per passare 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 rispetto alla query
    • Pertinenza e popolarità: i risultati vengono restituiti in base alla pertinenza rispetto a query. I prodotti pertinenti sono classificati in base alla popolarità del prodotto sul tuo sito
    • Ottimizzato per le entrate: i risultati pertinenti sono classificati in base alla strategia di offerta probabilità di acquisto in base all'attività in tutto il sito
    • Personalizzato e ottimizzato per le entrate: i risultati pertinenti sono classificati in base alla 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 relativo alla ricerca sfogliando i

    • Popolarità: i risultati vengono restituiti solo in base alla pertinenza rispetto alla categoria
    • Ottimizzato per le entrate: i risultati pertinenti sono classificati in base alla strategia di offerta probabilità di acquisto in base all'attività in tutto il sito
    • Personalizzato e ottimizzato per le entrate: i risultati pertinenti sono classificati in base alla 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 visualizzarli e controllare le metriche di ogni 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 sulla rete di ricerca:

    • Per le metriche della ricerca testuale, fai clic sulla scheda Cerca.
    • Per sfogliare le metriche di ricerca, fai clic sulla scheda Sfoglia.

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

    • Se la dicitura "In uso" è contrassegnata come "In uso", hai soddisfatto tutti i requisiti di blocco problemi per quel livello e l'ho sbloccato.
    • Se ci sono 0 problemi di blocco, hai soddisfatto i dati controlli per quel livello. Se ci sono 0 problemi di blocco per questo livello e tutti i livelli precedenti, l'addestramento e la preparazione 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. Verifica nella colonna Stato il livello di priorità di ogni controllo dei dati metrica:

    • Blocco degli upgrade: identifica i problemi dei dati che impediscono cerca dall'upgrade del tuo caso d'uso al successivo al livello delle prestazioni. Per sbloccare un livello, devi soddisfare tutti i dati che bloccano l'upgrade verifica il livello di prestazioni in questione (e quelli dei livelli precedenti).
    • Performance critical: identifica i problemi dei dati che non bloccare un upgrade, ma possono avere un impatto significativo sulla ricerca testuale o rendimento della ricerca sulla pagina di 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 potrebbe richiedere fino a 24 ore dopo l'importazione dei dati alcune verifiche dei dati.

  6. Per ulteriori informazioni su una metrica, fai clic su Dettagli che mostra la descrizione della metrica, il timestamp del controllo dei dati e 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 vivamente consigliata da raggiungere. Il mancato raggiungimento di questa soglia può avere un impatto negativo significativo sul delle prestazioni.
    • Soglia di avviso: una soglia consigliata da raggiungere. No il raggiungimento di questa soglia può avere un impatto minimo sulle prestazioni.

Per importare più dati in modo da risolvere eventuali problemi relativi ai dati, consulta Importare la cronologia degli eventi utente o Importare le informazioni del catalogo nella documentazione pubblica.

Best practice

  • Nelle richieste di ricerca e negli eventi utente, fornisci gli ID utente oltre al ID 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.

Disattiva la personalizzazione

Per disattivare la personalizzazione, imposta Da ServingConfig.personalizationSpec a 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 vedere gli 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 e 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 che vuoi registrare per gli avvisi. Devono essere conformi a SMTP (Simple Mail Transfer Protocol). È 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). È possibile aggiungere al massimo 20 indirizzi email a un criterio di avviso.

  4. Fai clic su Invia.

Disattiva 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. In alto, fai clic su Configura avvisi.

  3. Elimina tutte le email esistenti.

  4. Fai clic su Invia.

Risoluzione dei 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 in questione nella sezione Dati Qualità per visualizzare una descrizione più dettagliata di tale metrica e soglie necessarie per soddisfare il controllo dei dati.

Se hai già soddisfatto i requisiti dei dati, controlla la sezione Timestamp e indica 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 dei dati, potresti dover riformattare i dati o raccogliere più dati per soddisfare i requisiti del controllo. 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.

Il valore di una metrica viene visualizzato come N/D

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

Un livello di rendimento non ha 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, per addestrare e preparare il modello e attivare la livello.

Se il livello di prestazioni non viene contrassegnato come in uso entro due giorni dal superamento di tutte le contatta l'assistenza di Vertex AI Search per il retail con 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:

Passaggi successivi