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

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

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

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

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

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

アプリの管理コンソールの「Settings」セクションに移動し、下にスクロールして「Advanced Settings」セクションを開いてください。このセクションでは、各種設定を構成するための JSON オブジェクトを入力できます。

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

ブラックリスト設定

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

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

`blacklist_product_fields`

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

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

start_date
product_type
backstock_number
upc
shipping_lead_time
brand

注意: 商品の vendor を表示したくない場合は、ブラックリストに “brand” を追加する必要があります。これは、歴史的な理由により Shoply が vendor 情報の保存に 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

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

キー	値
`material`	`aluminum`
`color`	`matte-black`
`compatible-with`	`iPhone 15`

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

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

設定例:

json


{
  "split_tag_to_metafield_by": ":"
}

この機能を使う場面:

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

商品表示を制御する

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

残すフィールドの見た目を変更したい場合は、CSS を使って商品カードのスタイルをカスタマイズできます。

`hide_discount`

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

`hide_price`

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

`hide_review`

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

有効な JSON オブジェクトの例

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

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 に設定してください。

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

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

ブラックリスト設定

blacklist_product_fields

blacklist_display_filters

blacklist_namespaces