Retail è stato rinominato Vertex AI Search for Retail. Stiamo aggiornando i contenuti per riflettere il nuovo branding.

Questa pagina è stata tradotta dall'API Cloud Translation.

Completamento automatico per la ricerca

Questa pagina introduce 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à per prevedere il resto di una query digitata da un utente, il che può migliorare l'esperienza di ricerca e accelerare il processo 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 volere. 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 la 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 basata sulla ricerca cercare eventi.

Per attivare l'apprendimento automatico:

Console

Vai alla pagina Controlli
Vai alla scheda Controlli per il 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 ultimi 180 giorni di eventi utente. 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.

Pianificazione delle release del set di dati con apprendimento automatico

Il set di dati di apprendimento automatico viene generato ogni giorno, poi viene inviato all'indicizzazione e . L'intero ciclo richiede circa due giorni.

Funzionalità di apprendimento automatico

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

Funzionalità	Descrizione	Esempio
Rimuovi i caratteri speciali	Rimuovi i caratteri non standard dai dati dei suggerimenti e 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"
Rimuovi le ricerche con 0 risultati	Rimuovi le query senza risultati di ricerca	Per il negozio di alimentari, "Borse Gucci" ha 0 risultati di ricerca, pertanto viene rimosso
Correggi gli errori di battitura	Correggi l'ortografia delle parole che sono errori di battitura Elimina anche le query di input in tempo reale prima della corrispondenza	"Milc" → "Latte"
Aggiungi query alla lista consentita	Le query che consenti esplicitamente vengono aggiunte	Consulta la sezione Ulteriori informazioni di seguito.
Rimuovere le query dalla lista bloccata	Le query che blocchi esplicitamente vengono rimosse	Consulta la sezione Ulteriori informazioni di seguito.
Rimuovi termini non sicuri	Con Google SafeSearch Rimuovere le query inappropriate	Pornografia, per adulti, volgare, violenza ecc.
Rimuovi 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	"Materasso ad aria doppio a 2 strati 74x39x9 pollici con pompa portatile 120V"
Deduplica i termini	Basato sulla comprensione semantica basata sull'AI Per query quasi identiche termini, ogni termine corrisponderà, ma verrà suggerito solo il più popolare	"Scarpe per donna", "Scarpe da donna" e "Scarpe donna" vengono deduplicati quindi ne verrà suggerito solo uno.

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 ulteriori informazioni, vedi Importa 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	Console Cloud > Controlli
Ordine corrispondente	L'ordine di corrispondenza determina il modo in cui la query dell'utente e i suggerimenti vengono abbinati.	Console Cloud > Controlli
Numero di suggerimenti	Questo è il numero di suggerimenti che verranno restituiti dal completamento automatico	Console Cloud > Controls o Richiesta API: completeQuery.maxSuggestions
Tipo di dispositivo	Quando vengono specificati i tipi di dispositivi, vengono generati i suggerimenti in base alla popolarità dei tipi di dispositivi Non è specificato restituisce suggerimenti basati sulla 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 in quali lingue vuoi utilizzare i suggerimenti	Richiesta API: completeQuery.languageCodes[]

Lista consentita (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 la ricerca ignora durante l'elaborazione.

I termini inclusi nella lista consentita non vengono mai esclusi 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 che contengono intenzionalmente errori di ortografia, ad esempio "froot loop" anziché "frutta" o "piede". Per istruzioni dettagliate sul caricamento, consulta la l'importazione dei dati di completamento.

Per l'importazione dati, puoi utilizzare Console Cloud > Controlli > Controlli del completamento automatico > Non rimuovere elenco o utilizza 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 bloccata 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 Cloud Console > 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 necessari prima delle query con completamento automatico restituirà dei risultati. L'impostazione è disponibile nella console Cloud > Controlli > Controlli del completamento automatico > Lunghezza minima dell'attivazione.

Le modifiche hanno effetto immediato.

Ordine corrispondente

Questo determina come abbinare i suggerimenti ai termini input utente.

Se impostato su "Il suggerimento inizia con il termine", il completamento automatico corrisponde all'utente termine di input 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 di input "scarpe" non corrisponde a questi suggerimenti, nessuna delle parole nei suggerimenti inizia con "scarpe".

L'impostazione è disponibile nella console Cloud > Controlli > Controlli del completamento automatico > Ordine corrispondente.

Le modifiche hanno effetto immediato.

Numero di suggerimenti

Questo è il numero di suggerimenti che verranno restituiti dal completamento automatico e non può superare le 20 query. 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, come 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 dell'utente della rete 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 eseguire una ricerca. Ad esempio, puoi integrare il completamento automatico delle query con altri suggerimenti, come brand e categorie.

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

Set di funzionalità suggerimento

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.

L'insieme di caratteristiche appare nella risposta come mappa chiave-valore. 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 degli insiemi di caratteristiche non devono corrispondere alle stringhe di query da parte dell'utente finale.

Puoi utilizzare il set di caratteristiche 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.
Visualizza il brand o la categoria più popolari accanto ai termini dei suggerimenti 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 gli ultimi 30 giorni di dati sugli eventi di ricerca.

Suggerimenti per gli attributi

La Ricerca fornisce suggerimenti di attributi che corrispondono all'input utente stringhe. I tipi di suggerimenti degli attributi supportati sono brand e categorie.

I suggerimenti per gli attributi sono diversi da un set di caratteristiche suggerimento. Suggerimenti per gli attributi sono elenchi di attributi dei prodotti suggeriti (come brand e categorie), simili a come i suggerimenti per le query sono elenchi di query suggerite. Suggerimenti per gli attributi può essere utilizzato indipendentemente dai suggerimenti per le query. Un FeatureSet suggerimento è metadati per un suggerimento per la query, pertanto dipende dai suggerimenti per le query.

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

Facet di suggerimento con il numero di prodotti (sperimentale)

Si tratta di una funzionalità sperimentale per clienti con limitazioni. Per utilizzarla, contatta il team di assistenza di Google Cloud.

Quando il facet di suggerimento con la funzionalità di conteggio prodotti è abilitata, il completeQuery.completionResults fornisce un elenco di suggerimenti di completamento automatico come di consueto, anche il conteggio dei prodotti per ogni suggerimento con il numero totale e il numero di prodotti per facet (come "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 di interesse facet è "color", un numero di prodotti e un prodotto con ogni suggerimento di Completamento automatico viene restituito anche il conteggio per colore:

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

Come rivenditore, non è necessario presentare il conteggio dei prodotti all'acquirente, ma potresti decidere di ordinare l'elenco dei suggerimenti in base al numero di prodotti invece dell'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 facet ha un FacetValues che contiene numero di prodotti per valore facet. Il numero totale di prodotti per ogni ricerca suggerita la query viene restituita completeQuery.completionResults.totalProductCount.

Per attivare e utilizzare i facet di suggerimento 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 facet vengono calcolate in base all'ultima settimana di dati della cronologia delle ricerche.
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 API CompleteQuery per ottenere 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à entità può restituire suggerimenti di completamento automatico ottimali.