Questa pagina fornisce le best practice per creare le informazioni del catalogo e completarne i dati.
Panoramica
I dati del catalogo che importi in Vertex AI Search per la vendita al dettaglio hanno un effetto diretto sulla qualità del modello risultante e, di conseguenza, sulla qualità dei risultati di ricerca e dei consigli. In generale, più precise e specifiche sono le informazioni del catalogo che puoi fornire, maggiore è la qualità del modello.
Il catalogo deve essere sempre aggiornato. Puoi caricare le modifiche al catalogo tutte le volte che è necessario; idealmente, ogni giorno per i cataloghi con un tasso di variazione elevato. Puoi caricare (eseguire patch) gli elementi di prodotto esistenti; verranno aggiornati solo i campi modificati. Non è previsto alcun costo per il caricamento delle informazioni del catalogo. Per ulteriori informazioni, consulta Mantenere aggiornato il catalogo.
Branch del catalogo
Se utilizzi la ricerca, puoi utilizzare i rami del catalogo per testare i nuovi dati caricati offline prima di pubblicarli sul tuo sito.
Puoi utilizzare fino a tre branche, identificate come
0, 1 e 2. Il tuo sito live rimanda a default_branch per i dati del catalogo. Specifica quale ramo è il tuo default_branch pubblicato (il valore predefinito è impostato su 0) utilizzando setDefaultBranch o la scheda Dati in Search for Retail Console. Il tuo sito utilizza quindi i dati del catalogo forniti dal ramo a cui fa riferimento default_branch.
Ad esempio, supponiamo che default_branch sia impostato sull'ID riga 0, quindi il tuo sito utilizza i dati del catalogo che hai caricato in quella riga. Puoi caricare i nuovi dati del catalogo nel ramo 1 e visualizzarne l'anteprima. Dopo aver confermato
che il catalogo è stato caricato correttamente, puoi passare al ramo 1 come
default_branch pubblicato.
L'aggiornamento della cache del catalogo può richiedere fino a 30 minuti dopo il passaggio da un ramo all'altro.
Se utilizzi i consigli, ti consigliamo di utilizzare solo il ramo predefinito a causa del ritardo nell'aggiornamento durante il passaggio da un ramo all'altro. Se la differenza di dati tra i rami è elevata, il ritardo nell'aggiornamento può influire negativamente sui risultati della previsione.
Prodotti
Il catalogo è una raccolta di oggetti prodotto.
Informazioni obbligatorie sul prodotto
I seguenti campi sono obbligatori; devi fornire i relativi valori quando crei gli articoli di prodotto nel tuo catalogo. Inoltre, devono corrispondere ai valori utilizzati nel database di prodotti interno e riflettere con precisione il prodotto rappresentato, in quanto sono inclusi nell'addestramento dei modelli.
In alcuni casi sono richiesti anche altri campi. Consulta l'elenco completo di tutti i campi del prodotto nella pagina di riferimento Product.
Tutte le informazioni sul prodotto che fornisci possono essere utilizzate per migliorare la qualità dei consigli e dei risultati di ricerca. Assicurati di fornire il maggior numero di campi possibile.
| Campo | Note |
|---|---|
name
|
Il nome completo e univoco della risorsa del prodotto. Obbligatorio per tutti
metodi Product, ad eccezione di import. Durante
l'importazione, il nome viene generato automaticamente e non deve essere fornito manualmente.
|
id
|
L'ID prodotto utilizzato dal tuo database di prodotti. Il campo ID deve essere
univoco nell'intero catalogo. Lo stesso valore viene utilizzato quando
registri un evento utente e viene restituito anche dai metodi predict
e search.
|
title
|
Titolo del prodotto dal tuo database di prodotti. Una stringa codificata UTF-8. Sono consentiti massimo 1250 caratteri. |
categories
|
Categorie di prodotti. Ogni prodotto deve essere assegnato ad almeno una categoria.
Se un prodotto appartiene a più categorie, ripeti il campo per ogni categoria.
Il valore deve essere una stringa con codifica UTF-8 non vuota con un limite di lunghezza di
5000 caratteri. Specifica sempre il percorso completo della categoria, ad esempio:
["Sports & Fitness > Athletic Clothing > Shoes"].
|
Attributi prodotto
Ti consigliamo vivamente di fornire valori per gli attributi di sistema predefiniti in Product, come marca, colore e taglia. Puoi anche includere attributi personalizzati che definisci con Product.attributes.
Campi recuperabili
Se utilizzi la ricerca, gli attributi vengono inclusi con un prodotto
nella risposta di ricerca se li contrassegni come recuperabili in
Product.retrievableFields. che possono essere utilizzati per altre funzionalità di ricerca, come filtri e aspetti.
Opzione con ricerca esatta
Puoi assegnare un determinato valore per query di stringhe specifiche all'opzione Ricerca esatta, un campo dell'attributo del catalogo. Se una query corrisponde a un prodotto nel tuo catalogo in cui il valore per quel campo è la stringa specificata nella query, restituisce esattamente quel prodotto nella query di ricerca. Questa opzione è ideale per i numeri di serie, in cui i clienti si aspettano un'esperienza di ricerca mirata.
Un campo utile per gli attributi dei prodotti con un valore esatto (ad esempio ModelId o ManufacturerId), il campo ExactSearchableOption è in genere riservato agli attributi personalizzati. Attributi come product_id sono campi dell'indice principale, con ricerca esatta per impostazione predefinita. Il campo item_id è sempre attivo per la corrispondenza esatta e non può essere disattivato.
- Per evitare di restituire elementi non correlati nelle ricerche, non impostare mai l'opzione di ricerca su un valore generico come
battery. - Per evitare di sottoutilizzare le query di ricerca, non impostare come disponibili per la ricerca esatta campi speciali come
tag, che potrebbe avere come uno dei suoi valori di stringa "iPhone". In questo modo, le query potrebbero limitare i risultati per tutti gli iPhone nel catalogo dei prodotti.
Per saperne di più, consulta Informazioni sugli attributi del prodotto.
Livelli di prodotto
Le designazioni degli SKU dei prodotti determinano la gerarchia nel tuo catalogo.
Tipi di designazione del prodotto
Esistono tre tipi di designazioni dei prodotti:
Gli elementi principali vengono restituiti nei consigli o nei risultati di ricerca. Gli elementi principali possono essere singoli articoli (a livello di SKU) e gruppi di articoli simili (gruppi di SKU).
Gli articoli Variante sono versioni di un prodotto principale del gruppo SKU. Le varianti possono essere solo articoli singoli (a livello di SKU). Ad esempio, se il prodotto principale è "Camicia a V", le varianti potrebbero essere "Camicia a V marrone, taglia XL" e "Camicia a V bianca, taglia S". A volte gli elementi principali e le varianti sono descritti come elementi principali e secondari.
Gli articoli della raccolta sono set di prodotti principali o varianti dei prodotti, come una parure di gioielli con una collana, orecchini e un anello. Strutture gerarchiche simili a prodotti e varianti, le collezioni raggruppano prodotti principali correlati. I clienti non possono acquistarli direttamente, non sono molto utilizzati e sono disponibili solo nella rete di ricerca.
Esempi di prodotti
Ad esempio, in base a questi tipi di designazione dei prodotti, gli articoli di ipermercato sono meglio catalogati come prodotti principali, ciascuno costituito da un singolo SKU, ad esempio"bananas, fresh".
D'altra parte, le t-shirt sarebbero meglio strutturate in modo gerarchico, come elementi principali con il relativo insieme di varianti. Ogni variante rappresenta un singolo SKU (per ogni taglia) e ogni articolo principale rappresenta un gruppo di SKU, in cui ogni SKU è una taglia diversa per uno stile di t-shirt generale. Questa organizzazione in base alla struttura SKU consente ai risultati di ricerca e ai riquadri dei consigli di mostrare una gamma di stili di t-shirt. Consente allo shopper di visualizzare in dettaglio un determinato elemento principale (stile) per selezionare la variante (taglia) da acquistare.
Le raccolte raggruppano prodotti correlati che un cliente potrebbe acquistare. Per rappresentarli con precisione nel modello di ricoordinamento, Vertex AI Search per il retail ha una logica che li assegna agli acquisti. Ad esempio, uno shopper fa clic sui prodotti di un set di lenzuola, poi aggiunge al carrello o acquista un prodotto principale della collezione. L'acquisto viene accreditato alla collezione e il modello rappresenta con precisione la popolarità e il valore delle collezioni.
Esiste anche un tipo di catalogo solo per le varianti, che ora è deprecato. Questo tipo di catalogo può essere utilizzato solo con i consigli. Per il catalogo solo varianti, ingestionProductType viene impostato su variant durante l'importazione. Per ogni variante viene dedotto un valore principale in base a un ID prodotto principale specificato per ogni variante.
Configurare il catalogo dei prodotti
Quando pianifichi il tuo catalogo dei prodotti, devi decidere se includere prodotti identificati solo come principali, principali e varianti o una combinazione dei due arrangiamenti. Pensa in termini di struttura SKU dei tuoi prodotti. I tuoi prodotti possono essere articoli principali, che possono o meno avere varianti.
In base alla modalità di designazione degli SKU dei prodotti, valuta le opzioni per configurare il catalogo dei prodotti:
- Vuoi che il tuo SKU venga mostrato come singolo risultato di ricerca o consiglio: SKU=primary
- Lo SKU deve far parte di un gruppo di SKU simili: SKU=variant, gruppo di SKU=principale
Una combinazione di entrambe le combinazioni: SKU=principale, SKU=variante, gruppo di SKU=principale
Se nella pagina dei dettagli del prodotto è presente un selettore di opzioni/taglie/colori, in genere queste opzioni vengono caricate come varianti nel catalogo dei prodotti. Valuta se vuoi che tipi diversi dello stesso prodotto con attributi diversi, come taglia e colore, vengano visualizzati come un singolo risultato di ricerca o separati. Ad esempio, per un libro puoi decidere se vuoi che lo SKU con copertina rigida e lo SKU con copertina morbida dello stesso libro vengano visualizzati come risultati di ricerca separati (SKU = principale) o come uno solo (SKU = variante, gruppo di SKU = principale).
Quando configuri il tuo catalogo dei prodotti, tieni presente che i consigli e i risultati di ricerca restituiscono solo gli articoli principali.
Prodotti principali minimi
Se stabilisci che il tuo catalogo debba avere sia elementi principali che varianti, ovvero gruppi di SKU e SKU, ma al momento hai solo SKU, devi creare elementi principali per i gruppi di SKU. Queste elezioni primarie sono a volte chiamate "elezioni primarie virtuali" o "elezioni primarie false".
Questi elementi principali devono contenere solo informazioni minime: id, title e
categories.
Se type non è specificato, il tipo di prodotto predefinito è principale. Se stai
importando, non è necessario specificare name. Per ulteriori informazioni, consulta la sezione precedente Informazioni obbligatorie sul prodotto.
Il tipo è immutabile
Non puoi modificare il tipo di un prodotto, ad esempio da variante a principale o da principale a variante.
Se devi modificare il tipo di un prodotto, eliminalo e rigeneralo con un tipo diverso. Prima di poter eliminare un prodotto primario, devi eliminare le varianti associate.
Importazione del catalogo
Se hai il tuo catalogo in Merchant Center, ti consigliamo di importarlo collegando il tuo account Merchant Center.
Se il tuo catalogo non è in Merchant Center, ma si trova in Cloud Storage, BigQuery o in un altro spazio di archiviazione, esegui un'importazione collettiva dei dati.
Se prevedi di importare i dati del catalogo da Merchant Center in futuro, esamina i dati come descritto per le importazioni di Merchant Center per assicurarti di fare le scelte giuste per il tuo catalogo. Questo è importante perché la modifica della configurazione di un catalogo esistente richiede l'eliminazione del catalogo e il relativo ricaricamento (vedi Modificare la configurazione a livello di prodotto).
Per informazioni dettagliate su come caricare un catalogo, consulta Importare le informazioni del catalogo.
Inventario dei prodotti
L'inventario dei prodotti comprende:
Prezzo, sia corrente che originale
Disponibilità, ad esempio disponibile, non disponibile, ordine arretrato e prenotato
Quantità disponibile
Informazioni sull'evasione degli ordini, come il ritiro in negozio, la spedizione in negozio e la consegna il giorno successivo
Esistono due livelli di inventario: a livello di prodotto e locale.
Inventario a livello di prodotto
Per i rivenditori che vendono solo online, l'inventario viene specificato a livello di prodotto. Il prezzo, la disponibilità e altri dati di inventario sono impostati per ogni prodotto nel catalogo.
Per ulteriori informazioni sull'inventario a livello di prodotto, inclusa la gestione dei dati di inventario, consulta Aggiornare l'inventario per Vertex AI Search per il retail.
Inventario locale
I rivenditori che hanno negozi fisici e un negozio online devono conservare le informazioni sull'inventario su base negozio. A tal fine, utilizzano l'inventario locale.
Esistono due campi dei prodotti che possono essere utilizzati per memorizzare l'inventario locale. Entrambi i campi sono elenchi di località (ID luogo) con informazioni sull'inventario associate:
Product.fulfillmentInfo. Metodi di ritiro e spedizione in ogni punto vendita
Product.localInventories. Informazioni sui prezzi, attributi dei prodotti e metodi di ritiro e spedizione in ogni punto vendita
Puoi utilizzare uno o entrambi i campi per le informazioni a livello di negozio.
Per ulteriori informazioni sugli inventari locali, consulta Aggiornare l'inventario locale per Vertex AI Search per la vendita al dettaglio.
Metriche sulla qualità dei dati del catalogo
La pagina Qualità dei dati nella console Search for Retail valuta se devi aggiornare i dati del catalogo per migliorare la qualità dei risultati di ricerca e sbloccare i livelli di rendimento nella ricerca.
La tabella seguente descrive le metriche di qualità utilizzate da Vertex AI Search per il retail per aiutarti a valutare i dati di prodotto. Per informazioni dettagliate su come visualizzare le metriche sulla qualità dei dati e i livelli di rendimento nella ricerca nella console Search for Retail, consulta Sbloccare i livelli di rendimento nella ricerca.
| Metrica sulla qualità del catalogo | Regola sulla qualità | Note |
|---|---|---|
| L'URI è presente e accessibile | Il prodotto ha un Product.uri valido. L'URI deve essere accessibile e corrispondere al tuo dominio. |
La Ricerca utilizza gli indicatori web sottoposti a scansione utilizzando questo URI per migliorare la qualità della ricerca. |
| Rispetta la conformità temporale | Product.availableTime è precedente all'ora corrente e Product.expireTime è successiva all'ora corrente. |
Solo i prodotti che rispettano la conformità temporale sono disponibili per la ricerca. |
| L'attributo ricercabile è presente | Il prodotto ha almeno un attribute impostato come ricercabile. |
Gli attributi personalizzati contrassegnati come ricercabili possono essere cercati tramite query di testo. |
| La descrizione è presente | Il prodotto ha un valore Product.description non vuoto. |
Una descrizione completa contribuisce a migliorare la qualità della ricerca. |
| Il titolo è costituito da almeno due parole | Product.title è composto da almeno due parole. |
Un titolo esaustivo contribuisce a migliorare la qualità della ricerca. |
| Ha una variante con immagine | Il prodotto variant ha almeno un Product.image. Puoi ignorare questa metrica se tutti i tuoi prodotti sono a livello primary. |
Questa metrica è fornita a scopo informativo e non influisce sulla qualità della ricerca. |
| Ha una variante con informazioni sul prezzo | Per il prodotto variant è impostato Product.priceInfo. Puoi ignorare questa metrica se tutti i tuoi prodotti sono a livello primary. |
Questa metrica è fornita a scopo informativo e non influisce sulla qualità della ricerca. |
Schema del prodotto per Vertex AI Search per il retail
Quando importi un catalogo da BigQuery, utilizza lo schema di prodotto di vendita al dettaglio di Vertex AI Search riportato di seguito per creare una tabella BigQuery con il formato corretto e caricarla con i dati del tuo catalogo. Quindi, importa il catalogo.