Bepalen welke productmetavelden  Shoply mag gebruiken

Je AI-shoppingassistent is ontworpen om klanten te helpen door je productinformatie te lezen, vragen te beantwoorden en aanbevelingen te doen.

Maar niet alle productgegevens zijn bedoeld voor klanten. Sommige productmetavelden  kunnen interne informatie bevatten (zoals winstmarges), gegevens over leveranciers of andere kenmerken die privé moeten blijven. In zulke gevallen wil je misschien niet dat Shoply die metavelden gebruikt bij het beantwoorden van vragen van klanten.

Shoply gebruikt AI om automatisch te bepalen welke metavelden kunnen worden gebruikt bij het beantwoorden van vragen van klanten. Om je volledige controle te geven, kun je met Shoply specifieke productmetavelden of volledige metaveldenamespaces op de zwarte lijst (uitsluiten) zetten.

In deze handleiding lees je waarom dit handig is en hoe je dit configureert.

Waar vind je de geavanceerde instellingen?

Ga naar het gedeelte “Settings” in de beheerconsole van de app en scrol vervolgens omlaag naar het gedeelte “Advanced Settings”. In dit gedeelte kun je een JSON-object  opgeven om verschillende instellingen te configureren.

Instellingen voor de zwarte lijst

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

blacklist_product_fields

Een lijst met exacte metaveldenamen (veldnamen) die je wilt uitsluiten. De veldnaam moet exact overeenkomen met de sleutel van het metaveld zoals die in Shopify wordt weergegeven.

Voorbeelden van metaveldenamen:

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

Let op: als je de leverancier van het product niet wilt tonen, moet je brand aan de zwarte lijst toevoegen, omdat Shoply het metaveld brand om historische redenen gebruikt om leveranciersinformatie op te slaan.

blacklist_display_filters

Een lijst met exacte metaveldenamen die alleen in de filter-/facetinterface verborgen moeten worden. In tegenstelling tot blacklist_product_fields zijn deze velden nog steeds beschikbaar voor de AI om vragen van klanten te beantwoorden — ze worden alleen niet als selecteerbare filters in de zoekinterface weergegeven.

Dit is handig wanneer een metaveld waardevolle productinformatie bevat die de AI moet kennen, maar die geen zinvolle filter voor klanten is.

Voorbeeld:

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

blacklist_namespaces

Een lijst met volledige namespaces  die de AI moet negeren.

Voorbeeld:

• RenterInfo

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

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

Tips voor de zwarte lijst

Aanbevolen om op de zwarte lijst te zetten:

• Leverancierscodes
• Gegevens over magazijn / voorraad
• Interne opmerkingen over orderverwerking
• Metavelden die door andere apps worden gebruikt
• Elk veld dat niet zichtbaar mag zijn voor klanten

Zet velden zoals deze liever niet op de zwarte lijst:

• Producttitel
• Beschrijving
• Materiaal
• Maat, afmetingen of specificaties
• Ingrediënten
• Onderhoudsinstructies
• Namen/opties van varianten

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

Productgegevens verrijken met 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 tekenreeksen en kunnen niet als gestructureerde filters worden gebruikt. Met deze instelling kun je tags in de vorm key:value omzetten in echte metavelden die Shoply kan indexeren en voor filtering kan gebruiken.

Zo werkt het:

Stel split_tag_to_metafield_by in op het scheidingsteken dat in je tags wordt gebruikt. Shoply splitst elke tag bij dat teken, behandelt de linkerkant als de metaveldsleutel en de rechterkant als de waarde, en indexeert ze overeenkomstig.

Als je producten bijvoorbeeld tags hebben zoals:

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

Dan levert het instellen van het scheidingsteken op ":" de volgende metavelden op:

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

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

Voorbeeldconfiguratie:

{
  "split_tag_to_metafield_by": ":"
}

Wanneer gebruik je dit:

• Je winkel gebruikt al key:value-tags voor kenmerken (bijvoorbeeld uit een bulkimport of een app van derden)
• Je wilt filterbare kenmerken toevoegen zonder formele Shopify-metavelddefinities aan te maken
• Je hebt een snelle manier nodig om gestructureerde productgegevens aan Shoply beschikbaar te stellen zonder je catalogus opnieuw te taggen

Productweergave beheren

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

hide_discount

Als dit op true wordt ingesteld, worden kortingspercentages (bijvoorbeeld ‘-40%’) verborgen in productweergaven. Dit is handig als je kortingen niet wilt benadrukken bij klanten.

hide_price

Als dit op true wordt ingesteld, wordt alle prijsinformatie verborgen, inclusief oorspronkelijke en afgeprijsde prijzen. Gebruik dit als je liever wilt dat klanten naar de productpagina gaan om prijzen te bekijken, of als je prijsstrategie vereist dat prijzen in de chat-/zoekinterface verborgen blijven.

hide_review

Als dit op true wordt ingesteld, worden beoordelingsscores niet weergegeven bij producten. Dit is handig als je niet wilt dat beoordelingsscores de beslissingen van klanten in de chat-/zoekinterface beïnvloeden.

Voorbeeld van een geldig JSON-object

Hier volgt een volledig geldig voorbeeld:

{
  "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
}

Je kunt items verwijderen die je niet nodig hebt of je eigen metaveldenamen en namespaces toevoegen. Stel de opties hide_* in op true of false, afhankelijk van je voorkeuren.