So steuern Sie, welche Produkt-Metafelder Shoply verwenden kann

How to Blacklist Product Metafields

Ihr AI Shopping Assistant wurde entwickelt, um Kundinnen und Kunden zu helfen, indem er Ihre Produktinformationen liest, Fragen beantwortet und Empfehlungen ausspricht.

Allerdings sind nicht alle Produktdaten für Kundinnen und Kunden bestimmt. Einige Produkt-Metafelder  können interne Informationen (wie z. B. die Gewinnmarge), Lieferantendetails oder andere Attribute enthalten, die privat bleiben sollten. In diesen Fällen möchten Sie möglicherweise, dass Shoply diese Metafelder bei der Beantwortung von Kundenfragen nicht verwendet.

Shoply verwendet KI, um automatisch zu bestimmen, welche Metafelder bei der Beantwortung von Kundenfragen verwendet werden können. Um Ihnen jedoch die volle Kontrolle zu geben, ermöglicht Shoply Ihnen, bestimmte Produkt-Metafelder oder ganze Metafeld-Namespaces auf die Blacklist (ausschließen) zu setzen.

In diesem Leitfaden wird erklärt, warum das nützlich ist und wie Sie es konfigurieren.

Wo finde ich die erweiterten Einstellungen?

Gehen Sie zum Bereich „Settings“ in der Admin-Konsole der App und scrollen Sie dann nach unten zum Abschnitt „Advanced Settings“. In diesem Abschnitt können Sie ein JSON-Objekt  angeben, um verschiedene Einstellungen zu konfigurieren.

Für die allgemeine Datenrichtlinie lesen Sie welche Informationen Shoply verwenden kann.

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.
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.

Blacklist-Einstellungen

Verwenden Sie diese Einstellungen, um zu verhindern, dass Shoply bestimmte Produkt-Metafelder bei der Beantwortung von Kundenfragen verwendet.

Um ein ganzes Element statt einzelner Felder auszublenden, können Sie ganze Produkte von der Indexierung ausschließen.

blacklist_product_fields

Eine Liste mit exakten Metafeld-Schlüsseln (Feldnamen), die Sie ausschließen möchten. Der Feldname muss genau mit dem Schlüssel des Metafelds übereinstimmen, wie er in Shopify erscheint.

Beispiele für Metafeld-Schlüssel:

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

Hinweis: Wenn Sie den Anbieter des Produkts nicht anzeigen möchten, müssen Sie „brand“ zur Blacklist hinzufügen, da Shoply aus Legacy-Gründen das Metafeld brand verwendet, um Anbieterinformationen zu speichern.

blacklist_display_filters

Eine Liste mit exakten Metafeld-Schlüsseln, die nur in der Filter-/Facet-UI ausgeblendet werden sollen. Im Gegensatz zu blacklist_product_fields stehen diese Felder der KI weiterhin zur Verfügung, um Kundenfragen zu beantworten — sie werden in der Suchoberfläche nur nicht als auswählbare Filter angezeigt.

Hintergrundinformationen dazu, welche Attribute erscheinen, finden Sie unter wie Shoply Produktfilter generiert.

Das ist nützlich, wenn ein Metafeld wertvolle Produktinformationen enthält, die die KI kennen sollte, die aber als kundenorientierter Filter keinen Sinn ergeben.

Beispiel:

  • warehouse_region — hilfreicher Kontext für die KI, aber kein nützlicher Filter für Kundinnen und Kunden
  • care_instructions — gut für KI-Antworten, aber keine sinnvolle Filterkategorie

blacklist_namespaces

Eine Liste ganzer Namespaces , die die KI ignorieren soll.

Beispiel:

  • RenterInfo

Wenn ein Metafeld zu einem Namespace auf der Blacklist gehört, werden alle Felder in diesem Namespace automatisch ausgeschlossen.

Das ist nützlich, wenn ein ganzer Namespace intern oder sensibel ist.

Tipps für die Blacklist

Empfohlen für die Blacklist:

  • Lieferantencodes
  • Lager-/Bestandsdetails
  • Interne Fulfillment-Hinweise
  • Metafelder, die von anderen Apps verwendet werden
  • Jedes Feld, das für Kundinnen und Kunden nicht sichtbar sein sollte

Vermeiden Sie es, Felder wie diese auf die Blacklist zu setzen:

  • Produkttitel
  • Beschreibung
  • Material
  • Größe, Abmessungen oder Spezifikationen
  • Inhaltsstoffe
  • Pflegehinweise
  • Variantennamen/-optionen

(Diese helfen der KI, bessere Antworten zu geben.)

Produktdaten aus Tags anreichern

split_tag_to_metafield_by

Shopify-Tags sind eine praktische Möglichkeit, Produkte zu kennzeichnen, werden jedoch als flache Liste von Zeichenfolgen gespeichert und können nicht als strukturierte Filter verwendet werden. Mit dieser Einstellung können Sie Tags im Stil key:value in richtige Metafelder umwandeln, die Shoply indexieren und für das Filtern verwenden kann.

So funktioniert es:

Setzen Sie split_tag_to_metafield_by auf das Trennzeichen, das in Ihren Tags verwendet wird. Shoply teilt dann jedes Tag an diesem Zeichen, behandelt die linke Seite als Metafeld-Schlüssel und die rechte Seite als Wert und indexiert sie entsprechend.

Wenn Ihre Produkte zum Beispiel Tags wie diese haben:

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

Wenn Sie das Trennzeichen auf ":" setzen, entstehen daraus folgende Metafelder:

SchlüsselWert
materialaluminum
colormatte-black
compatible-withiPhone 15

Diese indexierten Metafelder können dann als Facet-Filter in Shoply AI Search verwendet werden — genau wie native Shopify-Metafelder.

Tags, die das Trennzeichen nicht enthalten, werden von dieser Einstellung ignoriert und bleiben normale Tags.

Beispielkonfiguration:

json
{ "split_tag_to_metafield_by": ":" }

Wann Sie dies verwenden sollten:

  • Ihr Shop verwendet bereits key:value-Tags für Attribute (z. B. aus einem Massenimport oder einer Drittanbieter-App)
  • Sie möchten filterbare Attribute hinzufügen, ohne formale Shopify-Metafeld-Definitionen zu erstellen
  • Sie benötigen eine schnelle Möglichkeit, strukturierte Produktdaten für Shoply bereitzustellen, ohne Ihren Katalog neu zu taggen

Produktanzeige steuern

Verwenden Sie diese Einstellungen, um zu steuern, welche Informationen angezeigt werden, wenn Produkte im Chat oder in der Suchoberfläche dargestellt werden.

Für visuelle Änderungen an den Feldern, die Sie beibehalten, können Sie das Styling von Produktkarten anpassen mit CSS.

hide_discount

Wenn dies auf true gesetzt ist, werden Rabattprozentsätze (z. B. „-40%“) in Produktanzeigen ausgeblendet. Das ist nützlich, wenn Sie Rabatte gegenüber Kundinnen und Kunden nicht hervorheben möchten.

hide_price

Wenn dies auf true gesetzt ist, werden alle Preisinformationen ausgeblendet, einschließlich Originalpreisen und reduzierten Preisen. Verwenden Sie dies, wenn Sie möchten, dass Kundinnen und Kunden die Produktseite besuchen, um Preise zu sehen, oder wenn Ihre Preisstrategie das Ausblenden von Preisen in der Chat-/Suchoberfläche erfordert.

hide_review

Wenn dies auf true gesetzt ist, werden Bewertungssterne in Produktanzeigen nicht angezeigt. Das ist nützlich, wenn Sie nicht möchten, dass Bewertungsnoten Kundenentscheidungen in der Chat-/Suchoberfläche beeinflussen.

Beispiel für ein gültiges JSON-Objekt

Hier ist ein vollständig gültiges Beispiel:

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 }

Sie können Elemente entfernen, die Sie nicht benötigen, oder eigene Metafeld-Schlüssel und Namespaces hinzufügen. Setzen Sie die Optionen hide_* je nach Ihren Präferenzen auf true oder false.