Il nome del retail verrà rinominato Vertex AI Search per il retail. Stiamo aggiornando i contenuti per riflettere il nuovo branding.

Informazioni su cataloghi e prodotti

Questa pagina fornisce le best practice per creare informazioni del catalogo e compilare i dati del catalogo.

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 delle ricerche e dei consigli. In generale, più precise e specifiche puoi fornire dal catalogo, migliore sarà la qualità del tuo 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 modifica elevato. Puoi caricare (applicazione di patch) elementi del prodotto esistenti; verranno aggiornati solo i campi modificati. Non è previsto alcun costo per il caricamento delle informazioni del catalogo. Per maggiori informazioni, consulta la pagina Mantenere aggiornato il catalogo.

Rami del catalogo

Se usi la ricerca, puoi usare i rami del catalogo per testare i nuovi dati che hai caricato offline prima di renderli disponibili sul tuo sito.

Puoi utilizzare fino a tre rami, identificati come 0, 1 e 2. Il tuo sito pubblicato rimanda a default_branch per i dati del catalogo. Specifica quale ramo è attualmente il tuo default_branch pubblicato (è impostato sul ramo 0 per impostazione predefinita) utilizzando setDefaultBranch o la scheda Dati nella console Search for Retail. Il sito utilizza quindi i dati di catalogo forniti dalla filiale a cui punta default_branch.

Ad esempio, supponiamo che attualmente default_branch sia impostato sull'ID ramo 0 e che il tuo sito utilizzi i dati di catalogo che hai caricato per quel ramo. Puoi caricare nuovi dati del catalogo nel ramo 1 e visualizzarne l'anteprima. Dopo aver verificato 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 suggerimenti, ti consigliamo di utilizzare solo il ramo predefinito a causa del ritardo di aggiornamento durante il cambio di ramo. Se la differenza di dati tra i rami è elevata, il ritardo di aggiornamento può influire negativamente sui risultati della previsione.

Prodotti

Il catalogo è una raccolta di oggetti di prodotto.

Informazioni sul prodotto obbligatorie

I seguenti campi sono obbligatori. Devi fornire i relativi valori quando crei articoli di prodotto nel catalogo. Devono inoltre corrispondere ai valori utilizzati nel database di prodotti interno e devono rispecchiare con precisione il prodotto rappresentato, poiché sono inclusi nell'addestramento dei modelli.

In alcuni casi, anche altri campi sono obbligatori. Consulta l'elenco completo di tutti i campi dei prodotti nella pagina di riferimento di Product.

Tutte le informazioni sui prodotti che fornisci possono essere utilizzate per migliorare la qualità dei consigli e dei risultati di ricerca. Assicurati di fornire il maggior numero possibile di campi.

Campo	Note
`name`	Il nome completo e univoco della risorsa del prodotto. Obbligatorio per tutti i metodi `Product` tranne `import`. Durante l'importazione, il nome viene generato automaticamente e non deve essere fornito manualmente.
`id`	L'ID prodotto utilizzato dal database dei prodotti. Il campo ID deve essere univoco in tutto il catalogo. Lo stesso valore viene utilizzato quando registri un evento utente e viene restituito anche dai metodi `predict` e `search`.
`title`	Titolo del prodotto proveniente dal database dei prodotti. Una stringa con codifica UTF-8. La lunghezza massima è 1250 caratteri.
`categories`	Categorie di prodotti. Ogni prodotto deve essere assegnato ad almeno una categoria. Se un prodotto appartiene a più di una categoria, 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 del 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.

Se utilizzi la ricerca, gli attributi vengono inclusi con un prodotto nella risposta della ricerca se li contrassegni come recuperabili in Product.retrievableFields. Poi possono essere usate per altre funzionalità dei risultati di ricerca, come filtri e facet.

Per saperne di più, consulta Informazioni sugli attributi del prodotto.

Livelli del prodotto

I livelli di prodotto determinano la gerarchia nel catalogo. In genere, è necessario scegliere tra un catalogo a un livello o un catalogo a due livelli.

Ad esempio, puoi avere un catalogo a un livello in cui ogni articolo ha uno SKU. In alternativa, potresti scegliere un catalogo a due livelli contenente sia gruppi di SKU sia singoli SKU.

Tipi a livello di prodotto

Esistono tre tipi a livello di prodotto:

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

Informazioni sulla gerarchia dei cataloghi

Quando pianifichi la gerarchia del catalogo, devi decidere se contenere solo elementi primari o primari e varianti. Il punto chiave da ricordare è che la previsione e i risultati di ricerca restituiscono solo elementi principali.

Ad esempio, un catalogo solo principale potrebbe essere adatto per la vendita di libri, in cui un riquadro di suggerimenti restituisce una selezione di libri, ciascuno con il proprio SKU. Tuttavia, un catalogo solo principale di t-shirt, probabilmente mostrerà la stessa t-shirt per ogni taglia disponibile nel riquadro dei consigli.

Nel catalogo delle magliette è preferibile avere sia gli SKU principali che le varianti, con gli SKU come varianti (una variante per ogni taglia) e gli SKU principali che rappresentano i gruppi di SKU per le taglie di ogni stile di t-shirt. Questo catalogo a due livelli consente al riquadro dei consigli di mostrare una gamma di stili di t-shirt simili. L'acquirente può visualizzare in dettaglio un particolare (stile) principale per selezionare la variante (taglia) da acquistare.

È disponibile anche un tipo di catalogo solo per varianti, che ora è deprecato. Questo tipo di catalogo può essere utilizzato solo con i suggerimenti. Per il catalogo solo delle varianti, ingestionProductType è impostato su variant durante l'importazione. Viene dedotto un valore principale per ogni variante, in base a un ID prodotto principale specificato per ogni variante.

Prodotti primari minimi

Se stabilisci che il tuo catalogo deve contenere sia varianti primarie sia varianti, ovvero gruppi di SKU e SKU, ma al momento hai solo gli SKU, devi creare principali per i gruppi di SKU. Questi primari sono a volte chiamati "principali virtuali" o "fake primarie".

Questi elementi primari devono contenere solo informazioni minime: id, title e categories.

Se type non è specificato, il tipo di prodotto sarà principale per impostazione predefinita. Se esegui l'importazione, non è necessario specificare name. Per saperne di più, 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 ricrea un prodotto di tipo diverso. Prima di poter eliminare un prodotto principale, è necessario eliminare le varianti associate.

Importazione del catalogo

Se attualmente hai il tuo catalogo in Merchant Center, ti consigliamo di importarlo collegando il tuo account Merchant Center.

Se il catalogo non è in Merchant Center, ma è in Cloud Storage, BigQuery o qualche 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 in Merchant Center per assicurarti di fare le scelte corrette in merito al catalogo. Questo è importante perché la modifica della configurazione di un catalogo esistente richiede l'eliminazione del catalogo e il suo caricamento di nuovo (consulta la pagina 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 quello attuale sia quello originale
Disponibilità, ad esempio disponibile, non disponibile, in arretrato o prenotato
Quantità disponibile
Informazioni sull'evasione degli ordini, ad esempio ritiro in negozio, spedizione in negozio e 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. Per ogni prodotto nel catalogo vengono impostati i dati relativi a prezzo, disponibilità e altri dati di inventario.

Per ulteriori informazioni sull'inventario a livello di prodotto, incluse informazioni su come gestire i dati di inventario, consulta Aggiornare l'inventario per Vertex AI Search per la vendita al dettaglio.

Inventario locale

I rivenditori che hanno negozi fisici e un negozio online devono conservare le informazioni sull'inventario in base al singolo negozio. A questo scopo, utilizza l'inventario locale.

Esistono due campi di prodotto che possono essere utilizzati per archiviare 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 sede del negozio
Product.localInventories. Informazioni sui prezzi, attributi dei prodotti e metodi di ritiro e spedizione in ogni sede del negozio

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 di Search for Retail valuta se devi aggiornare i dati del catalogo per migliorare la qualità dei risultati di ricerca e sbloccare livelli di prestazioni nella ricerca.

La seguente tabella descrive le metriche di qualità utilizzate da Vertex AI Search per la vendita al dettaglio per aiutarti a valutare i dati di prodotto. Per maggiori dettagli su come visualizzare le metriche di qualità dei dati e i livelli di prestazioni della ricerca nella console Search for Retail, vedi Sbloccare i livelli di prestazioni della ricerca.

Metrica della qualità del catalogo	Regola di qualità	Note
L'URI è presente e accessibile	Il prodotto ha un valore `Product.uri` valido. L'URI deve essere accessibile e corrispondere al tuo dominio.	La Ricerca utilizza indicatori web sottoposti a scansione tramite 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	Per il prodotto è presente almeno un elemento `attribute` impostato come disponibile per la ricerca.	È possibile cercare attributi personalizzati contrassegnati come disponibili per la ricerca 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` è costituito 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 di `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 di `primary`.	Questa metrica è a scopo informativo e non influisce sulla qualità della ricerca.

Schema dei prodotti per Vertex AI Search per la vendita al dettaglio

Quando importi un catalogo da BigQuery, utilizza lo schema dei prodotti di Vertex AI Search per la vendita al dettaglio 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 dei prodotti Vertex AI Search per la vendita al dettaglio

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"
      }
    ]
  }
]