Controllare quali metafield dei prodotti  Shoply può utilizzare

Il tuo assistente AI per lo shopping è progettato per aiutare i clienti leggendo le informazioni sui prodotti, rispondendo alle domande e fornendo consigli.

Tuttavia, non tutti i dati dei prodotti sono destinati ai clienti. Alcuni metafield dei prodotti  possono contenere informazioni interne (come il margine di profitto), dettagli sui fornitori o altri attributi che dovrebbero rimanere privati. In questi casi, potresti preferire che Shoply non utilizzi questi metafield per rispondere alle domande dei clienti.

Shoply utilizza l’AI per determinare automaticamente quali metafield possono essere usati per rispondere alle domande dei clienti. Tuttavia, per offrirti il pieno controllo, Shoply ti permette di inserire nella blacklist (escludere) specifici metafield dei prodotti o interi namespace di metafield.

Questa guida spiega perché è utile e come configurarla.

Dove trovare le Impostazioni avanzate?

Vai alla sezione “Impostazioni” della console di amministrazione dell’app, quindi scorri verso il basso fino alla sezione “Impostazioni avanzate”. In questa sezione puoi fornire un oggetto JSON  per configurare varie impostazioni.

Impostazioni della blacklist

Utilizza queste impostazioni per impedire a Shoply di usare specifici metafield dei prodotti quando risponde alle domande dei clienti.

blacklist_product_fields

Un elenco di chiavi esatte dei metafield (nomi dei campi) che desideri escludere. Il nome del campo deve corrispondere esattamente alla chiave del metafield così come appare in Shopify.

Esempi di chiavi dei metafield:

• start_date
• product_type
• backstock_number
• upc
• shipping_lead_time
• brand

Nota: se non vuoi mostrare il fornitore del prodotto, devi aggiungere “brand” alla blacklist, perché, per motivi di compatibilità con le versioni precedenti, Shoply utilizza il metafield brand per memorizzare le informazioni sul fornitore.

blacklist_display_filters

Un elenco di chiavi esatte dei metafield da nascondere esclusivamente nell’interfaccia dei filtri/facet. A differenza di blacklist_product_fields, questi campi sono ancora disponibili all’AI per rispondere alle domande dei clienti: semplicemente non vengono mostrati come filtri selezionabili nell’interfaccia di ricerca.

È utile quando un metafield contiene informazioni preziose sul prodotto che l’AI dovrebbe conoscere, ma che non ha senso usare come filtro visibile ai clienti.

Esempio:

• warehouse_region — contesto utile per l’AI, ma non un filtro utile per i clienti
• care_instructions — utile per le risposte dell’AI, ma non una categoria di filtro significativa

blacklist_namespaces

Un elenco di interi namespace  che desideri far ignorare all’AI.

Esempio:

• RenterInfo

Se un metafield appartiene a un namespace nella blacklist, tutti i campi di quel namespace vengono esclusi automaticamente.

È utile quando un intero namespace è interno o contiene informazioni sensibili.

Consigli per la blacklist

Si consiglia di inserire nella blacklist:

• Codici dei fornitori
• Dettagli di magazzino / inventario
• Note interne sull’evasione degli ordini
• Metafield utilizzati da altre app
• Qualsiasi campo che non dovrebbe essere visibile ai clienti

Evita di inserire nella blacklist campi come:

• Titolo del prodotto
• Descrizione
• Materiale
• Taglia, dimensioni o specifiche
• Ingredienti
• Istruzioni per la cura
• Nomi/opzioni delle varianti

(Aiutano l’AI a fornire risposte migliori.)

Arricchire i dati dei prodotti dai tag

split_tag_to_metafield_by

I tag di Shopify sono un modo pratico per etichettare i prodotti, ma vengono memorizzati come un elenco piatto di stringhe e non possono essere utilizzati come filtri strutturati. Questa impostazione consente di convertire i tag nel formato key:value in veri metafield che Shoply può indicizzare e utilizzare per i filtri.

Come funziona:

Imposta split_tag_to_metafield_by sul carattere delimitatore utilizzato nei tuoi tag. Shoply dividerà ogni tag in corrispondenza di quel carattere, tratterà il lato sinistro come chiave del metafield e quello destro come valore, quindi li indicizzerà di conseguenza.

Ad esempio, se i tuoi prodotti hanno tag come:

material:aluminum
color:matte-black
compatible-with:iPhone 15

Impostando il delimitatore su ":" verranno creati i metafield:

Questi metafield indicizzati possono quindi essere utilizzati come filtri facet in Shoply AI Search, proprio come i metafield nativi di Shopify.

I tag che non contengono il delimitatore vengono ignorati da questa impostazione e rimangono tag normali.

Esempio di configurazione:

{
  "split_tag_to_metafield_by": ":"
}

Quando utilizzarla:

• Il tuo negozio utilizza già tag key:value per gli attributi (ad esempio, provenienti da un’importazione in blocco o da un’app di terze parti)
• Vuoi aggiungere attributi filtrabili senza creare definizioni formali di metafield Shopify
• Ti serve un modo rapido per rendere disponibili dati strutturati dei prodotti in Shoply senza applicare nuovi tag al catalogo

Controllare la visualizzazione dei prodotti

Utilizza queste impostazioni per controllare quali informazioni vengono mostrate quando i prodotti vengono visualizzati nella chat o nell’interfaccia di ricerca.

hide_discount

Quando è impostato su true, le percentuali di sconto (ad esempio, “-40%”) vengono nascoste nelle visualizzazioni dei prodotti. È utile se non vuoi mettere in evidenza gli sconti per i clienti.

hide_price

Quando è impostato su true, tutte le informazioni sui prezzi vengono nascoste, inclusi i prezzi originali e quelli scontati. Usalo se preferisci che i clienti visitino la pagina del prodotto per vedere i prezzi o se la tua strategia di prezzo richiede di nascondere i prezzi nell’interfaccia di chat/ricerca.

hide_review

Quando è impostato su true, le valutazioni delle recensioni non vengono mostrate nelle visualizzazioni dei prodotti. È utile se non vuoi che i punteggi delle recensioni influenzino le decisioni dei clienti nell’interfaccia di chat/ricerca.

Esempio di oggetto JSON valido

Ecco un esempio completamente valido:

{
  "blacklist_product_fields": [
    "profit_margin",
    "inventory_level"
  ],
  "blacklist_display_filters": [
    "product_type",
    "category_name",
    "warehouse_region",
    "care_instructions"
  ],
  "blacklist_namespaces": [
    "SupplierInfo"
  ],
  "split_tag_to_metafield_by": ":",
  "hide_discount": true,
  "hide_price": false,
  "hide_review": false
}

Puoi rimuovere gli elementi che non ti servono oppure aggiungere le tue chiavi e i tuoi namespace dei metafield. Imposta le opzioni hide_* su true o false in base alle tue preferenze.