Completamento automatico per la ricerca

Questa pagina introduce la funzionalità di completamento automatico e spiega come utilizzarla. La ricerca fornisce il completamento automatico per i suggerimenti di digitazione nella casella di ricerca di indicazioni stradali.

Il completamento automatico è una funzionalità che prevede il resto di una query che un utente sta inserendo, il che può migliorare l'esperienza di ricerca dell'utente e accelerare la procedura di acquisto prima del pagamento. Può anche migliorare la qualità delle risposte di ricerca e quindi generare entrate più elevate 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 suggerite quando l'utente inserisce sca.

Origine dati

Puoi scegliere una delle seguenti origini dati per le previsioni dei suggerimenti:

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

Set di dati caricato

Una tabella di suggerimenti BigQuery che carichi come set di dati, che viene utilizzata per suggerire query. Per informazioni su come caricare un set di dati, vedi Importare i dati di completamento automatico.

Set di dati di autoapprendimento

Un set di dati di suggerimenti basati 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 per il set di dati di autoapprendimento

L'apprendimento automatico genera suggerimenti a partire dagli eventi utente (eventType = "search") del 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 filtra i suggerimenti rari, quindi se la quantità di eventi utente di tipo di ricerca è troppo piccola (meno di 20.000), molti candidati per i suggerimenti potrebbero essere filtrati. In questo scenario, 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 al rilascio. Il ciclo completo richiede circa due giorni.

Funzionalità di apprendimento automatico

La ricerca applica tecniche di machine learning per ripulire 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 la tabella seguente per una panoramica e maggiori dettagli.

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 ignora durante la post-elaborazione.

I termini consentiti non vengono mai esclusi dai suggerimenti. La lista consentita funziona sia per i set di dati caricati sia per i set di dati di autoapprendimento.

Esempi: alcuni nomi di brand sono intenzionalmente scritti in modo errato, ad esempio "froot loops" invece di "fruit" o "foot". Consulta le istruzioni dettagliate per il caricamento in Importare i dati di completamento.

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

Le modifiche diventano effettive entro circa due giorni.

Lista bloccata

La lista bloccata funziona solo per i set di dati di autoapprendimento. La denylist non funziona per i set di dati caricati.

I termini in una denylist non vengono mai visualizzati nei suggerimenti.

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

Le modifiche diventano effettive entro circa due giorni.

Lunghezza minima per l'attivazione

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

Le modifiche hanno effetto immediato.

Ordine corrispondente

Determina come abbinare i suggerimenti ai termini input utente.

Se impostato su Il suggerimento inizia con il termine, il completamento automatico corrisponde al termine inserito dall'utente come prefisso esatto dei suggerimenti. Ad esempio, l'input utente dell'utente "sc" 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 tokenizza il termine inserito dall'utente in parole e lo abbina alle parole nei suggerimenti, indipendentemente dall'ordine delle parole. Ad esempio, il termine input utente dall'utente "magliette rosse" corrisponde ai suggerimenti "magliette rosse", "scarpe rosse" e "scarpe rosse per bambini". Tuttavia, il termine di input "zappe" non corrisponde a questi suggerimenti perché nessuna delle parole nei suggerimenti inizia con "zappe".

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

Le modifiche hanno effetto immediato.

Numero di suggerimenti

Questo è il numero di suggerimenti che verranno restituiti dalle query di completamento automatico e non può superare 20. L'impostazione è disponibile in console Cloud > Controlli > Controlli di completamento automatico > Conteggio 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 riguarderà 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 del wiki.

Funzionalità avanzate

Questa sezione descrive le funzionalità avanzate di completamento automatico 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.

Suggestion FeatureSet

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

FeatureSet viene visualizzato nella risposta come mappa chiave-valore. Vertex AI Search for Commerce restituisce fino a cinque categorie e brand popolari correlati a ogni suggerimento di query nella risposta dell'API completeQuery.completionResults.attributes. I suggerimenti per 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:

• Aggrega e crea 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 dei suggerimenti di ricerca.

Dopo aver apportato modifiche al catalogo, ad esempio la modifica delle categorie dei prodotti, devi attendere da due settimane a 30 giorni prima che i suggerimenti per i FeatureSet riflettano le modifiche al catalogo dei prodotti. Questo tempo di attesa è dovuto al fatto che l'apprendimento automatico si basa sui dati degli eventi di ricerca degli ultimi 30 giorni.

Suggerimenti per gli attributi

La ricerca fornisce suggerimenti per gli attributi che corrispondono alle stringhe di input utente'utente. I tipi di suggerimenti per gli attributi supportati sono marche e categorie.

I suggerimenti per gli attributi sono diversi da un FeatureSet di suggerimenti. I suggerimenti per gli attributi sono elenchi di attributi di prodotto suggeriti (come brand e categorie), simili a come i suggerimenti per le query sono elenchi di query suggerite. I suggerimenti per gli attributi possono essere utilizzati indipendentemente dai suggerimenti per le query. Un FeatureSet di suggerimenti è un metadati per un suggerimento di query e dipende quindi dai suggerimenti di query.

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

Facet di suggerimento con conteggi dei prodotti (sperimentale)

Si tratta di una funzionalità sperimentale per un numero limitato di clienti. Per utilizzarlo, contatta il team di assistenza.

Quando la sfaccettatura dei suggerimenti con la funzionalità di conteggio dei prodotti è attivata, il valore restituito completeQuery.completionResults 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 sfaccettatura (ad esempio 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 un conteggio dei prodotti e un conteggio dei prodotti per colore:

• scarpe da donna (32)
  • nero (10)
  • taupe (16)
  • bianco (10)
• scarpe da uomo (43)
  • nero (10)
  • marrone (5)
  • verde (17)

In qualità di rivenditore, non devi mostrare il conteggio dei prodotti all'acquirente, ma potresti decidere di ordinare l'elenco dei suggerimenti in base al conteggio dei prodotti anziché all'ordine restituito in completeQuery.completionResults. Ad esempio, potresti voler incoraggiare gli acquirenti a dare un'occhiata alle scarpe verdi da uomo facendo in modo che le scarpe verdi vengano visualizzate nella parte superiore della casella dei suggerimenti anche se non sono l'articolo più popolare.

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 facet vengono visualizzate come un elenco di Facets in completeQuery.completionResults.facets per ogni query di ricerca suggerita. Ogni sfaccettatura ha un elenco FacetValues che contiene il conteggio dei prodotti per valore della sfaccettatura. Il conteggio totale dei prodotti per ogni query di ricerca suggerita viene restituito in completeQuery.completionResults.totalProductCount.

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

1. Contatta il team di assistenza e chiedi di attivare la funzionalità Suggerimento sfaccettatura con conteggi dei prodotti. Specifica per quale FacetKeys vuoi i conteggi dei prodotti. Sono consentite solo textual_fields sfaccettature.

2. Per almeno 7 giorni, assicurati che quando utilizzi l'API search, includi la chiave del facet in FacetSpecs e in search.searchRequest.facetSpecs.

   Questo tempo di attesa è dovuto al fatto che le informazioni sulle sfaccettature vengono calcolate utilizzando i dati delle cronologie delle ricerche dell'ultima settimana.

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

Suggerimento filtrato per entità

Le entità ti consentono di filtrare i suggerimenti di completamento automatico della ricerca. 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 acquistano un determinato brand o sito web regionale. Per saperne di più sulle entità, consulta Entità.

Tieni presente che il filtro delle entità verrà applicato solo a completion_results (pertinente per UserEvent). Questo filtro non verrà applicato a attribute_results (pertinente per Product). Quindi, indipendentemente dal valore di entity, attribute_results è lo stesso.

Per includere entità nei suggerimenti di completamento automatico:

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

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

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

3. Assicurati che l'entità (negli eventi utente di ricerca o nelle richieste di completamento automatico) contenga al massimo 256 caratteri. Una più lunga viene troncata a 256 caratteri durante l'elaborazione degli eventi o delle richieste, rischiando una mancata corrispondenza.

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.