Informazioni sugli attributi del prodotto

Vertex AI Search for commerce può utilizzare gli attributi del prodotto per l'indicizzazione, il faceting dinamico, la ricercabilità, il filtraggio e la qualità del modello. Questa pagina illustra l'impostazione delle configurazioni degli attributi di prodotto e il modo in cui vengono trattati a seconda del metodo e della configurazione utilizzati.

Tipi di attributi

Gli attributi prodotto possono avere impostazioni predefinite e opzioni consentite diverse a seconda del tipo.

  • Attributi di sistema: gli attributi di sistema predefiniti sono campi Product esistenti che forniscono maggiori informazioni sul prodotto. Questi includono attributi del prodotto come brand, disponibilità, colore e taglia. Per tutti gli attributi di sistema disponibili per i prodotti, consulta la documentazione di riferimento di Product.

  • Attributi personalizzati: gli attributi personalizzati sono attributi aggiuntivi che definisci utilizzando il campo Product.attributes. Ad esempio, potrebbero essere inclusi nomi di negozi, fornitori o stili. Per esempi e limiti degli attributi personalizzati, consulta la documentazione di riferimento Product.attributes.

    Alcuni esempi dei 20 attributi personalizzati più utilizzati sono:

    • Linea di prodotti a cui appartiene questo prodotto
    • Volume delle vendite in negozio per questo prodotto
    • Occasione per l'abbigliamento
    • Offerte e coupon applicabili a questo prodotto
    • Popolarità del prodotto a livello di sito

  • Attributi a livello di inventario: attributi di sistema o personalizzati che forniscono informazioni a livello di negozio sul prodotto. Potresti utilizzare gli attributi a livello di inventario per i prodotti le cui proprietà variano in modo significativo tra negozi e regioni, ad esempio i prodotti alimentari, o per i prodotti che hanno promozioni specifiche per il negozio.

    inventories.price e inventories.originalPrice sono attributi numerici di sistema predefiniti da Vertex AI Search per il commercio. Puoi creare attributi personalizzati a livello di inventario, che possono essere testuali o numerici. Gli attributi a livello di inventario sono indicizzabili per impostazione predefinita. L'impostazione della suddivisione dinamica in facet e della ricerca non è supportata per gli attributi a livello di inventario.

Impostazioni di configurazione disponibili

Le impostazioni di configurazione degli attributi influiscono sul comportamento di ricerca e suggerimenti nel sito.

La ricerca utilizza le seguenti impostazioni degli attributi:

  • Indicizzabile: la ricerca può filtrare e applicare facet utilizzando questo attributo.
  • Faceting dinamico: la ricerca può utilizzare automaticamente questo attributo come facet dinamico in base al comportamento passato degli utenti, ad esempio clic e visualizzazioni dei facet. Per attivare il faceting dinamico per un attributo, Indicizzabile deve essere impostato su true per l'attributo in questione.
  • Ricercabile: questo attributo è ricercabile tramite query di ricerca, il che aumenta il richiamo per quell'attributo. Questo controllo è applicabile solo agli attributi di testo.
  • Recuperabile: se impostato su true, la ricerca restituisce questo attributo nelle risposte alle query di ricerca. Se tutti gli attributi hanno Recuperabile impostato su false, i risultati di ricerca contengono solo il nome del prodotto o (per le varianti) il nome del prodotto e le informazioni sul colore. Il campo REST RetrievableFields è ritirato per i prodotti. Utilizza invece il controllo recuperabile a livello di sito.

I suggerimenti utilizzano le seguenti impostazioni degli attributi:

  • Filtrabile (anteprima pubblica): questo attributo può essere utilizzato nelle espressioni di filtro dei suggerimenti. Questo controllo è applicabile solo agli attributi di testo.

Indicizzabile

Se un attributo è impostato su indicizzabile, la ricerca può filtrare e applicare facet utilizzando l'attributo.

  • Attributi di sistema: l'indicizzazione è sempre attivata per gli attributi di sistema predefiniti. Questa impostazione non può essere disattivata per gli attributi di sistema.
  • Attributi personalizzati: abilitati per impostazione predefinita. Puoi disattivare l'indicizzazione per qualsiasi attributo personalizzato. Se prevedi di rendere indicizzabile un attributo personalizzato, questo deve seguire il pattern di espressione regolare [a-zA-Z0-9][a-zA-Z0-9_]*. Ad esempio, key0LikeThis o KEY_1_LIKE_THIS.
  • Attributi a livello di inventario: sempre abilitati per gli attributi a livello di inventario di sistema; questa impostazione non può essere modificata. Attivata per impostazione predefinita per gli attributi personalizzati a livello di inventario; questa impostazione può essere disattivata.
  • Dipendenze: N/A

Le modifiche alla configurazione dell'indice diventano effettive immediatamente dopo l'importazione dei dati del catalogo. In caso contrario, l'applicazione delle modifiche potrebbe richiedere fino a 12 ore o più. Puoi verificare se le modifiche sono state applicate nella pagina Valuta.

Faceting dinamico

Quando il faceting dinamico è attivato per un attributo, la ricerca può utilizzare l'attributo come facet dinamico. Le sfaccettature dinamiche possono essere aggiunte automaticamente a una ricerca in base al comportamento passato degli utenti, ad esempio clic e visualizzazioni delle sfaccettature.

  • Attributi di sistema: attivati per impostazione predefinita se l'indicizzazione è impostata su true. Puoi disattivare il faceting dinamico per qualsiasi attributo di sistema.
  • Attributi personalizzati: attivati per impostazione predefinita se l'indicizzazione è impostata su true. Puoi disattivare il faceting dinamico per qualsiasi attributo personalizzato.
  • Attributi a livello di inventario: non supportati.
  • Dipendenze: per attivare il faceting dinamico per un attributo, devi prima attivare l'indicizzazione per quell'attributo.

L'impostazione del faceting dinamico per un attributo è sempre globale. La configurazione del faceting dinamico che applichi a quell'attributo viene utilizzata dai prodotti del catalogo che utilizzano quell'attributo.

Le modifiche alla configurazione del faceting dinamico richiedono fino a due giorni. Puoi verificare se le modifiche sono state applicate nella pagina Valuta.

Per gli attributi personalizzati numerici, i bucket devono essere specificati nella richiesta. I valori numerici non vengono raggruppati automaticamente.

Disponibile per la ricerca

Se un attributo è impostato su ricercabile, il richiamo di questo attributo nelle query di ricerca viene migliorato.

Solo i valori degli attributi testuali possono avere la funzionalità di ricerca abilitata. Non è applicabile agli attributi numerici.

  • Attributi di sistema: gli attributi di sistema testuali predefiniti per Product hanno le impostazioni di ricerca configurate da Vertex AI Search for Commerce. Questa impostazione non può essere modificata.
  • Attributi personalizzati: disattivati per impostazione predefinita. Puoi attivare questa configurazione per qualsiasi attributo personalizzato di tipo testuale.
  • Attributi a livello di inventario: non supportati.
  • Dipendenze: N/A
  • Ricerca esatta: i risultati della ricerca mirata per le query di ricerca corrispondono a un determinato prodotto del catalogo. Questa opzione è ideale per i numeri di serie. Scopri di più sull'opzione di ricerca esatta.

Sebbene i prodotti con un attributo ricercabile abbiano maggiori probabilità di essere visualizzati nei risultati di ricerca per quell'attributo, non è garantito che vengano visualizzati.

Filtro dei consigli

Se il filtro dei suggerimenti è attivato per un attributo, questo può essere utilizzato nelle espressioni di filtro dei suggerimenti per filtrare i prodotti nelle previsioni.

  • Attributi di sistema: disattivati per impostazione predefinita. Puoi attivare questa impostazione per qualsiasi attributo di testo di sistema predefinito per Product, ad eccezione di FulfillmentInfo e title. Non supportato per gli attributi numerici.
  • Attributi personalizzati: disattivati per impostazione predefinita. Puoi attivare questa impostazione per qualsiasi attributo di testo personalizzato per Product. Non supportato per gli attributi numerici.
  • Attributi a livello di inventario: supportati solo per il valore availability IN_STOCK.
  • Dipendenze: N/A

Opzione di ricerca esatta

Puoi assegnare un determinato valore a query di stringa specifiche all'opzione exact-searchable, un campo dell'attributo catalogo. Se una query corrisponde a un prodotto del tuo catalogo in cui il valore di quel campo è la stringa fornita 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.

In genere, per gli attributi personalizzati, il campo ExactSearchableOption è utile per gli attributi prodotto con un valore esatto (ad esempio ModelId o ManufacturerId). Gli attributi come product_id sono campi di indice primari, ovvero ricercabili in modo esatto 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 pubblicare un numero insufficiente di query di ricerca, non impostare campi speciali come tag, che potrebbe avere "iphone" come uno dei suoi valori stringa, su Ricerca esatta. 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 di prodotto.

Comportamento degli attributi

Quando strutturi il catalogo dei prodotti utilizzando le designazioni di prodotto principale e variante, scopri come vengono gestiti gli attributi di prodotto per il filtraggio. Il loro comportamento dipende dall'utilizzo della ricerca o dei consigli e dalla configurazione della tassonomia del catalogo.

Per garantire un comportamento di filtraggio prevedibile e accurato, mantieni coerenza e completezza nelle definizioni degli attributi filtrabili nei prodotti principali e nelle varianti. Questo approccio aiuta a filtrare con precisione, il che migliora la rilevabilità dei prodotti e la pertinenza della ricerca.

Comportamento della variante principale nella ricerca rispetto ai consigli

Sebbene nei risultati di ricerca e suggerimento vengano restituiti solo gli articoli principali, Vertex AI Search per il commercio ottimizza la qualità della ricerca e dei suggerimenti.

  • Per i modelli di ricerca, gli attributi delle varianti vengono utilizzati per il prodotto principale nell'indice di ricerca. I risultati di ricerca mostrano diverse opzioni per il prodotto principale in base agli attributi delle sue varianti.

  • Per i modelli di consigli, i dettagli e gli attributi del prodotto non vengono ereditati dal prodotto principale alla variante. Per una qualità ottimale dei consigli, è fondamentale che i prodotti principali e le varianti abbiano dettagli completi e accurati per gli attributi chiave come product.categories, product.title, product.attributes e product.prices.

Gestire gli attributi durante l'indicizzazione e il filtraggio

Se lo stesso attributo è definito in Principale e Variante, l'attributo nella variante fa parte del filtro. Ad esempio, supponiamo che un attributo sia definito per un prodotto principale e le relative varianti (colore o taglia). I valori degli attributi delle varianti vengono utilizzati principalmente per il filtraggio, durante il quale il sistema controlla se una delle varianti principali corrisponde al valore dell'attributo. Prendi in considerazione la disponibilità dei prodotti: un prodotto principale può essere contrassegnato come out-of-stock, ma se almeno una delle sue varianti è in-stock, il prodotto principale è disponibile per i risultati di ricerca se viene applicato un filtro in-stock.

Per i seguenti motivi, imposta gli stessi attributi filtrabili in Principale e Variante:

  • Gli attributi delle varianti hanno la precedenza per il filtraggio. Se un attributo è definito in un prodotto principale e nelle relative varianti, l'attributo della variante viene utilizzato per il filtraggio. Ad esempio, se un prodotto principale ha un colore segnaposto, ma le sue varianti hanno colori reali, il colore della variante deve essere compilato e viene utilizzato per il filtro.

  • Per gli attributi correlati all'inventario, come la disponibilità, se un prodotto principale ha varianti, la disponibilità del prodotto principale deve essere impostata su OUT_OF_STOCK, mentre la disponibilità effettiva (ad esempio IN_STOCK) deve essere impostata a livello di variante. In questo modo, il prodotto principale viene considerato disponibile finché almeno una variante è disponibile. In questo caso, filtri come availability: ANY("IN_STOCK") restituiscono correttamente il prodotto principale.

  • Quando viene utilizzata un'espressione di filtro, la risposta di previsione restituirà i prodotti principali che hanno almeno un prodotto principale o variante corrispondente al valore dell'attributo del filtro.

Attributi facoltativi per il filtraggio

Mantieni il campo categories pulito e ottimizzato per la tassonomia. Se è necessario un ulteriore filtro, implementalo in base a categorie generali utilizzando attributi personalizzati separati, non nel campo categories. In questo modo si evita anche di influire negativamente sull'addestramento del completamento automatico per i suggerimenti di categorie.

Ad esempio, supponiamo che tu imposti in genere categorie come [lvl1, lvl1>lvl2, lvl1>lvl2>lvl3] per il filtraggio. Il completamento automatico conteggia le categorie più frequenti per una determinata query, quindi le categorie suggerite sono lvl1 e lvl2 (tutti i tuoi prodotti).

Best practice

Se il tuo catalogo è composto da prodotti principali e varianti e lo stesso attributo è definito in entrambi, l'attributo nella variante verrà considerato durante il filtraggio.

  • Compila gli attributi in modo accurato: assicurati che sia i prodotti principali sia le varianti abbiano dettagli completi e accurati per i loro attributi, in particolare quelli utilizzati per il filtraggio, per massimizzare l'efficacia.

  • Utilizza i campi integrati: non fare affidamento esclusivamente sugli attributi personalizzati. Mappa le informazioni sul prodotto nei campi Product integrati (brands, colors, sizes e i campi obbligatori). I campi integrati hanno un impatto maggiore sull'ottimizzazione della ricercabilità, dell'indicizzazione e della pertinenza. Gli attributi personalizzati (Product.attributes) sono destinati ai dati di prodotto che non rientrano negli attributi di sistema predefiniti.

  • Imposta il controllo dei campi recuperabili a livello di sito: l'API supporta variantRollupKeys per le varianti, consentendoti di recuperare i dettagli nelle risposte di ricerca.

  • Lingua del catalogo coerente: il catalogo dei prodotti deve essere in una sola lingua e le query di ricerca devono essere inviate nella stessa lingua. La presenza di più lingue nel catalogo può ridurre le prestazioni del modello. La mancata impostazione del codice lingua può influire su funzionalità come la correzione ortografica.

  • Informazioni sul prezzo: inserisci con precisione le informazioni sul prezzo sia per i prodotti principali sia per le varianti per garantire consigli e filtri accurati. Se un prodotto non ha un prezzo a livello di prodotto e si basa esclusivamente sul prezzo dell'inventario locale, compila il prezzo del prodotto principale con la mediana del prezzo a livello di inventario.

Modalità di configurazione

La modalità di configurazione determina il modo in cui vengono trattate le configurazioni degli attributi e quali configurazioni degli attributi puoi impostare.

  • Modalità di configurazione a livello di catalogo (impostazione predefinita): in questa modalità, le configurazioni degli attributi a livello di catalogo vengono utilizzate come fonte attendibile.
  • Modalità di configurazione a livello di prodotto (ritirata): in questa modalità, le configurazioni degli attributi a livello di prodotto vengono utilizzate come fonte attendibile.

In precedenza, la configurazione a livello di prodotto era la modalità predefinita. Se ti trovi ancora nella modalità di configurazione a livello di prodotto e devi passare alla modalità di configurazione a livello di catalogo, contatta l'assistenza. La ricerca non supporta il ritorno alla modalità di configurazione a livello di prodotto dopo il cambio.

Per controllare la modalità di configurazione, vai alla pagina Controlli della console Search for commerce. Se l'opzione Indicizzabile è disponibile come colonna nella scheda Controlli a livello di sito, il modello di configurazione è a livello di catalogo. Se la colonna Indicizzabile non è disponibile nella scheda Controlli a livello di sito, il modello di configurazione è a livello di prodotto.

Metodi di configurazione

Puoi impostare le configurazioni degli attributi nei seguenti modi:

  • Console Search for commerce: imposta le configurazioni degli attributi a livello di catalogo utilizzando la console Search for commerce. Questa operazione configura gli attributi a livello globale in tutti i prodotti. Le impostazioni disponibili nella console dipendono dalla modalità di configurazione. Per maggiori dettagli su come configurare gli attributi nella console, consulta la sezione successiva.

  • Il metodo API AttributeConfig: imposta le configurazioni degli attributi a livello di catalogo utilizzando l'API. In questo modo vengono configurati gli attributi per tutti i prodotti.

  • Metodo API Product (deprecato): imposta gli attributi personalizzati a livello di prodotto utilizzando il metodo API Product. L'impostazione degli attributi con questo metodo non è disponibile per i nuovi utenti e non è consigliata.

Configurare gli attributi nella console

Puoi impostare globalmente le opzioni degli attributi per tutti i prodotti dalla pagina Controlli di Search for commerce console, nella scheda Controlli a livello di sito. Per maggiori dettagli su come impostare questa opzione nella console, vedi Gestire i controlli degli attributi a livello di sito.

Per utilizzare questa funzionalità, la modalità di configurazione deve essere a livello di catalogo.

Le modifiche alle impostazioni di configurazione degli attributi per indicizzabile e ricercabile diventano effettive immediatamente dopo l'importazione del catalogo. In caso contrario, l'applicazione delle modifiche potrebbe richiedere fino a 12 ore o più. Puoi verificare se le modifiche sono state applicate nella pagina Valuta.

Configura gli attributi con AttributesConfig

La risorsa API AttributesConfig ti consente di gestire le configurazioni degli attributi a livello di catalogo.

I seguenti campi impostano le opzioni degli attributi a livello di catalogo:

Per recuperare tutte le configurazioni degli attributi, utilizza il metodo GetAttributesConfig.

Aggiornare più attributi

Utilizza il metodo updateAttributesConfig per aggiornare più attributi a livello di catalogo.

Gli attributi del catalogo inclusi nella richiesta vengono aggiornati nel catalogo o inseriti se non esistono. Se non è presente alcun valore per un campo attributo del catalogo, viene assegnato un valore predefinito.

Il numero massimo di attributi del catalogo consentiti in una richiesta è 1000.

Aggiornare un singolo attributo

Per aggiornare i singoli attributi del catalogo vengono utilizzati i seguenti metodi:

  • AddCatalogAttribute: aggiunge una singola configurazione dell'attributo a un attributo del catalogo.

    Consulta la documentazione di riferimento dell'API per AddCatalogAttribute.

  • ReplaceCatalogAttribute: modifica la configurazione di un singolo attributo. Sostituisce il valore CatalogAttribute specificato in AttributesConfig aggiornando l'attributo del catalogo con lo stesso valore CatalogAttribute.key.

    Consulta la documentazione di riferimento dell'API per ReplaceCatalogAttribute.

  • RemoveCatalogAttribute: rimuove una singola configurazione dell'attributo da AttributesConfig.

    Possono essere eliminati solo i CatalogAttributes non utilizzati dai prodotti. Se è in uso un CatalogAttribute, RemoveCatalogAttribute non lo elimina, ma reimposta le proprietà di configurazione sui valori predefiniti. CatalogAttribute.inUse è impostato su True se l'attributo è utilizzato da qualsiasi prodotto.

    Consulta la documentazione di riferimento dell'API per RemoveCatalogAttribute.

Configurare gli attributi con il metodo Product (ritirato)

L'impostazione degli attributi con questo metodo non è disponibile per i nuovi utenti ed è sconsigliata.

I seguenti campi impostano le impostazioni di indicizzazione e ricerca per un prodotto specifico utilizzando il metodo API Product: