La funzionalità Retail verrà rinominata in Vertex AI Search for Retail. Stiamo aggiornando i contenuti in base al nuovo branding.

Questa pagina è stata tradotta dall'API Cloud Translation.

Completamento automatico per la ricerca

Questa pagina illustra la funzionalità di completamento automatico e come utilizzarla. La Ricerca fornisce il completamento automatico per supportare i rivenditori cerca suggerimenti di digitazione nella casella.

Il completamento automatico è una funzionalità che consente di prevedere la parte rimanente di una query digitata dall'utente, il che può migliorare la sua esperienza di ricerca e accelerare la procedura di acquisto prima del pagamento. Inoltre, può migliorare la ricerca la qualità delle risposte e quindi generare maggiori entrate grazie a formati query.

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 "magliette" potrebbe essere suggerito quando l'utente digita "sh".

Origine dati

Puoi scegliere una delle seguenti origini dati per il suggerimento previsioni:

Un set di dati BigQuery caricato da te.
Un set di dati generato da eventi utente e altri metadati utilizzando una macchina machine learning.

Set di dati caricato

Una tabella di suggerimenti BigQuery caricata come set di dati, ovvero utilizzati per suggerire query. Per sapere come caricare un set di dati, consulta Importazione dei 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:

Console

Vai alla pagina Controlli
Vai alla scheda Controlli completamento automatico.
Fai clic su Modifica impostazioni.
Attiva l'opzione Apprendimento automatico.
Fai clic su Salva impostazioni.

L'aggiornamento dell'apprendimento automatico può richiedere 1-2 giorni.

cURL

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 in base al tipo di ricerca eventi utente (eventType = "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 per il tipo di ricerca è troppo bassa (meno di 20.000), molti suggerimenti i candidati potrebbero essere esclusi. In questo scenario, ti consigliamo di eseguire prima 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. L'intero ciclo 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.

Funzionalità	Descrizione	Esempio
Rimuovi i caratteri speciali	Rimuovi i caratteri non standard sia dai dati dei suggerimenti sia dalle query digitate. Caratteri standard che vengono conservati nei dati dei suggerimenti e nelle query digitate sono: `%`, `$`, `&` e `.` (punto)	"Il migliore #* del mondo! latte" → "latte migliore del mondo"
Rimuovere le ricerche senza risultati	Rimuovere le query che non hanno risultati di ricerca	Per il negozio di alimentari, "Borse Gucci" ha 0 risultati di ricerca, pertanto viene rimosso
Correggi gli errori di battitura	Correggere le parole con errori di battitura Pulisci anche le query di input in tempo reale prima della corrispondenza	"Milc" → "Milk"
Aggiungere query per la lista consentita	Vengono aggiunte le query consentite esplicitamente	Consulta la sezione Ulteriori informazioni di seguito.
Rimuovere le query della lista bloccata	Le query che blocchi esplicitamente vengono rimosse	Consulta la sezione Ulteriori informazioni di seguito.
Rimuovere i termini non sicuri	Con tecnologia Google SafeSearch Rimuovere le query inappropriate	Contenuti pornografici, osceni, volgari, violenti e così via
Rimuovere i termini molto rari	Il sistema di AI regola il limite in base alle statistiche delle query Se i termini sono insolitamente rari, vengono rimossi	"74x39x9 pollici materasso ad aria matrimoniale a 2 strati con pompa a mano da 120 V"
Termini deduplicati	Basato sulla comprensione semantica basata sull'AI Per termini quasi identici, entrambi i termini corrispondono, ma verrà suggerito solo quello più popolare	"Scarpe per donna", "Scarpe da donna" e "Scarpe donna" sono deduplicati, pertanto ne verrà suggerita una sola.

Ricevi suggerimenti per il completamento

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

cURL

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.

Controllo	Dettagli	Località
Lista bloccata	Rimuove manualmente le query dai dati dei suggerimenti	Richiesta API: completionData:import. Per saperne di più, consulta Importare i dati di completamento automatico.
Lista consentita	Aggiunge manualmente query ai dati dei suggerimenti	Richiesta API: completionData:import (vedi anche Importazione dati di completamento automatico )
Lunghezza minima per attivare il completamento automatico	Controlla il numero di caratteri prima dell'attivazione del completamento automatico	Cloud Console > Controlli
Ordine corrispondente	L'ordine di corrispondenza determina il modo in cui la query dell'utente e i suggerimenti vengono abbinati.	Cloud Console > Controlli
Numero di suggerimenti	Questo è il numero di suggerimenti che verranno restituiti dal completamento automatico	Console Cloud > Controlli o Richiesta API: completeQuery.maxSuggestions
Tipo di dispositivo	Quando vengono specificati i tipi di dispositivi, i suggerimenti vengono generati in base alla popolarità dei tipi di dispositivi specificati Se non lo specifichi, vengono restituiti suggerimenti in base alla popolarità combinata di tutti i tipi di dispositivi	Richiesta API: completeQuery.deviceType
Origine dati suggerimento	Se utilizzi origini dati generate automaticamente e caricate, puoi scegliere quale usare al momento della query	Richiesta API: completeQuery.dataset
Lingua	Puoi specificare le lingue in cui vuoi ricevere i suggerimenti	Richiesta API: completeQuery.languageCodes[]

Lista consentita (elenco delle query da non rimuovere)

La ricerca esegue l'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 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 Console Cloud > Controlli > Controlli di completamento automatico > Elenco Non rimuovere o CompletionData:import.

Le modifiche diventeranno effettive tra circa 2 giorni.

Lista bloccata

La lista bloccata 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 bloccata non vengono mai visualizzati nei suggerimenti.

Per importare una lista bloccata, puoi utilizzare la console Cloud > Controlli > Controlli del completamento automatico > Lista bloccata o utilizza l'API CompletionData:import. Per istruzioni dettagliate su come importare una lista bloccata, vedi l'importazione dei dati di completamento.

Le modifiche diventeranno effettive tra 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 inseriti 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 "sh" corrisponde ai suggerimenti "scarpe" e "magliette", ma non il suggerimento "scarpe rosse".

Se l'opzione è impostata su "Il suggerimento può iniziare da qualsiasi punto del termine", il completamento automatico tokenizza il termine di input utente in parole e lo abbina alle parole in suggerimenti, indipendentemente dall'ordine delle parole. Ad esempio, il termine di input utente meraviglioso" corrisponde ai suggerimenti "camicie rosse", "scarpe rosse" e "scarpe rosse 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 nella pagina Console Cloud > Controlli > Controlli del completamento automatico > Conteggio suggerimenti o può essere impostato 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 contenuti o ricevere suggerimenti diversi in base a tipi di dispositivi. Se deviceType non è specificato in completeQuery, il suggerimento verrà applicato 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 lo user agent nel 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 set di caratteristiche aggiuntivo per ogni termine di suggerimento di query per consentire ai clienti di mostrare le funzioni avanzate sui loro siti web.

Il FeatureSet viene visualizzato nella risposta come mappa di valori chiave. Al momento, Vertex AI Search for Retail restituisce fino a cinque categorie e brand popolari correlati a ogni suggerimento di query completeQuery.completionResults.attributes Risposta dell'API. 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:

Aggrega e crea "Brand popolari" e "Categorie popolari" che compaiono 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 le categorie dei prodotti, prevedi di attendere da due settimane a 30 giorni prima che i suggerimenti del set di caratteristiche riflettano 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 che corrispondono all'input utente stringhe. I tipi di suggerimenti di attributi supportati sono brand e categorie.

I suggerimenti per gli attributi sono diversi da un set di caratteristiche suggerimento. 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 il numero di prodotti (sperimentale)

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

Quando il fattore di suggerimento con la funzionalità di conteggio dei prodotti è attivato, il valore restituito completeQuery.completionResults fornisce un elenco di suggerimenti di completamento automatico come di consueto, ma anche il conteggio dei prodotti per ogni suggerimento con il conteggio totale e il conteggio dei prodotti per fattore (ad es. "colore", "categoria").

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 è "colore", con ogni suggerimento di completamento automatico vengono restituiti anche il conteggio dei prodotti e il conteggio dei prodotti per colore:

scarpe da donna (32)
- nero (10)
- 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 prendere in considerazione scarpe verdi per uomo avendo le scarpe verdi vengono visualizzate nella parte superiore della casella dei suggerimenti anche se non sono le più usate molto utile.

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 sotto forma di elenco Facets pollici 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 ricerca suggerita la query viene restituita completeQuery.completionResults.totalProductCount

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

Contatta il team di assistenza e chiedi di attivare la funzionalità. "Facet suggerimento con conteggi prodotti". Specifica quale FacetKeys per i quali vuoi ricevere i conteggi dei prodotti. Sono consentiti solo textual_fields facet.
Per almeno 7 giorni, assicurati di utilizzare search API, includi la chiave facet in FacetSpecs includi la chiave facet 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.
Una volta attivata la funzione, i suggerimenti restituiti del L'API completeQuery contiene il conteggio dei prodotti per facet e per suggerimento.

Suggerimento filtrato per entità

Le entità ti consentono di filtrare i suggerimenti di ricerca con completamento automatico. Un'entità può essere un sito web per un brand o una regione diversi. Vuoi che il completamento automatico rispecchi al meglio Il comportamento degli utenti che acquistano quel determinato brand o sito web regionale. Per ulteriori informazioni sulle entità, consulta Entità.

Per includere entità nei suggerimenti di completamento automatico:

Includi il campo entity negli eventi utente di ricerca (eventType = "search"). Per informazioni, vedi l'esempio completo di oggetto per l'evento utente Search (Ricerca).
Imposta il campo entity nella richiesta dell'API CompleteQuery per ricevere suggerimenti solo per quell'entità.

La stringa entità negli eventi utente e nelle richieste API deve essere un numero corrispondono. 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.