Completamento automatico per la ricerca

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

Il completamento automatico è una funzionalità che prevede il resto di una query inserita da un utente, che può migliorare l'esperienza di ricerca dell'utente e accelerare il processo di acquisto prima del pagamento. Può anche migliorare la qualità della risposta 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 magliette potrebbero essere suggeriti quando l'utente inserisce sc.

Origine dati

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

• 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 di BigQuery che carichi come set di dati, utilizzata per suggerire query. Per informazioni su come caricare un set di dati, consulta Importare 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 Cloud

1. Vai alla pagina Controlli

2. Vai alla scheda Controlli di completamento automatico.

3. Fai clic su Modifica impostazioni.

4. Attiva l'apprendimento automatico.

5. 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 per il set di dati di apprendimento automatico

L'apprendimento automatico genera suggerimenti dagli eventi utente di tipo ricerca (eventType = "search"). 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 ricerca è troppo piccola (meno di 20.000), molti candidati di suggerimento potrebbero essere filtrati. In questo scenario, potresti voler testare prima la funzione di completamento automatico con una query di ricerca più frequente.

Programma delle pubblicazioni del set di dati di apprendimento automatico

Il set di dati di apprendimento automatico viene generato quotidianamente, quindi viene inviato all'indicizzazione e al rilascio. L'intero ciclo richiede circa due giorni.

Funzionalità di apprendimento automatico

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

Funzionalità	Descrizione	Esempio
Rimuovi le ricerche con 0 risultati	Rimuovi le query che non hanno risultati di ricerca.	Per il rivenditore di generi alimentari, borse Gucci ha 0 risultati di ricerca, quindi viene rimosso.
Correggi gli errori di battitura	Correggi l'ortografia delle parole che contengono errori di battitura. Pulisci anche le query di input in tempo reale prima della corrispondenza.	Milc → Latte
Aggiungi query alla lista consentita	Vengono aggiunte le query che consenti esplicitamente.	Consulta la sezione Ulteriori informazioni
Rimuovi le query dalla lista bloccata	Vengono rimosse le query che blocchi esplicitamente.	Consulta la sezione Ulteriori informazioni
Rimuovi i termini non sicuri	Utilizza la Ricerca Google SafeSearch. Rimuovi le query inappropriate.	Contenuti pornografici, osé, volgari o violenti
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 matrimoniale a 2 strati da 74x39x9 pollici con pompa portatile da 120 V.
Deduplica i termini	Basato sulla comprensione semantica basata sull'AI Per i termini quasi identici, verrà trovata una corrispondenza con entrambi i termini, ma verrà suggerito solo quello più popolare.	Scarpe da donna, scarpe da donna, e scarpe da donna vengono deduplicate, quindi ne verrà suggerita solo una.

Visualizza i 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"

Implementa il filtro sui risultati dei suggerimenti

Quando utilizzi il set di dati cloud-retail, AI Commerce Search può restituire gli attributi corrispondenti, come brand e categorie popolari, insieme ai suggerimenti di testo standard. Puoi utilizzare questi attributeResults per arricchire l'UI di completamento automatico e consentire agli utenti di selezionare un percorso di ricerca prefiltrato.

Ad esempio, se un utente digita sca, puoi visualizzare il suggerimento di query scarpe insieme a un suggerimento di filtro categorizzato come in Nike o in Scarpe da donna.

Esempio di risposta di completamento automatico con attributi filtrabili

{
  "completionResults": [
    {
      "suggestion": "shoe",
      "attributes": {}
    }
  ],
  "attributeResults": {
    "brands": {
      "suggestions": ["Nike", "Adidas"]
    },
    "categories": {
      "suggestions": ["Shoes", "Women's Shoes"]
    }
  }
}

Quando un utente seleziona uno di questi suggerimenti arricchiti con attributi (ad esempio scarpe in Nike), l'applicazione deve acquisire sia la query (scarpe) sia l'attributo (Nike) da applicare come filtro nella chiamata successiva all'API Search principale.

• (Facoltativo) Filtrare i suggerimenti stessi: se devi filtrare o bloccare completamente la visualizzazione di frasi specifiche nei risultati dei suggerimenti di completamento automatico, puoi importare un set di dati denylist. In questo modo puoi applicare un operatore EXACT_MATCH o CONTAINS per impedire che le frasi indesiderate vengano suggerite all'utente.

Opzioni e controlli di completamento automatico

Questa sezione spiega le opzioni e i controlli disponibili per il completamento automatico. Consulta una panoramica nella tabella seguente e ulteriori dettagli.

Controllo	Dettagli	Località
Lista bloccata	Rimuove manualmente le query dai dati dei suggerimenti.	Richiesta API: CompletionData:import. Per ulteriori informazioni, consulta Importare dati di completamento automatico.
Lista consentita	Aggiunge manualmente le query ai dati dei suggerimenti.	Richiesta API: CompletionData:import (vedi anche Importare dati di completamento automatico )
Lunghezza minima per attivare il completamento automatico	Controlla il numero di caratteri prima che venga attivato il completamento automatico.	Google Cloud console > Controlli
Ordine corrispondente	L'ordine corrispondente determina la modalità di corrispondenza tra la query dell'utente e i suggerimenti.	Google Cloud console > Controlli
Numero di suggerimenti	Questo è il numero di suggerimenti che verranno restituiti dal completamento automatico.	Google Cloud console > Controlli o Richiesta API: completeQuery.maxSuggestions
Tipo di dispositivo	Quando vengono specificati i tipi di dispositivo, i suggerimenti vengono generati in base alla popolarità dei tipi di dispositivo indicati. Se non viene specificato, vengono restituiti suggerimenti basati sulla popolarità combinata di tutti i tipi di dispositivo.	Richiesta API: completeQuery.deviceType
Origine dati dei suggerimenti	Se hai origini dati generate automaticamente e caricate, puoi scegliere quale utilizzare al momento della query.	Richiesta API: completeQuery.dataset
Lingua	Puoi specificare la lingua o le lingue in cui sono presenti i suggerimenti.	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 ignora durante la post-elaborazione.

I termini consentiti 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 con errori di ortografia intenzionali, ad esempio "froot loops" anziché "fruit" o "foot". Consulta le istruzioni dettagliate per il caricamento in Importare dati di completamento.

Per l'importazione dei dati, puoi utilizzare Google Cloud console > Controlli > Controlli di completamento automatico > Elenco delle query da non rimuovere oppure utilizzare CompletionData:import nell'API.

Le modifiche diventano effettive in 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 Google Cloud console > Controlli > Controlli di completamento automatico > Lista bloccata oppure utilizzare l'API CompletionData:import. Per istruzioni dettagliate su come importare una lista bloccata, consulta Importare dati di completamento.

Le modifiche diventano effettive in circa 2 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 nella Google Cloud console > Controlli > Controlli di completamento automatico > Lunghezza minima per l'attivazione.

Le modifiche hanno effetto immediato.

Ordine corrispondente

Determina la modalità di corrispondenza tra i suggerimenti e i termini di input utente.

Se l'opzione è impostata su Il suggerimento inizia con il termine, il completamento automatico fa corrispondere il termine di input dell'utente come prefisso esatto ai suggerimenti. Ad esempio, l'input utente "sc" corrisponde ai suggerimenti "scarpe" e "magliette", ma non al suggerimento "scarpe rosse".

Se l'opzione è impostata su Il suggerimento può iniziare in qualsiasi punto del termine, il completamento automatico suddivide il termine di input utente in parole e lo fa corrispondere alle parole nei suggerimenti, indipendentemente dall'ordine delle parole. Ad esempio, il termine di input utente "scarpe rosse" corrisponde ai suggerimenti "magliette rosse", "scarpe rosse" e "scarpe rosse per bambini". Tuttavia, il termine di input "scarpe" non corrisponde a questi suggerimenti, perché nessuna delle parole nei suggerimenti inizia con "scarpe".

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

Le modifiche hanno effetto immediato.

Numero di suggerimenti

Questo è il numero di suggerimenti che verranno restituiti dalle query con completamento automatico e non può superare 20. L'impostazione è disponibile su Google 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 dispositivo, come mobile e desktop. Puoi caricare o ricevere suggerimenti diversi in base ai tipi di dispositivo. Se deviceType non è specificato in completeQuery, il suggerimento sarà valido per tutti i tipi di dispositivo.

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 dispositivo. Consulta User agent nel 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.

FeatureSet di suggerimenti

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

Il FeatureSet viene visualizzato nella risposta come una mappa chiave-valore. AI Commerce Search restituisce fino a cinque categorie e brand popolari correlati a ogni suggerimento di query nella completeQuery.completionResults.attributes risposta API. I suggerimenti di FeatureSet non devono necessariamente corrispondere alle stringhe di query inserite dall'utente finale.

Puoi utilizzare il 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.
• Visualizza il brand o la categoria più popolare accanto ai termini dei suggerimenti di ricerca.

Dopo aver apportato modifiche al catalogo, ad esempio modificando le categorie dei prodotti, prevedi di attendere da due settimane a 30 giorni prima che i suggerimenti di FeatureSet riflettano le modifiche del 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 per gli attributi che corrispondono alle stringhe di input utente. I tipi di suggerimenti per gli attributi supportati sono brand 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), in modo simile a come i suggerimenti di query sono elenchi di query suggerite. I suggerimenti per gli attributi possono essere utilizzati indipendentemente dai suggerimenti di query. Un FeatureSet di suggerimenti è un metadato per un suggerimento di query e quindi dipende dai suggerimenti di query.

Per attivare i suggerimenti per gli attributi, applica una patch a completionConfig impostando enableAttributeSuggestions su true.

cURL

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
"https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/completionConfig?updateMask=enable_attribute_suggestions" \
-d '{ "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/completionConfig", "enableAttributeSuggestions": "true" }'

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. I risultati vengono restituiti nel campo attributeResults della risposta completeQuery, come illustrato in questo esempio che utilizza le chiavi brands e categories:

cURL

{
"completionResults": [
{
  "suggestion": "shoe",
  "attributes": {}
}
],
"attributionToken": "example_attribution_token",
"attributeResults": {
"brands": {
  "suggestions": [
    "Nike",
    "Adidas"
  ]
},
"categories": {
  "suggestions": [
    "Shoes",
    "Men's Shoes"
  ]
}
}
}

Facet di suggerimenti con conteggi dei prodotti

Quando la funzionalità del facet di suggerimenti con 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 ogni suggerimento con il conteggio totale e il conteggio dei prodotti per facet (ad esempio color, category).

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

• scarpe da donna
• scarpe da uomo

Inoltre, se la chiave del facet di interesse è color, viene restituito anche un conteggio dei prodotti e un conteggio dei prodotti per colore con ogni suggerimento di completamento automatico:

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

In qualità di rivenditore, non devi presentare 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 guardare le 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 facet ha un FacetValues elenco che contiene il conteggio dei prodotti per valore del facet. Il conteggio totale dei prodotti per ogni suggerimento di ricerca query viene restituito in completeQuery.completionResults.totalProductCount.

Per attivare e utilizzare i facet di suggerimenti con conteggi dei prodotti, per almeno sette giorni, assicurati di includere la chiave del facet in FacetSpecs e search.searchRequest.facetSpecs quando utilizzi l'API search. Specifica per quali FacetKeys vuoi i conteggi dei prodotti. Sono consentiti solo i facet textual_fields.

Questo tempo di attesa è dovuto al fatto che le informazioni sui facet vengono calcolate utilizzando i dati delle cronologie di ricerca dell'ultima settimana.

I suggerimenti restituiti dell'API completeQuery contengono i conteggi 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à potrebbe essere un sito web per un brand o una regione diversa. Il completamento automatico deve riflettere al meglio il comportamento degli utenti che acquistano quel particolare brand o sito web regionale. Per ulteriori informazioni sulle entità, consulta Entità.

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

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 di oggetto completo per l'evento utente di 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 essere una corrispondenza esatta. 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 stringa 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 degli eventi utente prima che la funzionalità delle entità possa restituire suggerimenti di completamento automatico ottimali.