Informazioni su cataloghi e prodotti

Questa pagina fornisce le best practice per la creazione delle informazioni del catalogo e il popolamento dei dati del catalogo.

Panoramica

Il catalogo è una raccolta di oggetti prodotto.

I dati del catalogo che importi in Vertex AI Search per il commercio hanno un effetto diretto sulla qualità del modello risultante e, di conseguenza, sulla qualità dei risultati di ricerca e dei suggerimenti. In generale, più accurate e specifiche sono le informazioni del catalogo che fornisci, migliore è la qualità del modello.

Il catalogo deve essere sempre aggiornato. Puoi caricare le modifiche al catalogo tutte le volte che vuoi, idealmente ogni giorno per i cataloghi con un alto tasso di modifica. Puoi caricare (patch) gli articoli di prodotto esistenti; verranno aggiornati solo i campi modificati. Non è previsto alcun costo per il caricamento delle informazioni di catalogo. Per ulteriori informazioni, consulta Mantenere aggiornato il catalogo.

Branch del catalogo

Branch del catalogo con ricerca

Se utilizzi la ricerca, puoi utilizzare i rami del catalogo per testare i nuovi dati che hai caricato offline prima di pubblicarli sul tuo sito.

Puoi utilizzare fino a tre filiali, identificate come 0, 1 e 2. Il tuo sito live punta a default_branch per i dati del catalogo. Specifica quale ramo è il tuo default_branch live (il valore predefinito è impostato sul ramo 0) utilizzando setDefaultBranch o la scheda Dati in Search for commerce console. Il tuo sito utilizza quindi i dati del catalogo forniti dalla filiale a cui punta default_branch.

Ad esempio, supponiamo che default_branch sia impostato sull'ID filiale 0, quindi il tuo sito utilizza i dati del catalogo che hai caricato in quella filiale. Puoi caricare nuovi dati del catalogo nel ramo 1 e visualizzarli in anteprima. Dopo aver confermato che il catalogo è stato caricato correttamente, puoi passare al ramo 1 come default_branch live.

L'aggiornamento della cache del catalogo può richiedere fino a 30 minuti dopo il cambio di ramo.

Se utilizzi i consigli, 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.

Informazioni sul prodotto obbligatorie

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

In alcuni casi, sono richiesti anche altri campi. Consulta l'elenco completo di tutti i campi dei prodotti nella pagina di riferimento 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 di campi possibile.

Categorie del catalogo

Questa sezione descrive la struttura del catalogo e come designarla per l'utilizzo nella tassonomia e nel filtraggio.

Struttura del catalogo

Il campo categories nel catalogo deve contenere il percorso della categoria più granulare per ogni prodotto. Le categorie principali non sono obbligatorie e non devono essere incluse.

Ecco un esempio di come strutturare il catalogo:

• Corretto: categories: ["Flowers, Cards, Occasion > Seasonal Items > Christmas"]
• Errato: categories: ["Flowers, Cards, Occasion", "Flowers, Cards, Occasion > Seasonal Items", "Flowers, Cards, Occasion > Seasonal Items > Christmas"]

Categorie principali

Le categorie principali di un determinato prodotto non devono essere incluse nel campo categories. Il filtro per la navigazione deve essere gestito utilizzando altri attributi personalizzati.

Denominazione delle categorie

I nomi delle categorie devono essere scelti con attenzione per evitare di introdurre parole chiave errate e migliorare il rendimento. L'utilizzo di termini più specifici e accurati migliorerà la pertinenza e ridurrà i problemi.

• Consigliato: Alimenti surgelati > Frutta surgelata
• Non consigliato: Frutta e verdura surgelate > Frutta surgelata

Struttura specifica per progetto a livello di catalogo

Crea un unico catalogo per ogni lingua. Se svolgi la tua attività in più paesi, puoi utilizzare lo stesso catalogo per fornire risultati di ricerca in paesi diversi.

Fornisci prezzi, determinati tramite gli inventari locali, nella stessa valuta in tutti i paesi. Se i prezzi variano in base al paese, crea un inventario locale per ogni paese. Specifica i prezzi.

Per ottimizzare i risultati di ricerca, fornisci il nome di ogni paese come SearchRequest.entity e UserEvent.entity. Utilizza le entità paese solo per il ranking.

Panoramica della gerarchia dei prodotti

Quando gestisci il catalogo prodotti in Vertex AI Search per il commercio, comprendere come vengono gestiti gli attributi per i prodotti principali e le varianti è fondamentale per una ricerca e consigli efficaci. Le designazioni SKU prodotto determinano la gerarchia del catalogo.

Tipi di designazione del prodotto

Esistono tre tipi di designazione del prodotto:

1. Gli elementi principali o genitori vengono restituiti nei risultati di ricerca o nei consigli e fungono da contenitori logici o gruppi di elementi simili. I prodotti principali possono essere singoli articoli (a livello di SKU) e gruppi di articoli simili (gruppi di SKU).

2. Gli articoli varianti o secondari sono versioni specifiche e individuali di un prodotto principale di un gruppo di SKU. Ad esempio, se il prodotto principale è una camicia con scollo a V,le varianti potrebbero essere camicia con scollo a V marrone, taglia XL e camicia con scollo a V bianca, taglia S.

3. Gli articoli raccolta sono set di prodotti principali o varianti dei prodotti, ad esempio una parure di gioielli con collana, orecchini e anello. Strutture gerarchiche simili a prodotti e varianti, le raccolte raggruppano i prodotti principali correlati. I clienti non possono acquistarli direttamente, non sono ampiamente utilizzati e sono disponibili solo nella rete di ricerca.

Esempi di prodotti

Ad esempio, in base a questi tipi di designazione del prodotto, i prodotti alimentari vengono catalogati meglio come prodotti principali, ciascuno costituito da un singolo prodotto SKU, ad esempio"bananas, fresh".

D'altra parte, le t-shirt sarebbero strutturate meglio in modo gerarchico, come primari con il relativo insieme di varianti. Ogni variante rappresenta un singolo SKU (per ogni taglia) e ogni articolo principale rappresenta un gruppo di SKU, dove ogni SKU è una taglia diversa per uno stile di t-shirt generale. Questa organizzazione per struttura SKU consente ai risultati di ricerca e ai riquadri dei consigli di mostrare una gamma di stili di t-shirt. Consente all'acquirente di esaminare in dettaglio uno stile principale specifico per selezionare la variante (taglia) da acquistare.

Le raccolte raggruppano i prodotti correlati che un cliente potrebbe acquistare. Per rappresentarli in modo accurato nel modello di riposizionamento, Vertex AI Search per il commercio ha una logica che attribuisce loro gli acquisti. Ad esempio, un acquirente fa clic sui prodotti di un set di lenzuola, quindi aggiunge al carrello o acquista un prodotto principale della raccolta. La raccolta viene accreditata con l'acquisto e il modello rappresenta accuratamente la popolarità e il valore delle raccolte.

Esiste anche un tipo di catalogo solo per le varianti, ora ritirato. Questo tipo di catalogo può essere utilizzato solo con i consigli. Per il catalogo solo varianti, ingestionProductType è impostato su variant durante l'importazione. Viene dedotto un prodotto principale per ogni variante in base a un ID prodotto principale specificato per ogni variante.

Configurare il catalogo dei prodotti

Quando pianifichi il catalogo prodotti, devi decidere se contiene prodotti designati solo come principali, principali e varianti o un mix dei due tipi. Consideralo in termini di struttura dello SKU dei tuoi prodotti. I tuoi prodotti possono essere articoli principali, che possono avere o meno varianti.

In base alla modalità di designazione delle SKU prodotto, 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
• Il tuo 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 viene visualizzato un selettore di opzioni, taglie o colori, queste opzioni vengono in genere caricate come varianti nel catalogo prodotti. Valuta se vuoi che diversi tipi dello stesso prodotto con attributi diversi, come taglia e colore, vengano visualizzati come un unico risultato di ricerca o come risultati separati. Ad esempio, per un libro devi decidere se vuoi che uno SKU con copertina rigida e uno SKU con copertina morbida dello stesso libro vengano visualizzati come risultati di ricerca separati (SKU = principale) o come un unico risultato (SKU = variante, gruppo di SKU = principale).

Quando configuri il catalogo dei prodotti, tieni presente che i risultati di ricerca e i consigli restituiscono solo gli articoli principali.

Prodotti principali minimi

Se determini che il tuo catalogo deve avere sia primari che varianti, ovvero gruppi di SKU e SKU, ma al momento hai solo SKU, devi creare i primari per i gruppi di SKU. Queste primarie sono talvolta chiamate primarie virtuali o false primarie.

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 maggiori informazioni, consulta la sezione precedente, Informazioni sul prodotto richieste.

Importazione del catalogo

Se il catalogo si trova in Cloud Storage, BigQuery o un altro spazio di archiviazione, esegui un'importazione collettiva dei dati.

Per informazioni dettagliate su come caricare un catalogo, vedi Importare le informazioni del catalogo.

Inventario dei prodotti

L'inventario dei prodotti comprende:

• Prezzo, sia quello attuale che quello originale

• Disponibilità, ad esempio disponibile, non disponibile, ordine arretrato e preordine

• Quantità disponibile

• Informazioni sull'evasione dell'ordine, 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 è specificato a livello di prodotto. Prezzo, disponibilità e altri dati di inventario sono impostati per ogni prodotto del catalogo.

Per ulteriori informazioni sull'inventario a livello di prodotto, incluso come gestire i dati di inventario, consulta Aggiornare l'inventario per Vertex AI Search per il commercio.

Inventario locale

I rivenditori che hanno negozi fisici e un negozio online devono conservare le informazioni sull'inventario per ogni negozio. A questo scopo, utilizzano l'inventario locale.

Esistono due campi 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 in ogni sede del negozio

• Product.localInventories. Informazioni sui prezzi, attributi del prodotto 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 for commerce.

Struttura dell'inventario principale-variante

La struttura dei dati di inventario delle varianti principali è composta da prodotti principali, varianti e inventario locale:

• Prodotti principali: i dati dei prodotti principali vengono memorizzati senza prezzi.

• Prodotti con varianti (con il prezzo più basso nel paese): ad esempio, la variante per il prodotto principale (colore, taglia) deve avere il prezzo più basso nel paese. I dati di prezzo delle varianti vengono aggregati ai dati di prodotto principali, il cui prezzo principale viene utilizzato a sua volta per il ranking. I prezzi specifici per località vengono ignorati.

• Inventario locale (prezzi specifici per regione o negozio): utilizza le informazioni sui prezzi dell'inventario locale per il ranking al momento della pubblicazione

• Attributi del prodotto principale: i prodotti principali devono includere solo gli attributi comuni a tutte le varianti associate.

Metriche di qualità dei dati del catalogo

La pagina Qualità dei dati nella console Search for commerce valuta se devi aggiornare i dati del catalogo per migliorare la qualità dei risultati di ricerca e sbloccare i livelli di rendimento della ricerca.

La tabella seguente descrive le metriche di qualità che Vertex AI Search per il commercio utilizza 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 della ricerca nella console Search for commerce, consulta Sbloccare i livelli di rendimento della ricerca.

Schema prodotto

Quando importi un catalogo da BigQuery, utilizza lo schema del prodotto Vertex AI Search for commerce per creare una tabella BigQuery con il formato corretto e caricarla con i dati del catalogo. Quindi, importa il catalogo.

[
  {
    "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": "publishTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "promotions",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "promotionId",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  }
]