Completamento automatico per la ricerca

Questa pagina illustra la funzionalità di completamento automatico e come utilizzarla. La Ricerca fornisce il completamento automatico per i suggerimenti di ricerca in tempo reale delle caselle di ricerca dei rivenditori.

Il completamento automatico è una funzionalità che consente di prevedere il resto di una query inserita dall'utente, il che può migliorare la sua esperienza di ricerca e accelerare la procedura di acquisto prima del pagamento. Può anche migliorare la qualità delle risposte di ricerca e, di conseguenza, aumentare le entrate fornendo query ben formattate.

Panoramica

Quando un utente finale inizia a digitare un termine di ricerca sul tuo sito, la ricerca può fornire un elenco di suggerimenti che l'utente potrebbe voler utilizzare. Ad esempio, "scarpe" e "camicie" potrebbero essere suggeriti quando l'utente digita "sc".

Origine dati

Per le previsioni dei suggerimenti, puoi scegliere una delle seguenti origini dati:

• Un set di dati BigQuery che carichi.
• Un set di dati generato da eventi utente e altri metadati utilizzando il machine learning.

Set di dati caricato

Una tabella di suggerimenti BigQuery caricata come set di dati, che viene utilizzata per suggerire query. Per scoprire come caricare un set di dati, consulta Importare i dati di completamento automatico.

Set di dati di apprendimento automatico

Un set di dati di suggerimenti basato sul machine learning generato dalla ricerca in base agli eventi di ricerca degli utenti.

Per attivare l'apprendimento automatico:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "Content-Type: application/json" \
  "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/completionConfig?update_mask.paths=auto_learning"  --data "{auto_learning: true}"

Prerequisito del set di dati di apprendimento automatico

L'apprendimento automatico genera suggerimenti dagli eventi utente (eventType = "search") relativi al tipo di ricerca. La generazione utilizza gli eventi utente degli ultimi 180 giorni. Richiede una buona qualità e quantità di eventi utente importati.

L'apprendimento automatico esclude i suggerimenti rari, pertanto se la quantità di eventi utente relativi al tipo di ricerca è troppo ridotta (meno di 20.000), molti candidati per i suggerimenti potrebbero essere esclusi. In questo caso, ti consigliamo di testare prima la funzione di completamento automatico con una query di ricerca più frequente.

Programma di rilascio dei set di dati di apprendimento automatico

Il set di dati di apprendimento automatico viene generato quotidianamente, quindi inviato all'indicizzazione e alla release. Il ciclo completo richiede circa due giorni.

Funzionalità di apprendimento automatico

La Ricerca applica tecniche di machine learning per pulire e formattare le query e i dati dei suggerimenti solo per il set di dati di apprendimento automatico.

Ricevere suggerimenti di completamento

Utilizza l'API completeQuery per recuperare i suggerimenti. Esempio:

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog:completeQuery?query=sho&dataset=user-data&deviceType=DESKTOP&maxSuggestions=5"

Opzioni e controlli di completamento automatico

Questa sezione spiega quali opzioni e controlli sono disponibili per il completamento automatico. Consulta una panoramica nella tabella seguente e ulteriori dettagli di seguito.

Lista consentita (elenco delle query da non rimuovere)

La ricerca esegue la post-elaborazione, ad esempio la correzione ortografica, sui dati dei suggerimenti di completamento automatico. Puoi creare una lista consentita di termini che la ricerca salta durante il post-trattamento.

I termini inclusi nella lista consentita non vengono mai filtrati dai suggerimenti. La lista consentita funziona sia per i set di dati caricati sia per il set di dati di apprendimento automatico.

Esempi: esistono alcuni nomi di brand scritti deliberatamente con errori ortografici, come "froot loops" anziché "fruit" o "foot". Consulta le istruzioni dettagliate per il caricamento in Dati di completamento dell'importazione.

Per l'importazione dei dati, puoi utilizzare Cloud Console > Controlli > Controlli di completamento automatico > Elenco Non rimuovere o CompletionData:import nell'API.

Le modifiche verranno applicate entro circa 2 giorni.

Lista bloccata

La lista negativa funziona solo per i set di dati di apprendimento automatico. La lista negativa non funziona per i set di dati caricati.

I termini in una lista negativa non vengono mai visualizzati nei suggerimenti.

Per importare una lista bloccata, puoi utilizzare Console Cloud > Controlli > Controlli completamento automatico > Lista bloccata o l'API CompletionData:import. Per istruzioni dettagliate su come importare una lista bloccata, consulta Importare i dati di completamento.

Le modifiche verranno applicate entro circa 2 giorni.

Lunghezza minima per l'attivazione

Puoi impostare il numero di caratteri richiesti prima che le query con completamento automatico returgano risultati. L'impostazione è disponibile in Cloud Console > Controlli > Controlli di completamento automatico > Lunghezza minima per l'attivazione.

Le modifiche hanno effetto immediato.

Ordine corrispondente

Questo determina in che modo abbinare i suggerimenti ai termini input utente dall'utente.

Se impostato su Il suggerimento inizia con il termine, il completamento automatico associa il termine inserito dall'utente come prefisso esatto ai suggerimenti. Ad esempio, l'input utente dell'utente "sh" corrisponde ai suggerimenti "scarpe" e "camicie", ma non al suggerimento "scarpe rosse".

Se impostato su Il suggerimento può iniziare in qualsiasi punto del termine, il completamento automatico suddivide il termine input utente in parole e le associa alle parole dei suggerimenti, indipendentemente dall'ordine delle parole. Ad esempio, il termine input utente dall'utente "red sh" corrisponde ai suggerimenti "camicie rosse", "scarpe rosse" e "scarpe rosse per bambini". Tuttavia, il termine inserito "hoes" non corrisponde a questi suggerimenti, perché nessuna delle parole nei suggerimenti inizia con "hoes".

L'impostazione è disponibile in Console Cloud > Controlli > Controlli di completamento automatico > Ordine di corrispondenza.

Le modifiche hanno effetto immediato.

Numero di suggerimenti

Si tratta del numero di suggerimenti che verranno restituiti dalle query con completamento automatico e non può superare 20. L'impostazione è disponibile in Cloud Console > Controlli > Controlli di completamento automatico > Numero di suggerimenti oppure può essere impostata in completeQuery.

Le modifiche hanno effetto immediato.

Tipo di dispositivo

Il completamento automatico della Ricerca supporta diversi tipi di dispositivi, ad esempio mobile e desktop. Puoi caricare o ricevere suggerimenti diversi in base ai tipi di dispositivo. Se deviceType non è specificato in completeQuery, il suggerimento verrà visualizzato su tutti i tipi di dispositivi.

Per un set di dati di apprendimento automatico basato sugli eventi utente di ricerca, imposta user_agent in UserEvent.user_info per supportare diversi tipi di dispositivi. Consulta la pagina user agent nella wiki.

Funzionalità avanzate

Questa sezione descrive le funzionalità di completamento automatico avanzate disponibili con la ricerca. Ad esempio, puoi integrare i suggerimenti di completamento automatico delle query con altri suggerimenti, come brand e categorie.

Queste funzionalità avanzate sono disponibili solo per i set di dati di apprendimento automatico.

FeatureSet di suggerimenti

Forniamo un FeatureSet aggiuntivo per ogni termine del suggerimento di query per consentire ai clienti di mostrare funzioni avanzate sui propri siti web.

Il FeatureSet viene visualizzato nella risposta come mappa di valori chiave. Al momento, completeQuery.completionResults.attributes la risposta dell'API Vertex AI Search for Retail restituisce fino a cinque categorie e brand popolari correlati a ogni suggerimento di query. I suggerimenti di FeatureSet non devono corrispondere alle stringhe di query inserite dall'utente finale.

Puoi utilizzare FeatureSet nella risposta per arricchire i suggerimenti di ricerca. Ad esempio:

• Aggregare e creare le sezioni Brand popolari e Categorie popolari che vengono visualizzate sotto l'elenco dei suggerimenti di ricerca.
• Mostra il brand o la categoria più popolare accanto ai termini di suggerimento di ricerca.

Dopo aver apportato modifiche al catalogo, ad esempio la modifica delle categorie dei prodotti, prendi in considerazione un periodo che va da due settimane a 30 giorni prima che i suggerimenti di FeatureSet riflettano le modifiche al catalogo dei prodotti. Questo tempo di attesa è dovuto al fatto che l'apprendimento automatico viene addestrato sui dati degli eventi di ricerca degli ultimi 30 giorni.

Suggerimenti per gli attributi

La Ricerca fornisce suggerimenti di attributi corrispondenti alle stringhe di input utente'utente. I tipi di suggerimenti di attributi supportati sono brand e categorie.

I suggerimenti di attributi sono diversi da un FeatureSet di suggerimenti. I suggerimenti di attributi sono elenchi di attributi dei prodotti suggeriti (come brand e categorie), allo stesso modo in cui i suggerimenti di query sono elenchi di query suggerite. I suggerimenti di attributi possono essere utilizzati indipendentemente dai suggerimenti di query. Un FeatureSet di suggerimenti è costituito da metadati per un suggerimento di query e, pertanto, dipende dai suggerimenti di query.

I suggerimenti di attributi possono essere utilizzati per completare automaticamente i brand o le categorie digitati da un utente finale, in sezioni separate sotto l'elenco dei suggerimenti di ricerca.

Facet di suggerimento con conteggi dei prodotti (sperimentale)

Questa è una funzionalità sperimentale per un numero limitato di clienti. Per utilizzarla, contatta il team di assistenza.

Quando la funzionalità del suggerimento con il conteggio dei prodotti è attivata, il valore completeQuery.completionResults fornito fornisce un elenco di suggerimenti di completamento automatico come di consueto, ma anche i conteggi dei prodotti per ciascun suggerimento con il conteggio totale e il conteggio dei prodotti per elemento (ad es. color, category).

Ad esempio, se la query di ricerca è "scarpa", i suggerimenti di completamento automatico restituiti potrebbero essere:

• Scarpe da donna
• scarpe da uomo

Inoltre, se la chiave facet di interesse è color, con ogni suggerimento di completamento automatico vengono restituiti anche il numero di prodotti e il numero di prodotti per colore:

• Scarpe da donna (32)
  • nero (10)
  • grigio talpa (16)
  • bianco (10)
• Scarpe da uomo (43)
  • nero (10)
  • marrone (5)
  • verde (17)

In qualità di rivenditore, non devi presentare il numero di prodotti allo shopper, ma puoi decidere di ordinare l'elenco di suggerimenti in base al numero di prodotti anziché all'ordine restituito in completeQuery.completionResults. Ad esempio, potresti voler incoraggiare gli acquirenti a guardare le scarpe verdi da uomo mostrandole nella parte superiore della casella dei suggerimenti, anche se non sono l'articolo più apprezzato.

Ad esempio:

{
  "completion_results": [{ 
    "suggestion": "womens shoes"
    "facets": [ 
      {
        "key": "color"
        "values": [ 
          {
            "value": "black"
            "count": 10
          }
          {
            "value": "taupe"
            "count": 16
          }
          {
            "value": "white"
            "count": 10
          }
        ]
      }
    ]
    "total_product_count": 32
  },
  (...)
  ],
}

Le informazioni sul conteggio dei componenti vengono visualizzate come un elenco di Facets in completeQuery.completionResults.facets per ogni query di ricerca suggerita. Ogni opzione ha un elenco FacetValues che contiene il conteggio dei prodotti per valore dell'opzione. Il numero totale di prodotti per ogni query di ricerca suggerita viene restituito in completeQuery.completionResults.totalProductCount.

Per attivare e utilizzare i suggerimenti con i conteggi dei prodotti:

1. Contatta il team di assistenza e chiedigli di attivare la funzionalità Facetta di suggerimento con conteggi dei prodotti. Specifica per quale FacetKeys vuoi conteggiare i prodotti. Sono consentite solo textual_fields sfaccettature.

2. Per almeno 7 giorni, assicurati che, quando utilizzi l'API search, includa la chiave della frazione in FacetSpecs e la chiave della frazione in search.searchRequest.facetSpecs.

   Questo tempo di attesa è dovuto al fatto che le informazioni sui filtri vengono calcolate utilizzando i dati delle cronologie di ricerca della settimana precedente.

3. Una volta attivata la funzionalità, i suggerimenti restituiti dall'API completeQuery contengono i conteggi dei prodotti per opzione e suggerimento.

Suggerimento filtrato per entità

Le entità ti consentono di filtrare i suggerimenti di ricerca con completamento automatico. Un'entità potrebbe essere un sito web per un brand o una regione diversi. Vuoi che il completamento automatico rifletta al meglio il comportamento degli utenti che fanno acquisti su quel determinato brand o sito web regionale. Per saperne di più sulle entità, consulta Entità.

Per includere le entità nei suggerimenti di completamento automatico:

1. Includi il campo entity negli eventi utente di ricerca (eventType = "search"). Per informazioni, consulta l'esempio completo dell'oggetto per l'evento utente Ricerca.

2. Imposta il campo entity nella richiesta dell'API CompleteQuery per ricevere suggerimenti solo per quella entità.

   La stringa dell'entità negli eventi utente e nelle richieste dell'API deve corrispondere esattamente. In caso contrario, il completamento automatico restituisce suggerimenti vuoti.

In genere, sono necessari 30-90 giorni di dati sugli eventi utente prima che la funzionalità delle entità possa restituire suggerimenti di completamento automatico ottimali.