La funzionalità Retail verrà rinominata in Vertex AI Search for Retail. Stiamo aggiornando i contenuti in base al nuovo branding.

Questa pagina è stata tradotta dall'API Cloud Translation.

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 secondo necessità; idealmente, ogni giorno per i cataloghi con un tasso di modifica elevato. Puoi caricare (applicare patch) agli articoli di prodotto esistenti; verranno aggiornati solo i campi modificati. Non è previsto alcun costo per il caricamento delle informazioni di catalogo. Per ulteriori informazioni, vedi Mantieni aggiornato il catalogo.

Rami 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 attivo rimanda a default_branch per i dati del catalogo. Specifica quale ramo è attualmente il tuo default_branch attivo (l'impostazione predefinita è ramo 0) utilizzando setDefaultBranch o la scheda Dati Cerca la console Retail. 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 cambio di ramo.

Se utilizzi i consigli, ti consigliamo di usare solo quello predefinito ramo a causa del ritardo di aggiornamento durante il cambio di ramo. Se la differenza di dati tra i rami è grande, il ritardo nell'aggiornamento può influire negativamente sulla previsione che consentono di analizzare i dati e visualizzare i risultati.

Prodotti

Il catalogo è una raccolta di oggetti prodotto.

Informazioni obbligatorie sul prodotto

I campi riportati di seguito 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, anche altri campi sono obbligatori. 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 il nome viene generato automaticamente e non deve essere forniti manualmente.
`id`	L'ID prodotto utilizzato dal database dei prodotti. Il campo ID deve essere unici nell'intero catalogo. Lo stesso valore viene utilizzato quando registra un evento utente e viene restituito anche dall'`predict` e `search`.
`title`	Titolo del prodotto presente nel database dei 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

Specifica dei valori per gli attributi di sistema predefiniti in Product come marca, colore e taglia. Puoi anche includere che hai definito con Product.attributes.

Se utilizzi la ricerca, gli attributi vengono inclusi con un prodotto nella risposta di ricerca se li contrassegni come recuperabili in Product.retrievableFields. Possono quindi essere utilizzati per altre funzionalità di ricerca, come filtri e facet.

Per saperne di più, vedi Informazioni sugli attributi dei prodotti.

Livelli dei prodotti

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

Tipi di designazione dei prodotti

Esistono tre tipi di designazione dei prodotti:

Gli elementi principali vengono restituiti nei consigli o nei risultati di ricerca. I valori primari possono essere singoli elementi e gruppi (a livello di SKU) di articoli simili (gruppi di SKU).
Le varianti sono le versioni di un prodotto principale del gruppo di SKU. Le varianti possono essere solo articoli singoli (a livello di SKU). Ad esempio, se il prodotto principale è "Camicia con scollo a V", le varianti potrebbero essere "Camicia marrone con scollo a V, taglia XL" e "White Camicia con scollo a V, taglia S". A volte gli elementi principali e le varianti sono descritti come elementi principali e secondari.
Gli elementi della raccolta sono raccolte di prodotti. Le raccolte sono pacchetti di prodotti principali o varianti di prodotti. Ad esempio, una collezione potrebbe essere una parure di gioielli con collana, orecchini e anello. Le raccolte sono disponibili nella ricerca e non sono ampiamente utilizzate.

Esempi di prodotti

In base a questi tipi di designazione dei prodotti, i generi alimentari, ad esempio, saranno costituiti da prodotti con un unico SKU come "bananas, fresh".

D'altra parte, le t-shirt avrebbero una struttura gerarchica migliore, come le magliette con il corrispondente set 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. L'organizzazione per struttura di SKU consente ai risultati di ricerca e ai riquadri dei suggerimenti di mostrare una serie di stili di magliette. Consente all'acquirente di visualizzare in dettaglio un determinato stile principale 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=variante, 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 primari minimi

Se stabilisci che il tuo catalogo deve avere sia primarie che varianti, gruppi di SKU e SKU, ma al momento hai solo SKU, devi creare 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 è impostato su principale per impostazione predefinita. Se stai importando, non è necessario specificare name. Per ulteriori informazioni, vedi nella sezione precedente, Informazioni sul prodotto obbligatorie.

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 il tuo catalogo è presente in Merchant Center, consigliamo di importare il catalogo collegando il tuo Account Merchant Center.

Se il tuo catalogo non è in Merchant Center, ma è in Cloud Storage, BigQuery o altri tipi di archiviazione, esegui un'importazione collettiva dei dati.

Se prevedi di importare i dati del catalogo da Merchant Center nella esamina i dati come descritto per le importazioni di Merchant Center per assicurarti di fare le scelte corrette in merito al tuo catalogo. È importante poiché la modifica della configurazione di un catalogo esistente richiede l'eliminazione catalogo e caricarlo nuovamente (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. Prezzo, disponibilità e altri dati di inventario sono impostati per ogni prodotto nella 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 questo scopo, utilizza l'inventario locale.

Esistono due campi del prodotto 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 su di ogni sede del negozio
Product.localInventories. Informazioni sui prezzi, attributi dei prodotti e metodi di ritiro e spedizione in ogni punto vendita

Per le informazioni a livello di negozio puoi utilizzare uno o entrambi i campi.

Per scoprire di più sugli inventari locali, consulta l'articolo Aggiornare l'inventario locale per Vertex AI Search for Retail.

Metriche sulla qualità dei dati del catalogo

La pagina Qualità dei dati nella sezione Search for Retail Console valuta se è necessario eseguire un aggiornamento di cataloghi per migliorare la qualità dei risultati di ricerca e sbloccare dei livelli di prestazioni della 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 maggiori dettagli su come visualizzare la qualità dei dati le metriche e i livelli di prestazioni della ricerca nella console di Search for Retail consulta l'articolo Sbloccare i livelli di rendimento della 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 soddisfano la conformità temporale sono disponibili per la ricerca.
L'attributo ricercabile è presente	Almeno un elemento `attribute` del prodotto è impostato come disponibile per la ricerca.	Gli attributi personalizzati contrassegnati come ricercabili possono essere cercati tramite query di testo.
La descrizione è presente	Il campo `Product.description` del prodotto 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 completo 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 è a scopo informativo e non influisce sulla qualità della ricerca.
Ha una variante con informazioni sul prezzo	Per il prodotto `variant` è stato 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 dei prodotti per Vertex AI Search for Retail

Quando importi un catalogo da BigQuery, utilizza Schema del prodotto Vertex AI Search for Retail per creare una tabella BigQuery con il formato corretto e caricarli con i dati di catalogo. Quindi, importa il catalogo.

Schema del prodotto Vertex AI Search for 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"
      }
    ]
  }
]