Shoply AI で詳細設定を構成する方法

このページでは、Shoply AI 管理パネルの Advanced Settings JSON で構成できるさまざまな設定について説明します。

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

アプリの管理コンソールの「Settings」セクションに移動し、下にスクロールして「Advanced Settings」セクションを見つけます。このセクションでは、さまざまな設定を構成するために JSON オブジェクトを指定できます。

地理的なアクセスルールについては、国ごとにチャットボットの利用可否を制限する方法をご覧ください。

オプションスウォッチを無効にする

デフォルトでは、Shoply AI は検索結果およびチャット結果の商品の画像の下に視覚的なオプションスウォッチを表示します。これらのスウォッチは、異なる画像を持つ商品バリアント（例: 異なる色やパターン）に対して表示されます。スウォッチをクリックすると、表示される画像と価格がそのバリアントに合わせて更新されます。

オプションスウォッチを表示したくない場合は、Advanced Settings JSON に以下を追加してください。

json


{
  "disable_option_swatches": true
}

これにより、すべての検索結果およびチャット結果からスウォッチが非表示になり、商品にはデフォルトの画像と価格のみが表示されます。

複数倉庫を有効にする

ストアが複数の倉庫から出荷し、それぞれが異なる国や地域に対応している場合は、複数倉庫対応を有効にできます。有効にすると、商品の在庫可否は単一のグローバル在庫ステータスではなく、顧客の所在地を担当する倉庫にその商品の在庫があるかどうかによって判断されます。

Sports Basement の事例では、店舗レベル在庫の実運用を紹介しています。

デフォルトではこれは無効になっており、すべての顧客に対して所在地に関係なく同じ在庫状況が表示されます。

有効にするには、Advanced Settings JSON に以下を追加してください。

json


{
  "enable_multiple_warehouses": true
}

有効化すると、Shoply AI は特定の顧客に対して商品が在庫ありかどうかを判断する際に、該当する倉庫の在庫を確認します。

AI 関連性チェックを無効にして検索を高速化する

デフォルトでは、Shoply AI は検索結果に対して AI を活用した関連性チェックを行い、表示される商品が顧客のクエリに本当に関連していることを確認します。これにより結果の品質は向上しますが、検索応答にいくらかの遅延が加わります。

レイテンシガイドでは、検索速度と回答品質の間にあるトレードオフを説明しています。

検索結果の高速化を優先し、一部の結果が常に関連性を持つとは限らないことを許容できる場合は、このチェックを無効にできます。

json


{
  "disable_ai_relevance_check_in_search": true
}

これにより、AI による関連性フィルタリングのステップがスキップされ、検索応答が大幅に高速化されます。その代わり、返される商品の一部は検索クエリとの関連性がそれほど高くない可能性があります。

商品タグをインデックスする

デフォルトでは、Shoply AI は商品の Shopify タグをインデックスしません。タグは内部用途や運用用途（たとえば supplier-acme、black-friday-2024、do-not-restock）で使われることが多く、検索に含めるとノイズが増え、結果の関連性が下がるためです。

タグに複数の属性が含まれている場合は、商品タグを構造化フィールドに変換する方法をご覧ください。

一方で、タグが顧客が実際に検索する内容、たとえば素材、機能、用途、ブランド（例: waterproof、vegan、gift-for-her）を表している場合は、Advanced Settings JSON に以下を追加することで、それらを検索可能にできます。

json


{
  "index_tags": true
}

有効にすると、各商品のタグが検索可能なテキストに追加され、さらに Shoply AI が商品の embedding を構築する際にも含まれるため、顧客は検索とチャットの両方でタグ語句によって商品を見つけられるようになります。

これは次回カタログがインデックスされるときに適用されるため、既存の商品に反映されるまで少し時間を置くか、再インデックスを実行してください。タグが結果に影響するようになるため、顧客向けとして適切かどうかを事前に確認することをおすすめします。

チャット内の商品数を制限する

デフォルトでは、AI チャットボットが会話の中で商品をおすすめする際、1 回のおすすめごとに複数の商品を表示することがあります。1 回のチャットセッションの中で、AI は複数回の商品レコメンドを行う場合があります（たとえば、ランニングシューズを提案した後にソックスを提案するなど）。この設定は、1 回のおすすめごとに表示される商品数を制御します。

json


{
  "product_limit_in_chat": 3
}

たとえば上限を 3 にすると、会話の中で AI がシューズとソックスの両方をおすすめした場合、最大でシューズ 3 点、ソックス 3 点まで表示されます。この設定はチャット体験にのみ適用され、AI Search の結果には影響しません。上限が 4 未満に設定されている場合、商品フィルターも自動的に非表示になります。

検索フィルターを非表示にする

デフォルトでは、Shoply AI は商品結果の上にフィルターボタン（たとえば「Brand」「Price」「Color」）を表示し、顧客が表示内容を絞り込めるようにしています。これらはカタログから自動生成されます。

フィルターを削除する前に、自動生成されるフィルターの仕組みと、その元データが買い物客に表示される選択肢へどのように影響するかを確認してください。

フィルターバー全体を非表示にするには:

Shopify 管理画面で Shoply AI を開きます。
Customize AI Search に移動します。
Search filters の下で、Show filters in search results をオフにします。
Save をクリックします。

再びフィルターを表示するには、同じオプションをオンにして Save をクリックします。選択内容は保存され、ページを再読み込みした後も維持されます。

この操作は、既存の hide_filters オプションと同じ設定を更新します。すでに Advanced Settings JSON を使用している場合でも、その方法は引き続きサポートされています。

json


{
  "hide_filters": true
}

どちらの方法でも、AI Search とチャットの商品結果からフィルターコントロールが非表示になります。商品やおすすめ自体は引き続き表示されます。バーを非表示にしても、商品データが削除されたり、古い metafields がカタログから削除されたりすることはありません.