Informazioni su cataloghi e prodotti

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. Il caricamento delle informazioni del catalogo non comporta alcun costo. Per ulteriori informazioni, consulta Mantenere aggiornato il catalogo.

Nota: esiste un solo catalogo per progetto Google Cloud. Si chiama default_catalog. Non è necessario creare il catalogo predefinito, poiché è presente per impostazione predefinita.

Rami del catalogo

Avviso: se utilizzi i consigli, ti sconsigliamo di utilizzare più branche del catalogo. Il passaggio da un ramo all'altro può influire negativamente sui risultati della previsione.

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 è attualmente il tuo default_branch pubblicato (il valore predefinito è impostato su 0) utilizzando setDefaultBranch o la scheda Dati nella console Ricerca per la vendita al dettaglio. 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, perché 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 dei prodotti.

Livelli di prodotto

Le designazioni degli SKU dei prodotti determinano la gerarchia nel tuo catalogo.

Tipi di designazione dei prodotti

Esistono tre tipi di designazioni dei prodotti:

1. 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).

2. 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.

3. Gli elementi Raccolta sono raccolte di prodotti. Le raccolte sono pacchetti di prodotti principali o varianti dei prodotti. Ad esempio, una collezione potrebbe essere una parure di gioielli con una collana, orecchini e un anello. Le raccolte sono disponibili solo nella rete di ricerca e non sono molto utilizzate.

Esempi di prodotti

In base a questi tipi di designazione dei prodotti, ad esempio, i prodotti alimentari sono costituiti da prodotti con un solo SKU come "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.

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, vedi 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 della 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 attributo 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 per la ricerca di Vertex AI riportato di seguito per creare una tabella BigQuery con il formato corretto e caricarla con i dati del tuo catalogo. Quindi, importa il catalogo.

Schema del prodotto Vertex AI Search per il retail

BigQuery

[
  {
    "name": "name",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "id",
    "type": "STRING",
    "mode": "REQUIRED"
  },
  {
    "name": "type",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "primaryProductId",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "collectionMemberIds",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "gtin",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "categories",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "title",
    "type": "STRING",
    "mode": "REQUIRED"
  },
  {
    "name": "brands",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "description",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "languageCode",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "attributes",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "key",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "value",
        "type": "RECORD",
        "mode": "NULLABLE",
        "fields": [
          {
            "name": "text",
            "type": "STRING",
            "mode": "REPEATED"
          },
          {
            "name": "numbers",
            "type": "FLOAT",
            "mode": "REPEATED"
          }
        ]
      }
    ]
  },
  {
    "name": "tags",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "priceInfo",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "currencyCode",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "price",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "originalPrice",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "cost",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "priceEffectiveTime",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "priceExpireTime",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "rating",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "ratingCount",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "averageRating",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "ratingHistogram",
        "type": "INTEGER",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "expireTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "ttl",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "seconds",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "nanos",
        "type": "INTEGER",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "availableTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "availability",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "availableQuantity",
    "type": "INTEGER",
    "mode": "NULLABLE"
  },
  {
    "name": "fulfillmentInfo",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "type",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "placeIds",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "uri",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "images",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "uri",
        "type": "STRING",
        "mode": "REQUIRED"
      },
      {
        "name": "height",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "width",
        "type": "INTEGER",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "audience",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "genders",
        "type": "STRING",
        "mode": "REPEATED"
      },
      {
        "name": "ageGroups",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "colorInfo",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "colorFamilies",
        "type": "STRING",
        "mode": "REPEATED"
      },
      {
        "name": "colors",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "sizes",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "materials",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "patterns",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "conditions",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "retrievableFields",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "publishTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "promotions",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "promotionId",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  }
]