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:
Console
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 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.
| Funzionalità | Descrizione | Esempio |
|---|---|---|
| Rimuovere le ricerche senza risultati |
|
Per il rivenditore di generi alimentari, la query "borse Gucci" non ha risultati di ricerca, quindi viene rimossa |
| Correggere gli errori ortografici |
|
"Milc" → "Milk" |
| Aggiungere query per la lista consentita |
|
Consulta la sezione Ulteriori informazioni di seguito. |
| Rimuovere le query della lista bloccata |
|
Consulta la sezione Ulteriori informazioni di seguito. |
| Rimuovere i termini non sicuri |
|
Contenuti pornografici, osceni, volgari, violenti e così via |
| Rimuovere i termini molto rari |
|
"74x39x9 pollici materasso ad aria matrimoniale a 2 strati con pompa a mano da 120 V" |
| Termini deduplicati |
|
"Scarpe da donna", "Scarpe da donna" e "Scarpe donna" sono deduplicati, quindi verrà suggerita una sola parola. |
Ricevere suggerimenti di 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 |
|
Richiesta API: CompletionData:import. Per saperne di più, consulta Importare i dati del completamento automatico. |
| Lista consentita |
|
Richiesta API: CompletionData:import (vedi anche Importare i dati di completamento automatico ) |
| Lunghezza minima per attivare il completamento automatico |
|
Cloud Console > Controlli |
| Ordine corrispondente |
|
Cloud Console > Controlli |
| Numero di suggerimenti |
|
Console Cloud > Controlli o Richiesta API: completeQuery.maxSuggestions |
| Tipo di dispositivo |
|
Richiesta API: completeQuery.deviceType |
| Origine dati dei suggerimenti |
|
Richiesta API: completeQuery.dataset |
| Lingua |
|
Richiesta API: completeQuery.languageCodes[] |
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 impostata 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:
Contatta il team di assistenza e chiedigli di attivare la funzionalità Facetta di suggerimento con conteggi dei prodotti. Specifica per quale
FacetKeysvuoi conteggiare i prodotti. Sono consentite solotextual_fieldssfaccettature.Per almeno 7 giorni, assicurati che, quando utilizzi l'API
search, includa la chiave della frazione inFacetSpecse la chiave della frazione insearch.searchRequest.facetSpecs.Questo tempo di attesa è dovuto al fatto che le informazioni sulle sfaccettature vengono calcolate utilizzando i dati delle cronologie di ricerca della settimana precedente.
Una volta attivata la funzionalità, i suggerimenti restituiti dall'API
completeQuerycontengono 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:
Includi il campo
entitynegli eventi utente di ricerca (eventType = "search"). Per informazioni, consulta l'esempio completo dell'oggetto per l'evento utente Ricerca.Imposta il campo
entitynella richiesta dell'APICompleteQueryper 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.