Informazioni sugli attributi del prodotto

Vertex AI Search per la vendita al dettaglio può sfruttare gli attributi dei prodotti per indicizzazione, faceting dinamico, ricercabilità, filtri e qualità del modello. Questa pagina descrive l'impostazione delle configurazioni degli attributi del prodotto e il modo in cui vengono trattate a seconda del metodo e della configurazione che utilizzi.

Tipi di attributi

Gli attributi dei prodotti 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 ulteriori informazioni sul prodotto. Questi includono 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 nomi di negozi, fornitori o stile. 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. Puoi utilizzare gli attributi a livello di inventario per i prodotti le cui proprietà variano in modo significativo tra negozi e regioni, ad esempio articoli alimentari, oppure per prodotti che presentano promozioni specifiche per un negozio.

    inventories.price e inventories.originalPrice sono attributi di sistema numerici predefiniti da Vertex AI Search per la vendita al dettaglio. 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 di faceting dinamico e disponibile per la ricerca 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 sito.

La ricerca utilizza le seguenti impostazioni degli attributi:

  • Indicizzabile: la ricerca può filtrare e facet utilizzando questo attributo.
  • Facet dinamico: la rete di ricerca può utilizzare automaticamente questo attributo come facet dinamico basato sul comportamento passato degli utenti, come visualizzazioni e clic dei facet. Per attivare il faceting dinamico per un attributo, il valore Indexable deve essere impostato su true per l'attributo in questione.
  • Disponibile per la ricerca: questo attributo è disponibile per la ricerca in base alle query di ricerca, il che aumenta il richiamo dell'attributo. Questo controllo è applicabile solo per gli attributi di testo.
  • Recuperabile: se è impostato su true, la ricerca restituisce questo attributo nelle risposte alle query di ricerca. Se per tutti gli attributi il campo 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.

Per i suggerimenti vengono utilizzate le seguenti impostazioni degli attributi:

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

Indicizzabile

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

  • Attributi di sistema: l'indicizzazione è sempre abilitata per gli attributi di sistema predefiniti. Questa impostazione non può essere disattivata per gli attributi di sistema.
  • Attributi personalizzati: sono attivati per impostazione predefinita. Puoi disabilitare l'indicizzazione per qualsiasi attributo personalizzato. Se prevedi di rendere indicizzabili gli attributi personalizzati, devi 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 di sistema; questa impostazione non può essere modificata. Questa opzione è abilitata per impostazione predefinita per gli attributi personalizzati a livello di inventario; può essere disattivata.
  • Dipendenze: N/A

Le modifiche alla configurazione dell'indice entrano in vigore 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

Se per un attributo è abilitato il faceting dinamico, la ricerca può utilizzarlo come facet dinamico. I facet dinamici possono essere aggiunti automaticamente a una ricerca in base al comportamento passato degli utenti, come i clic e le visualizzazioni.

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

L'impostazione del faceting dinamico per un attributo è sempre globale. La configurazione dei faceting dinamici applicata all'attributo viene utilizzata dai prodotti del catalogo che utilizzano quell'attributo.

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

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

Ricercabile

Se un attributo è impostato come disponibile per la ricerca, il richiamo dell'attributo nelle query di ricerca è migliorato.

La ricercabilità può essere attivata solo per i valori degli attributi testuali. Non è applicabile agli attributi numerici.

  • Attributi di sistema: gli attributi di sistema testuali predefiniti per Product hanno le relative impostazioni di ricercabilità configurate da Vertex AI Search per la vendita al dettaglio. Questa impostazione non può essere modificata.
  • Attributi personalizzati: sono disattivati per impostazione predefinita. Puoi attivare questa configurazione per qualsiasi attributo testuale personalizzato.
  • Attributi a livello di inventario: non supportati.
  • Dipendenze: N/A

Sebbene i prodotti con un attributo disponibile per la ricerca abbiano maggiori probabilità di comparire nei risultati di ricerca per tale attributo, non è garantita la loro visualizzazione.

Filtro dei suggerimenti

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

  • Attributi di sistema: sono disattivati per impostazione predefinita. Puoi attivare questa impostazione per qualsiasi attributo testuale 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 testuale 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

Modalità di configurazione

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

  • Modalità di configurazione a livello di catalogo (predefinita): in questa modalità, le configurazioni degli attributi a livello di catalogo a livello di catalogo vengono utilizzate come fonte di riferimento.
  • Modalità di configurazione a livello di prodotto (deprecata): 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 utilizzi ancora la modalità di configurazione a livello di prodotto e devi passare a quella a livello di catalogo, contatta l'assistenza. La ricerca non supporta il ritorno alla modalità di configurazione a livello di prodotto dopo il passaggio.

Per verificare la modalità di configurazione, vai alla pagina Controlli della console Search for Retail. 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 Retail: imposta le configurazioni degli attributi a livello di catalogo utilizzando la console Search for Retail. che configura gli attributi a livello globale per tutti i prodotti. Quali di queste impostazioni sono disponibili nella console dipende dalla modalità di configurazione.

  • Il metodo API AttributeConfig: imposta le configurazioni degli attributi a livello di catalogo utilizzando l'API. che configura gli attributi in 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.

Configura gli attributi nella console

Puoi impostare le opzioni degli attributi a livello globale per tutti i prodotti dalla pagina Controlli della console Search for Retail, nella scheda Controlli a livello di sito. Per maggiori dettagli su come impostare questa impostazione nella console, consulta Gestire i controlli degli attributi in tutto il 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 Indicizzabili e Ricercabili vengono applicate immediatamente dopo l'importazione del catalogo. In caso contrario, l'applicazione delle modifiche può richiedere fino a 12 ore. Puoi verificare se le modifiche sono state applicate nella 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 di catalogo che includi nella richiesta vengono aggiornati nel catalogo o inseriti se non esistono. Se un campo di attributo di catalogo non contiene un valore, gli viene assegnato un valore predefinito.

Il numero massimo di attributi di 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 configurazione di singoli attributi a un attributo di 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 catalogo con lo stesso CatalogAttribute.key.

    Consulta la documentazione di riferimento dell'API per ReplaceCatalogAttribute.

  • RemoveCatalogAttribute: rimuove una configurazione di singoli attributi da AttributesConfig.

    È possibile eliminare soltanto CatalogAttributes che non sono utilizzati dai prodotti. Se un elemento CatalogAttribute è in uso, 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.

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 impostazioni indicizzabili e disponibili per la ricerca per un prodotto specifico tramite il metodo API Product: