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

AIショッピングアシスタントは、商品情報を読み取り、質問に答え、おすすめを提案することで、顧客を支援するよう設計されています。

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

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

このガイドでは、これが役立つ理由と設定方法を説明します。

Advanced Settingsの場所

アプリの管理コンソールで「Settings」セクションを開き、「Advanced Settings」セクションまでスクロールします。このセクションでは、さまざまな設定を構成するためのa JSON object を入力できます。

ブラックリスト設定

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

`blacklist_product_fields`

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

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

start_date
product_type
backstock_number
upc
shipping_lead_time
brand

注：商品のベンダーを表示したくない場合は、Shoplyが従来の理由でベンダー情報をbrandメタフィールドに保存しているため、ブラックリストに「brand」を追加する必要があります。

`blacklist_display_filters`

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

これは、AIが把握しておくべき有用な商品情報をメタフィールドに含めつつ、顧客向けのフィルターとしては適切でない場合に便利です。

例：

warehouse_region — AIにとって役立つ文脈ですが、顧客にとって便利なフィルターではありません
care_instructions — AIの回答には有用ですが、意味のあるフィルターカテゴリではありません

`blacklist_namespaces`

AIに無視させたい、名前空間全体のリストです。

例：

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で利用できるようにする手早い方法が必要な場合

商品表示を制御する

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

`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