Informazioni sugli attributi del prodotto

Vertex AI Search per il commercio 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 for Commerce. 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 in base all'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, questo 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. Abilitata 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 degli utenti, 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'indiceabilità è 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'indiceabilità 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.

Ricercabile

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 for Commerce. Queste impostazioni non possono essere modificate.
  • Attributi personalizzati: disattivati per impostazione predefinita. Puoi attivare questa configurazione per qualsiasi attributo personalizzato di tipo di 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 il commercio. 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 Commerce: imposta le configurazioni degli attributi a livello di catalogo utilizzando la console Search for Commerce. In questo modo, gli attributi vengono configurati a livello globale su 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 per la ricerca di prodotti, 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 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 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. 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: