Informazioni sugli attributi dei prodotti

L'API Retail può sfruttare gli attributi dei prodotti per l'indicizzazione, il faceting dinamico, la ricercabilità, i filtri e la qualità del modello. In questa pagina viene descritta l'impostazione delle configurazioni degli attributi dei prodotti e del modo in cui vengono trattate in base al metodo e alla configurazione utilizzati.

Tipi di attributi

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

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

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

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

  inventories.price e inventories.originalPrice sono attributi di sistema numerici predefiniti dall'API Retail. 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 del faceting ricercabile e dinamico 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.

Retail Search utilizza le seguenti impostazioni degli attributi:

• Indicizzabile. Retail Search può filtrare e facet utilizzando questo attributo.
• Facet dinamico: Retail Search può utilizzare automaticamente questo attributo come facet dinamico in base al comportamento degli utenti precedenti, come i clic e le visualizzazioni dei facet. Per abilitare il faceting dinamico per un attributo, Indicizzabile deve essere impostato su true per tale attributo.
• Ricercabile: questo attributo è disponibile per la ricerca per le query di Retail Search, il che aumenta il richiamo per tale attributo. Questo controllo è applicabile solo per gli attributi di testo.
• Recuperabile: se impostato su true, Retail Search restituisce questo attributo nelle risposte alle query di ricerca. Se tutti gli attributi sono Recuperabili impostati su falso, i risultati di ricerca contengono solo il nome del prodotto o (per le varianti) il nome del prodotto e le informazioni sul colore.

Recommendations AI utilizza le seguenti impostazioni degli attributi:

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

Indicizzabile

Se un attributo è impostato su indicizzabile, Retail Search può filtrarlo e facet utilizzando l'attributo.

• Attributi di sistema: l'indicizzabilità è sempre attivata per gli attributi di sistema predefiniti. Questa impostazione non può essere disattivata per gli attributi di sistema.
• Attributi personalizzati: opzione attivata per impostazione predefinita. Puoi disattivare la indicizzabilità per qualsiasi attributo personalizzato. Se prevedi di consentire l'indicizzazione degli attributi personalizzati, 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 di sistema; questa impostazione non può essere modificata. Abilitato per impostazione predefinita per gli attributi personalizzati a livello di inventario; questa impostazione può essere disattivata.
• Dipendenze: N/D

Le modifiche alla configurazione di indice vengono applicate subito dopo l'importazione dei dati del catalogo. In caso contrario, potrebbero essere necessarie fino a 12 ore o più affinché le modifiche abbiano effetto. Puoi verificare se le modifiche sono state applicate nella pagina Valuta.

Faceting dinamico

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

• Attributi di sistema: opzione attivata per impostazione predefinita se l'indicizzazione è impostata su true. Puoi disattivare il faceting dinamico per qualsiasi attributo di sistema.
• Attributi personalizzati: questa opzione è attivata 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 abilitare il faceting dinamico per un attributo, devi prima abilitare l'indicizzazione per tale attributo.

L'impostazione del faceting dinamico per un attributo è sempre globale. La configurazione del faceting dinamico che applichi all'attributo viene usata dai prodotti del catalogo che usano quell'attributo.

Le modifiche dinamiche alla configurazione del faceting possono richiedere 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 in bucket.

Ricercabile

Se un attributo è impostato come ricercabile, il ricordo dell'attributo nelle query di Retail Search viene migliorato.

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

• Attributi di sistema: per gli attributi di sistema testuale predefiniti per Product sono configurate le relative impostazioni di ricerca. L'impostazione non può essere modificata.
• Attributi personalizzati: questa opzione è disattivata per impostazione predefinita. Puoi attivare questa configurazione per qualsiasi attributo testuale personalizzato.
• Attributi a livello di inventario: non supportati.
• Dipendenze: N/D

Anche se i prodotti con un attributo ricercabile hanno maggiori probabilità di essere visualizzati nei risultati di ricerca per quell'attributo, la loro pubblicazione non è garantita.

Filtro dei consigli

Attenzione: questa funzionalità è in anteprima pubblica.

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

• Attributi di sistema: opzione disattivata 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: questa opzione è disattivata 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/D

Modalità di configurazione

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

• Modalità di configurazione a livello di catalogo (impostazione 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 di riferimento.

In precedenza, la configurazione a livello di prodotto era in modalità predefinita. Se sei ancora in modalità di configurazione a livello di prodotto e devi passare alla modalità di configurazione a livello di catalogo, contatta l'assistenza Retail. Retail Search 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 Retail. Se l'opzione Indicizzabile è disponibile come colonna nella scheda Controlli a livello di sito, l'API Retail è in modalità di configurazione a livello di catalogo. Se la colonna Indicizzabile non è disponibile nella scheda Controlli a livello di sito, l'API Retail è in modalità di configurazione a livello di prodotto.

Metodi di configurazione

Puoi impostare le configurazioni degli attributi nei seguenti modi:

• La console Google Cloud Retail: imposta le configurazioni degli attributi a livello di catalogo utilizzando la console Google Cloud. Questo permette di configurare gli attributi a livello globale per tutti i prodotti. Quale di queste impostazioni è disponibile nella console dipende dalla modalità di configurazione dell'API Retail impostata.

• Il metodo API AttributeConfig: imposta le configurazioni degli attributi a livello di catalogo utilizzando l'API Retail. Questo permette di configurare gli attributi in tutti i prodotti.

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

Configura gli attributi nella console

Puoi impostare globalmente le opzioni per gli attributi per tutti i prodotti dalla pagina Controlli della console Retail, nella scheda Controlli a livello di sito. Per maggiori dettagli su come impostare questo valore nella console, consulta Gestire i controlli degli attributi a livello di sito.

L'API Retail deve essere in modalità di configurazione a livello di catalogo per poter usare questa funzionalità.

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 potrebbe 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:

• CatalogAttribute.indexableOption: imposta l'opzione di indicizzazione per un attributo.
• CatalogAttribute.dynamicFacetableOption: imposta l'opzione di faceting dinamico per un attributo.
• CatalogAttribute.searchableOption: imposta l'opzione ricercabile per un attributo.
• CatalogAttribute.recommendationsFilteringOption (Anteprima pubblica): consente di impostare l'opzione di filtro dei consigli per un attributo.

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 di catalogo inclusi nella richiesta vengono aggiornati nel catalogo oppure inseriti se non esistono. Se non è previsto alcun valore per un campo dell'attributo catalogo, 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 un singolo attributo a un attributo 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 aggiornando l'attributo catalogo con lo stesso CatalogAttribute.key.

  Consulta la documentazione di riferimento dell'API per ReplaceCatalogAttribute.

• RemoveCatalogAttribute: rimuove la configurazione di un singolo attributo da AttributesConfig.

  Puoi eliminare solo i CatalogAttributes non utilizzati dai prodotti. Se un CatalogAttribute è in uso, RemoveCatalogAttribute non lo elimina, ma ripristina i valori predefiniti delle relative proprietà di configurazione. 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 dell'API Retail e non è consigliata.

I seguenti campi definiscono le impostazioni indicizzabili e disponibili per la ricerca per un prodotto specifico tramite il metodo API Product:

• Product.attributes.indexable.
• Product.attributes.searchable. Disponibile solo per gli attributi personalizzati.