Come controllare quali metafield di prodotto Shoply può usare

Il tuo Assistente Acquisti AI è progettato per aiutare i clienti leggendo le informazioni sui tuoi prodotti, rispondendo alle domande e facendo raccomandazioni.

Tuttavia, non tutti i dati di prodotto sono destinati ai clienti. Alcuni metafield di prodotto possono includere 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 quei metafield quando risponde alle domande dei clienti.

Shoply utilizza l’AI per determinare automaticamente quali metafield possono essere usati quando risponde alle domande dei clienti. Tuttavia, per offrirti il pieno controllo, Shoply ti consente di impostare una blacklist (escludere) per specifici metafield di prodotto o interi namespace di metafield.

Questa guida spiega perché è utile e come configurarlo.

Dove trovare le Impostazioni avanzate?

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

Per la policy generale sui dati, consulta quali informazioni Shoply può usare.

Settings → Advanced Settings is the editor used for the configuration below. The screenshot shows the demo store’s existing configuration; use the keys explained in this guide. Click the screenshot to view it at full size.

Impostazioni della blacklist

Usa queste impostazioni per impedire a Shoply di utilizzare specifici metafield di prodotto quando risponde alle domande dei clienti.

Per nascondere un intero elemento invece di singoli campi, escludi interi prodotti dall’indicizzazione.

`blacklist_product_fields`

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

Esempi di chiavi di 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, poiché Shoply utilizza il metafield brand per memorizzare le informazioni sul fornitore per motivi legacy.

`blacklist_display_filters`

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

Per capire meglio quali attributi compaiono, vedi come Shoply genera i filtri di prodotto.

Questo è utile quando un metafield contiene informazioni di prodotto preziose che l’AI dovrebbe conoscere, ma che non hanno senso 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 vuoi che l’AI ignori.

Esempio:

RenterInfo

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

Questo è utile quando un intero namespace è interno o sensibile.

Suggerimenti per la blacklist

Consigliato inserire nella blacklist:

Codici fornitore
Dettagli di magazzino / inventario
Note interne di evasione ordini
Metafield usati 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

(Questi aiutano l’AI a fornire risposte migliori.)

Arricchire i dati di prodotto dai tag

`split_tag_to_metafield_by`

I tag di Shopify sono un modo pratico per etichettare i prodotti, ma sono memorizzati come un elenco piatto di stringhe e non possono essere usati come filtri strutturati. Questa impostazione ti consente di convertire i tag in stile key:value in veri e propri metafield che Shoply può indicizzare e usare per il filtraggio.

Come funziona:

Imposta split_tag_to_metafield_by sul carattere delimitatore usato nei tuoi tag. Shoply dividerà ogni tag in base a quel carattere, tratterà la parte sinistra come chiave del metafield e la parte destra come valore, e li indicizzerà di conseguenza.

Per esempio, se i tuoi prodotti hanno tag come:

plaintext


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

Impostando il delimitatore su ":" si otterranno i metafield:

Chiave	Valore
`material`	`aluminum`
`color`	`matte-black`
`compatible-with`	`iPhone 15`

Questi metafield indicizzati possono poi essere usati come filtri a faccette 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:

json


{
  "split_tag_to_metafield_by": ":"
}

Quando usarlo:

Il tuo negozio usa già tag key:value per gli attributi (ad esempio, da un’importazione massiva o da un’app di terze parti)
Vuoi aggiungere attributi filtrabili senza creare definizioni formali di metafield Shopify
Hai bisogno di un modo rapido per esporre dati di prodotto strutturati a Shoply senza rietichettare il tuo catalogo

Controllare la visualizzazione del prodotto

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

Per modifiche visive ai campi che mantieni, puoi personalizzare lo stile delle product card con CSS.

`hide_discount`

Quando è impostato su true, le percentuali di sconto (ad esempio, “-40%”) verranno nascoste dalla visualizzazione dei prodotti. Questo è utile se non vuoi enfatizzare gli sconti ai clienti.

`hide_price`

Quando è impostato su true, tutte le informazioni sul prezzo verranno nascoste, inclusi i prezzi originali e i prezzi 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 chat/ricerca.

`hide_review`

Quando è impostato su true, le valutazioni delle recensioni non verranno mostrate nella visualizzazione dei prodotti. Questo è utile se non vuoi che i punteggi delle recensioni influenzino le decisioni dei clienti nell’interfaccia chat/ricerca.

Esempio di un oggetto JSON valido

Ecco un esempio completamente valido:

json


{
  "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 di metafield e i tuoi namespace. Imposta le opzioni hide_* su true o false in base alle tue preferenze.