Informazioni sugli attributi del prodotto

Vertex AI Search for retail può sfruttare gli attributi dei prodotti per l'indicizzazione, la suddivisione in parametri dinamici, la ricercabilità, i filtri e la qualità del modello. Questa pagina discute l'impostazione delle configurazioni degli attributi dei prodotti e il modo in cui vengono trattati a seconda del metodo e della configurazione utilizzati.

Tipi di attributi

Gli attributi dei prodotti possono avere impostazioni predefinite e opzioni consentite diverse in base al tipo.

  • Attributi di sistema: gli attributi di sistema predefiniti sono campi Product esistenti che forniscono ulteriori informazioni sul prodotto. Sono inclusi gli attributi del prodotto come marca, 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 per gli attributi personalizzati, consulta la documentazione di riferimento di Product.attributes.

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

    inventories.price e inventories.originalPrice sono attributi di sistema numerici predefiniti da Vertex AI Search per il retail. Puoi creare attributi personalizzati a livello di inventario, che possono essere di tipo testo o numerico. Gli attributi a livello di inventario sono indicizzati per impostazione predefinita. L'impostazione della suddivisione in facet dinamica e ricercabile 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:

  • Indirizzabile: la ricerca può filtrare e creare 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 i clic e le visualizzazioni dei facet. Per attivare la suddivisione in parametri dinamici per un attributo, Indicizzabile deve essere impostato su true per quell'attributo.
  • Ricercabile: questo attributo è disponibile per la ricerca tramite query di ricerca, il che aumenta il suo recupero. Questo controllo è applicabile solo per gli attributi di testo.
  • Recupero: se impostato su true, la ricerca restituisce questo attributo nelle risposte alle query di ricerca. Se per tutti gli attributi è impostato il valore Recuperabile 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 è deprecato per i prodotti. Utilizza invece il controllo recuperabile a livello di sito.

La funzionalità Consigli utilizza le seguenti impostazioni degli attributi:

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

Indicizzabile

Se un attributo è impostato su indicizzato, la ricerca può filtrare e suddividere 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 indicizzato un attributo personalizzato, deve seguire il pattern regex [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 del sistema. Questa impostazione non può essere modificata. Attiva per impostazione predefinita per gli attributi a livello di inventario personalizzati. Questa impostazione può essere disattivata.
  • Dipendenze: N/A

Le modifiche alla configurazione dell'indice vengono applicate 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ò utilizzarlo come facet dinamico. Le sfaccettature dinamiche possono essere aggiunte automaticamente a una ricerca in base al comportamento passato dell'utente, ad esempio i clic e le visualizzazioni delle sfaccettature.

  • Attributi di sistema: attivati per impostazione predefinita se l'indiceabilità è impostata su true. Puoi disattivare il faceting dinamico per qualsiasi attributo di sistema.
  • Attributi personalizzati: abilitati 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 la suddivisione in parametri dinamici 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 applicata all'attributo viene utilizzata dai prodotti nel catalogo che utilizzano l'attributo.

Le modifiche alla configurazione del faceting dinamico possono richiedere 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 come ricercabile, il suo richiamo nelle query di ricerca viene migliorato.

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

  • Attributi di sistema: gli attributi di sistema di testo predefiniti per Product hanno le impostazioni di ricercabilità configurate da Vertex AI Search per il retail. Queste impostazioni non possono essere modificate.
  • Attributi personalizzati: disattivati per impostazione predefinita. Puoi attivare questa configurazione per qualsiasi attributo personalizzato di tipo testo.
  • Attributi a livello di inventario: non supportati.
  • Dipendenze: N/A
  • Ricercabile con corrispondenza esatta: la ricerca mirata restituisce risultati per le query di ricerca che corrispondono a un determinato prodotto nel tuo 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 apparire nei risultati di ricerca per quell'attributo, non è garantito che vengano visualizzati.

Filtro dei consigli

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

  • Attributi di sistema: disattivata 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: disattivata 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 availabilityIN_STOCK.
  • Dipendenze: N/A

Modalità di configurazione

La modalità di configurazione determina come vengono trattate le configurazioni degli attributi e quali configurazioni degli attributi puoi impostare.

  • Modalità di configurazione a livello di catalogo (predefinita): in questa modalità, le configurazioni degli attributi a livello di catalogo vengono utilizzate come fonte attendibile.
  • Modalità di configurazione a livello di prodotto (non più supportata): in questa modalità, le configurazioni degli attributi a livello di prodotto vengono utilizzate come origine attendibile.

In precedenza, la configurazione a livello di prodotto era la modalità predefinita. Se utilizzi ancora la modalità di configurazione a livello di prodotto e devi passare alla modalità di configurazione a livello di catalogo, contatta l'assistenza. La rete di 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 Ricerca per la vendita al dettaglio. Se l'opzione Indirizzabile è 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 Retail: imposta le configurazioni degli attributi a livello di catalogo utilizzando la console Search for Retail. In questo modo, gli attributi vengono configurati a livello globale per tutti i prodotti. Le impostazioni disponibili nella console dipendono dalla modalità di configurazione.

  • Metodo API AttributeConfig: imposta le configurazioni degli attributi a livello di catalogo utilizzando l'API. In questo modo, gli attributi vengono configurati su 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 è consigliata e non è disponibile per i nuovi utenti.

Configurare gli attributi nella console

Puoi impostare le opzioni degli attributi a livello globale per tutti i prodotti dalla pagina Controlli della console Ricerca per la vendita al dettaglio, nella scheda Controlli a livello di sito. Per maggiori dettagli su come impostare questa opzione nella console, consulta 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 gli attributi indicizzabile e ricercabile vengono applicate immediatamente all'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.

Configurare gli attributi con AttributesConfig

La risorsa API AttributesConfig 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 dell'attributo del catalogo, viene assegnato un valore predefinito.

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

Aggiornare un singolo attributo

I seguenti metodi vengono utilizzati per aggiornare i singoli attributi del catalogo:

  • 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. In questo modo, il CatalogAttribute specificato in AttributesConfig viene sostituito aggiornando l'attributo del catalogo con lo stesso CatalogAttribute.key.

    Consulta la documentazione di riferimento dell'API per ReplaceCatalogAttribute.

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

    Solo i CatalogAttributes non in uso dai prodotti possono essere eliminati. Se un CatalogAttribute è in uso, RemoveCatalogAttribute non lo elimina, ma ripristina le relative proprietà di configurazione ai valori predefiniti. CatalogAttribute.inUse è impostato su True se l'attributo è in uso 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 e non è consigliata.

I seguenti campi impostano le impostazioni indicizzate e disponibili per la ricerca per un prodotto specifico tramite il metodo dell'API Product: