Hoe u kunt bepalen welke productmetavelden Shoply mag gebruiken

Uw AI Shopping Assistant is ontworpen om klanten te helpen door uw productinformatie te lezen, vragen te beantwoorden en aanbevelingen te doen.

Niet alle productgegevens zijn echter bedoeld voor klanten. Sommige productmetavelden kunnen interne informatie bevatten (zoals winstmarge), leveranciersgegevens of andere kenmerken die privé moeten blijven. In deze gevallen geeft u er mogelijk de voorkeur aan dat Shoply deze metavelden niet gebruikt bij het beantwoorden van klantvragen.

Shoply gebruikt AI om automatisch te bepalen welke metavelden kunnen worden gebruikt bij het beantwoorden van klantvragen. Om u volledige controle te geven, stelt Shoply u echter in staat om specifieke productmetavelden of volledige metaveld-namespaces op een zwarte lijst (uitsluiten) te zetten.

Deze handleiding legt uit waarom dit nuttig is en hoe u dit configureert.

Waar vindt u Geavanceerde instellingen?

Ga naar het gedeelte “Settings” van de beheerdersconsole van de app en scroll vervolgens omlaag naar het gedeelte “Advanced Settings”. In dit gedeelte kunt u een JSON-object opgeven om verschillende instellingen te configureren.

Voor het bredere databeleid kunt u bekijken welke informatie Shoply kan gebruiken.

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.

Zwarte-lijstinstellingen

Gebruik deze instellingen om te voorkomen dat Shoply specifieke productmetavelden gebruikt bij het beantwoorden van klantvragen.

Om een volledig item te verbergen in plaats van afzonderlijke velden, kunt u volledige producten uitsluiten van indexering.

`blacklist_product_fields`

Een lijst met exacte metafield-sleutels (veldnamen) die u wilt uitsluiten. De veldnaam moet exact overeenkomen met de sleutel van het metavelden zoals deze in Shopify wordt weergegeven.

Voorbeelden van metafield-sleutels:

start_date
product_type
backstock_number
upc
shipping_lead_time
brand

Opmerking: als u de leverancier van het product niet wilt tonen, moet u “brand” aan de zwarte lijst toevoegen, omdat Shoply om legacy-redenen het metaveld brand gebruikt om leveranciersinformatie op te slaan.

`blacklist_display_filters`

Een lijst met exacte metafield-sleutels die alleen verborgen moeten worden in de filter-/facet-UI. In tegenstelling tot blacklist_product_fields blijven deze velden nog steeds beschikbaar voor de AI om klantvragen te beantwoorden — ze worden alleen niet getoond als selecteerbare filters in de zoekinterface.

Voor achtergrondinformatie over welke attributen worden weergegeven, zie hoe Shoply productfilters genereert.

Dit is nuttig wanneer een metaveld waardevolle productinformatie bevat die de AI zou moeten kennen, maar niet logisch is als klantgericht filter.

Voorbeeld:

warehouse_region — nuttige context voor de AI, maar geen bruikbaar filter voor klanten
care_instructions — goed voor AI-antwoorden, maar geen betekenisvolle filtercategorie

`blacklist_namespaces`

Een lijst met volledige namespaces die u door de AI wilt laten negeren.

Voorbeeld:

RenterInfo

Als een metaveld tot een namespace op de zwarte lijst behoort, worden alle velden in die namespace automatisch uitgesloten.

Dit is nuttig wanneer een volledige namespace intern of gevoelig is.

Tips voor het gebruik van de zwarte lijst

Aanbevolen om op de zwarte lijst te zetten:

Leverancierscodes
Magazijn- / voorraaddetails
Interne fulfilmentnotities
Metavelden die door andere apps worden gebruikt
Elk veld dat niet zichtbaar zou moeten zijn voor klanten

Vermijd het op de zwarte lijst zetten van velden zoals:

Producttitel
Beschrijving
Materiaal
Maat, afmetingen of specificaties
Ingrediënten
Onderhoudsinstructies
Variantnamen/-opties

(Deze helpen de AI om betere antwoorden te geven.)

Productgegevens verrijken vanuit tags

`split_tag_to_metafield_by`

Shopify-tags zijn een handige manier om producten te labelen, maar ze worden opgeslagen als een platte lijst met strings en kunnen niet worden gebruikt als gestructureerde filters. Met deze instelling kunt u tags in de stijl key:value omzetten in echte metavelden die Shoply kan indexeren en gebruiken voor filtering.

Hoe het werkt:

Stel split_tag_to_metafield_by in op het scheidingsteken dat in uw tags wordt gebruikt. Shoply splitst elke tag op dat teken, behandelt de linkerkant als de metaveld-sleutel en de rechterkant als de waarde, en indexeert ze dienovereenkomstig.

Als uw producten bijvoorbeeld tags hebben zoals:

plaintext


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

Als u het scheidingsteken instelt op ":", worden de volgende metavelden gemaakt:

Sleutel	Waarde
`material`	`aluminum`
`color`	`matte-black`
`compatible-with`	`iPhone 15`

Deze geïndexeerde metavelden kunnen vervolgens worden gebruikt als facetfilters in Shoply AI Search — net als native Shopify-metavelden.

Tags die het scheidingsteken niet bevatten, worden door deze instelling genegeerd en blijven gewone tags.

Voorbeeldconfiguratie:

json


{
  "split_tag_to_metafield_by": ":"
}

Wanneer u dit moet gebruiken:

Uw winkel gebruikt al tags in de vorm key:value voor attributen (bijvoorbeeld vanuit een bulkimport of een app van derden)
U wilt filterbare attributen toevoegen zonder formele Shopify-metavelddefinities aan te maken
U hebt een snelle manier nodig om gestructureerde productgegevens beschikbaar te maken voor Shoply zonder uw catalogus opnieuw te taggen

Productweergave beheren

Gebruik deze instellingen om te bepalen welke informatie wordt getoond wanneer producten worden weergegeven in de chat- of zoekinterface.

Voor visuele wijzigingen aan de velden die u behoudt, kunt u de styling van productkaarten aanpassen met CSS.

`hide_discount`

Wanneer ingesteld op true, worden kortingspercentages (bijvoorbeeld “-40%”) verborgen in productweergaven. Dit is nuttig als u kortingen niet wilt benadrukken richting klanten.

`hide_price`

Wanneer ingesteld op true, wordt alle prijsinformatie verborgen, inclusief oorspronkelijke prijzen en kortingsprijzen. Gebruik dit als u liever hebt dat klanten de productpagina bezoeken om prijzen te zien, of als uw prijsstrategie vereist dat prijzen in de chat-/zoekinterface verborgen blijven.

`hide_review`

Wanneer ingesteld op true, worden reviewbeoordelingen niet getoond in productweergaven. Dit is nuttig als u niet wilt dat reviewscores klantbeslissingen beïnvloeden in de chat-/zoekinterface.

Voorbeeld van een geldig JSON-object

Hier is een volledig geldig voorbeeld:

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
}

U kunt items verwijderen die u niet nodig hebt, of uw eigen metafield-sleutels en namespaces toevoegen. Stel de opties hide_* in op true of false, afhankelijk van uw voorkeuren.