Shoply が使用できる商品メタフィールドを制御する方法

AI Shopping Assistant は、商品情報を読み取り、質問に回答し、レコメンドを行うことで、お客様をサポートするように設計されています。

ただし、すべての商品データがお客様向けとは限りません。商品メタフィールドの中には、社内情報（利益率など）、仕入先の詳細、または非公開のままにしておくべきその他の属性が含まれている場合があります。そのような場合、顧客からの質問に回答する際に Shoply がそれらのメタフィールドを使用しないようにしたいことがあります。

Shoply は AI を使用して、顧客からの質問に回答する際にどのメタフィールドを使用できるかを自動的に判断します。ただし、完全にコントロールできるように、Shoply では特定の商品メタフィールドまたはメタフィールドの名前空間全体を ブラックリスト（除外） に設定できます。

このガイドでは、これがなぜ役立つのか、そしてどのように設定するかを説明します。

Advanced Settings はどこにありますか？

アプリの管理コンソールの「Settings」セクションに移動し、「Advanced Settings」セクションまでスクロールしてください。このセクションでは、さまざまな設定を構成するために JSON object を指定できます。

より広範なデータポリシーについては、Shoply が使用できる情報をご確認ください。

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.

ブラックリスト設定

これらの設定を使用すると、顧客からの質問に回答する際に Shoply が特定の商品メタフィールドを使用しないようにできます。

個々のフィールドではなく商品全体を非表示にしたい場合は、インデックス対象から商品全体を除外してください。

`blacklist_product_fields`

除外したい 正確なメタフィールドキー（フィールド名）の一覧です。フィールド名は、Shopify 内に表示されるメタフィールドのキーと完全に一致している必要があります。

メタフィールドキーの例：

start_date
product_type
backstock_number
upc
shipping_lead_time
brand

注意: 商品のベンダーを表示したくない場合は、ブラックリストに “brand” を追加する必要があります。これは、歴史的な理由により Shoply がベンダー情報の保存に brand メタフィールドを使用しているためです。

`blacklist_display_filters`

フィルター／ファセット UI にのみ表示しない 正確なメタフィールドキー の一覧です。blacklist_product_fields とは異なり、これらのフィールドは 引き続き AI が利用可能 であり、顧客からの質問への回答に使用されます。ただし、検索インターフェースでは選択可能なフィルターとして表示されません。

どの属性が表示されるかの背景については、Shoply が商品フィルターを生成する方法をご覧ください。

これは、メタフィールドに AI が知っておくべき価値ある商品情報が含まれている一方で、お客様向けのフィルターとしては適していない場合に便利です。

例：

warehouse_region — AI にとっては有用な文脈情報ですが、お客様にとって有用なフィルターではありません
care_instructions — AI の回答には適していますが、意味のあるフィルターカテゴリではありません

`blacklist_namespaces`

AI に無視させたい 名前空間全体の一覧 です。namespaces

例：

RenterInfo

メタフィールドがブラックリストに登録された名前空間に属している場合、その名前空間内のすべてのフィールド が自動的に除外されます。

これは、名前空間全体が社内用または機密性の高いものである場合に便利です。

ブラックリスト設定のヒント

ブラックリスト登録を推奨：

仕入先コード
倉庫／在庫の詳細
社内のフルフィルメントメモ
他のアプリで使用されるメタフィールド
お客様に見せるべきではないあらゆるフィールド

次のようなフィールドはブラックリスト登録を避けてください：

商品タイトル
説明文
素材
サイズ、寸法、仕様
成分
お手入れ方法
バリエーション名／オプション

（これらは AI がより良い回答をするのに役立ちます。）

タグから商品データを拡充する

`split_tag_to_metafield_by`

Shopify タグは商品にラベルを付ける便利な方法ですが、フラットな文字列の一覧として保存されるため、構造化されたフィルターとしては使えません。この設定を使うと、key:value 形式のタグを、Shoply がインデックス化してフィルタリングに利用できる適切なメタフィールドへ変換できます。

仕組み：

split_tag_to_metafield_by に、タグ内で使われている区切り文字を設定します。Shoply は各タグをその文字で分割し、左側をメタフィールドキー、右側を値として扱い、それに応じてインデックス化します。

たとえば、商品に次のようなタグがある場合：

plaintext


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

区切り文字を ":" に設定すると、次のメタフィールドが生成されます：

Key	Value
`material`	`aluminum`
`color`	`matte-black`
`compatible-with`	`iPhone 15`

これらのインデックス化されたメタフィールドは、その後 Shoply AI Search でファセットフィルターとして使用できます。ネイティブの Shopify メタフィールドと同様です。

区切り文字を含まないタグは、この設定では無視され、通常のタグのまま残ります。

設定例：

json


{
  "split_tag_to_metafield_by": ":"
}

この設定を使う場面：

ストアですでに属性用の key:value タグを使用している場合（例：一括インポートやサードパーティ製アプリから）
正式な Shopify メタフィールド定義を作成せずに、フィルター可能な属性を追加したい場合
カタログにタグを付け直すことなく、構造化された商品データをすばやく Shoply に公開したい場合

商品表示を制御する

これらの設定を使うと、チャットまたは検索インターフェースで商品が表示される際に、どの情報を表示するかを制御できます。

残すフィールドの見た目を変更したい場合は、CSS で product-card styling をカスタマイズできます。

`hide_discount`

true に設定すると、割引率（例: “-40%“）が商品表示から非表示になります。お客様に割引を強調したくない場合に便利です。

`hide_price`

true に設定すると、すべての価格情報 が非表示になります。これには通常価格と割引価格の両方が含まれます。価格を確認するためにお客様を商品ページへ誘導したい場合や、チャット／検索インターフェースで価格を非表示にする必要がある価格戦略を採用している場合に使用してください。

`hide_review`

true に設定すると、商品表示にレビュー評価が表示されなくなります。チャット／検索インターフェースでレビューのスコアが顧客の判断に影響するのを避けたい場合に便利です。

有効な JSON object の例

以下は、完全に有効な例です：

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
}

不要な項目は削除したり、独自のメタフィールドキーや名前空間を追加したりできます。hide_* オプションは、設定したい内容に応じて true または false にしてください。