Informazioni sugli attributi dei prodotti

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 in base al metodo e alla 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 esistenti (Product) che forniscono ulteriori informazioni sul prodotto. Sono inclusi gli attributi del prodotto come marca, disponibilità, colore e taglia. Per tutti attributi di sistema disponibili per i prodotti, consulta documentazione di riferimento di Product.

  • Attributi personalizzati: gli attributi personalizzati sono attributi aggiuntivi che definisci utilizzando il campo Product.attributes. Ad esempio, potrebbe includere nomi, fornitori o stile. Per esempi e limiti relativi agli attributi personalizzati, consulta il 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. A livello di inventario sono indicizzabili 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 della ricerca e dei suggerimenti sul tuo sito.

La ricerca utilizza le seguenti impostazioni degli attributi:

  • Indicizzabile: la ricerca può applicare filtri e 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 il faceting dinamico per un attributo, scegli 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.
  • Recuperabile: se il valore è impostato su true, la ricerca restituisce questo 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 e le informazioni sul colore del prodotto. Il campo REST RetrievableFields è deprecato 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 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 disabilitata per gli attributi di sistema.
  • Attributi personalizzati: abilitati per impostazione predefinita. Puoi disattivare l'indicizzazione per qualsiasi attributo personalizzato. Se prevedi di rendere indicizzabili gli attributi personalizzati, deve seguire il pattern dell'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 del sistema. Questa impostazione non può essere modificata. Attivato per impostazione predefinita per attributi personalizzati a livello di inventario; 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 è abilitato 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 dell'utente, ad esempio i clic e le visualizzazioni delle sfaccettature.

  • Attributi di sistema: attivati per impostazione predefinita se l'indiceabilità è impostata su true. Tu è possibile disattivare il faceting dinamico per qualsiasi attributo di sistema.
  • Attributi personalizzati: attivati per impostazione predefinita se l'indicizzazione è impostata su true. Tu 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 dinamica dei facet 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, richiamalo in query di ricerca è migliorata.

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

  • Attributi di sistema: gli attributi di sistema testuali predefiniti per Product hanno e le relative impostazioni di ricercabilità configurate da Vertex AI Search for Retail. Questi e non può essere modificata.
  • Attributi personalizzati: disattivati per impostazione predefinita. Puoi attivare questa funzionalità per qualsiasi attributo testuale personalizzato.
  • Attributi a livello di inventario: non supportati.
  • Dipendenze: N/D

Sebbene i prodotti con un attributo disponibile per la ricerca abbiano maggiori probabilità di essere visualizzati in per l'attributo in questione, la loro visualizzazione non è garantita.

Filtro dei suggerimenti

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 le configurazioni degli attributi vengono trattate e quali configurazioni degli attributi puoi per iniziare.

  • 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 stai ancora in modalità di configurazione a livello di prodotto, ma occorre passare a quella a livello di catalogo. di configurazione, contatta l'Assistenza. Rete di ricerca non supporta il ritorno alla modalità di configurazione a livello di prodotto dopo aver attivata.

Per controllare la modalità di configurazione, vai alla console Search for Retail Pagina Controlli: 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, quindi 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 Cerca la console Retail. In questo modo gli attributi vengono configurati a livello globale per tutti i prodotti. Le impostazioni disponibili nella console dipendono la 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.

  • Il metodo API Product (deprecato): imposta attributi personalizzati nella a livello di prodotto con il metodo dell'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 Cerca console Retail Pagina Controlli, nel 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.

Modifiche alle impostazioni di configurazione degli attributi per le versioni Indicizzabili e Ricercabili subito 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 applicata il Pagina Valuta.

Configura 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.

Aggiorna più attributi

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

Gli attributi del catalogo che includi 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 di attributo a una catalogo.

    Consulta la documentazione di riferimento dell'API per AddCatalogAttribute.

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

    Consulta la documentazione di riferimento dell'API per ReplaceCatalogAttribute.

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

    Puoi eliminare solo gli asset CatalogAttributes non utilizzati dai prodotti. Se CatalogAttribute è in uso, RemoveCatalogAttribute non la elimina, ma ripristina le proprietà di configurazione sui valori predefiniti. CatalogAttribute.inUse è impostato su True se l'attributo è in uso da qualsiasi prodotto.

    Consulta la documentazione di riferimento dell'API per RemoveCatalogAttribute

Configura gli attributi con il metodo Product (deprecato)

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: