> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Kameleoon Search 機能を有効にする
> Kameleoon Instant Search および Full Search を設定して、タイプミス耐性、同義語、カスタムランキングを備えた機械学習駆動のパーソナライズされた検索結果を提供します。
Kameleoon Search は、機械学習を使用して結果をパーソナライズし、商品レコメンデーションを提供する強力な検索ソリューションです。
各訪問者に最も適合する商品を提供して検索結果をパーソナライズします。Kameleoon Search には 2 つの主要な機能があります。
* **Kameleoon Instant Search** は、超高速の検索速度から直感的なカテゴリナビゲーションまで、クラス最高のユーザーエクスペリエンスを提供します。ドロップダウン検索ボックスに埋め込まれたカスタマイズされたルールで、あらゆる検索結果をブーストします。
* **Kameleoon Full Search** は、強力なフィルタリング機能と事前構築されたファセットオプションで、ユーザーが商品を発見するのを助けます。
Kameleoon Search は、訪問者の行動を使用して、現在の訪問者に最も関連性のある商品をブーストします。Kameleoon Search はまた、価格マージンや季節性を使用して、最も収益性の高い商品や需要のある商品をブーストします。
## Kameleoon Search 用のフィードを設定する
Kameleoon Search 機能を有効にするには、商品フィードにいくつかの追加の商品プロパティを含める必要があります。
* Kameleoon Instant Search は、カタログフィードから次の情報を使用します。
* 要素: **`yml_catalog` > `shop` > `offers` > `offer`**:
* （必須）商品の `name`、`picture`、`url`、`price`
* （オプション）`barcode`: ユーザーが商品 SKU で検索できるようにします。
* （オプション）`typePrefix`: 販売する商品に関する追加の定義テキストを追加します。例えば「a bike for mountain biking」。Kameleoon によってより正確な検索結果を提供するために使用されます。
* （オプション）`vendor` または `vendorCode`: ユーザーが製造業者で検索できるようにします。
* （オプション）`model`: ユーザーが商品モデルで検索できるようにします。
* （オプション）`tags`: 商品フィードに最大 5 つのタグを追加して、ユーザーがキーワードで商品を見つけられるようにします。
* 要素: **`yml_catalog` > `shop` > `categories`**:
* （必須）各カテゴリの `name` と `url`。商品を検索する際に Instant search ポップインで商品カテゴリを提案するために使用されます。
* 結果リスティングページでファセットとフィルタリングを提供する Kameleoon Full Search 機能を使用したい場合、カタログフィードからの以下のデータも必要です。デフォルトでは、Kameleoon はカテゴリとブランドをデフォルトフィルタとして追加します。
* 要素: **`yml_catalog` > `shop` > `offers` > `offer`**:
* （オプション）`param`: フィルタリングオプションとして使用する商品属性（例：サイズ、色）を含みます。
* （オプション）`price_margin`: 返される結果で最高のマージンを持つ商品をブーストするために使用します。
* （オプション）`locations`: 訪問者の場所では利用できない商品をフィルタリングします。
Kameleoon 検索エンジンは複数の言語をサポートします。語幹アルゴリズム（または「ステマー」）を使用して、語根の形態的バリアントを生成します。例えば、ユーザーがウェブサイトで「chocolate」を検索した場合、「chocolates」、「chocolatey」、または「choco」という単語を含むアイテムが語根の「chocolate」に自動的にリンクされ、結果に含まれます。
### Kameleoon Instant Search の技術的実装
Kameleoon Instant Search を統合するには、ソースコードの既存の検索要素に HTML クラス `KameleoonProducts-instant-search` を追加します（下記の例を参照）。
``
Kameleoon 検索エンジンと競合しないように、現在の検索エンジンを無効にする必要があります。
ドロップダウン検索ボックスが表示するデフォルトテンプレートのスタイルシートと情報をカスタマイズできます。
#### クエリ提案
クエリ提案は、結果を返すことが保証されているクエリをユーザーが見つけるのに役立ちます。Kameleoon は、ユーザーが検索バーにクエリを入力する際に、ドロップダウン検索ボックスでユーザーが選択できる可能性のあるクエリのリストを自動的に表示します。
例えば、「sneakers」という単語を入力し始めると、ユーザーは「sneakers asics」や「sneakers nike」など、より具体的な結果を取得するためのより正確なクエリを選択する提案を受け取る可能性があります。Kameleoon は各キーストロークの後にクエリ提案を更新するため、ユーザーは完全なクエリを入力する必要はありません。クエリ提案は商品カテゴリまたは代替クエリにすることができます。
**Search** > **Settings** ページでカテゴリと提案の数をカスタマイズできます。
* **Input > Enable last queries**: ユーザーが検索バーをクリックしたときに、ユーザーの以前の検索からの提案を表示します。
* **Input > Recent searches**: 前の検索クエリの後に閲覧された商品を表示します。
* **Instant search > Categories limit**: 検索クエリに対する提案カテゴリの最大数。
* **Common Settings > Category nesting level:** 表示したいカテゴリレベルを設定します。例えば、3 つのカテゴリレベル（Men > Sneakers > Running）があり、最後のカテゴリレベル（Running）のみを検索ボックスに表示したい場合は、値「3」を入力します。
* **Instant search > Brands limit**: 検索クエリに対する提案ブランドの最大数。
* **Suggestions > Suggestions limit**: 検索クエリに対する提案クエリの最大数。
* **Instant search > Instant search products limit**: 返される商品の最大数（0 から 10）。
#### ドロップダウン検索ボックスのデザイン
Kameleoon を使用すると、ドロップダウン検索ボックスの外観を完全にカスタマイズできます。
* **メインコンポーネント要素のタイトル**: **Search** > **Settings** ページの **Instant search widget titles** セクションで値を設定できます。
* **検索結果に表示される商品情報**: **Search** > **Template instant search** ページでテンプレートを設定できます。このテンプレートは [Liquid Markup](http://liquidmarkup.org/) をサポートします。右側で利用可能なすべてのフィールドを使用して、検索ボックスをカスタマイズできます。
* **テンプレートのスタイルシート**: **Search** > **theme editor** ページでブロックをデザインします。使いやすい基本エディタと強力な CSS エディタのどちらかを選択できます。
### Kameleoon Full Search の技術的実装
**検索結果リスティング:**
``
**ファセットとフィルタ:**
``
ウェブサイトの既存のブロックに上記のクラス名を追加できます。
商品ブロック内でさまざまな利用可能なパラメータを組み込むことで、結果リスティングのカスタマイズを強化できます。
* `data-search-limit`: このパラメータは、取得する商品の数を決定します。
* `data-search-offset`: このパラメータは、データセット内の商品の位置を指定します。これを指定することで、指定されたオフセット値から始まる商品のサブセットを取得できます。通常、オフセットは `data-search-limit` と組み合わせて使用され、特定のオフセットから取得する商品数を定義します。
* `data-search-category-names`: レコメンデーション結果からカテゴリ ID の配列を含めることができます。
* `data-search-callback`: このパラメータは、レコメンデーションデータが返されると実行されるコールバック関数です。
* `data-search-error`: エラーが発生したときに実行されるコールバック関数。
* `data-search-sort-by`: このパラメータを使用すると、人気、価格、割引、販売率、または日付などのさまざまな基準で並べ替えることができます。
* `data-search-order`: 並べ替え方向を昇順（`asc`）またはデフォルトの降順（`desc`）として指定できます。
* `data-search-locations`: レコメンデーション結果から場所 ID の配列を含めます。
* `data-search-price-min`: 特定の最低価格範囲内の商品をリクエストします。
* `data-search-price-max`: 特定の最高価格範囲内の商品をリクエストします。
* `data-search-filters`: このパラメータは、フィルタパラメータを含むエスケープされた JSON 文字列を受け取ります。例えば、Bluetooth 互換性や重量などの基準に基づいて商品をフィルタリングするために使用できます。例: `{"bluetooth":\["yes"],"weight":["1.6"]}`。
### Full search のデザイン
次の手順に従って、検索リスティングページのデフォルトテンプレートとデザインをカスタマイズできます。
* **検索リスティングページに表示される商品情報**: **Search** > **Template full search** ページでテンプレートを設定できます。このテンプレートは [Liquid Markup](http://liquidmarkup.org/) をサポートします。右側で利用可能なすべてのフィールドを使用して、検索ボックスをカスタマイズできます。
* **テンプレートのスタイルシート**: **Search** > **Theme editor** ページでブロックをデザインします。使いやすい基本エディタと強力な CSS エディタのどちらかを選択できます。
## 高度な設定で検索結果を最適化する
Kameleoon は、検索エンジンがどのように機能し、商品を返すかを制御するための多くの組み込み設定を提供します。これらの設定はそのまま利用可能で、チームからの追加の開発は必要ありません。
検索結果を最適化するのに特に役立つ機能のレビューは次のとおりです。
### タイプミス耐性
Kameleoon はタイプミス耐性を提供します。これは、ユーザーがスペルを間違えても、探している商品を見つけることができることを意味します。検索エンジンがどの程度タイプミスに寛容であるかを設定できます。
[Levenshtein 距離](https://en.wikipedia.org/wiki/Levenshtein_distance)に基づいて、Kameleoon では、検索リクエストの入力中に修正される可能性のあるタイプミスの数を選択できます。タイプミス耐性はデフォルトでオンになっています。**Search** > **Settings** タブの **Input** セクションで、タイプミス耐性の動作を変更できます。
**Auto** モードでは、Kameleoon は検索長を考慮して修正できるタイプミスの数を識別しますが、2 つのタイプミスを超えることはできません。タイプミスの修正を無効にするには、値 0 を選択します。
### 検索関連性
デフォルトでは、Kameleoon は単一単語クエリと複数単語クエリを異なる方法で扱います。複数単語クエリがある場合、各単語は別々のユニークなキーとみなされます。例えば、ユーザーが「winter shoes」というクエリを入力した場合、Kameleoon は最初に「winter shoes」を含むすべての商品を返し、続いて「winter」と「shoes」の属性を持つ商品を返します。夏期に店舗に冬の靴の在庫がない場合、結果には完全に異なる商品が含まれる可能性があり、その一部は無関係であるかもしれません。
Qualifying search オプションを有効化して「winter shoes」を検索すると、「winter shoes」とラベル付けされた商品のみが返され、他には何も返されません。夏期にはランダムな靴の代わりに、空の結果が返されます。
デフォルトの動作を変更し、複数単語クエリを単一単語クエリと同様に動作させるには、**Search** > **Settings tab** の **Admin** エリアセクションで「Qualifying search」オプションを **on** に切り替えます。
### 同義語
同義語は、同等とみなされるべき単語について検索エンジンに伝えます（例：jacket は coat と parka の両方の同義語です）。**Search** > **Synonyms** ページで同義語を指定できます。通常、結果がほとんど返されないか、まったく返されないクエリに対して同義語ルールを設定する必要があります。
Kameleoon は組み込みの同義語辞書を提供しません。同義語は非常にユースケースに依存するためです。ただし、Kameleoon は **Search** > **Statistics** ページの **Failed search queries** で結果のないクエリを表示することで、同義語を見つけるのに役立ちます。同義語列の **+** をクリックし、同義語ルールを設定して失敗した検索の解決に役立てます。**query aliases** を作成するときに同義語を定義することもできます。
### ストップワード
「the」、「a」、「it」など不要な単語、または訪問者が使用するクエリで考慮されるべきではないと判断した任意の単語を削除できます。例えば、「some waterproof pants for motorcycle」というクエリの場合、クエリを実行する前に「some」と「for」という単語を無視し、代わりに「waterproof pants motorcycle」のみを検索したい場合があります。
**Search** > **Stop words** ページでストップワードを追加できます。**Search** > **Statistics** ページで人気のクエリを確認して、追加のストップワードを特定することもできます。**-**（削除）アイコンをクリックしてストップワードを削除します。
### Search boosts
特定の商品、商品カテゴリ、またはブランドをブーストして検索結果で上位に表示させることができます。これを行うには、**Search** > **Search boosts** ページからブーストクエリを作成します。
期間限定でブーストをスケジュールすることもできます。例えば、すべての Samsung テレビで 1 週間のプロモーションオファーを実行している場合、その週はユーザーが「TV」を検索するたびに、すべての Samsung テレビをブーストできます。**boost type value** フィールドに必要な数の値（商品、ブランド、またはカテゴリのリスト）を追加し、**boost** 値を増やすことで一部のブーストルールに高い優先度を与えることができます。
**entry type** フィールドを使用すると、ブーストルールをさらにカスタマイズできます。例えば、`sport shoes` のクエリに対するブーストを作成し、**full** オプションを選択した場合、ブーストはユーザーが `sport shoes` を検索した場合にのみ機能します。**partial** を選択すると、`sport` および `shoes` のクエリにも機能します。
### 検索リダイレクト
商品が特定のランディングページで宣伝されている場合、ユーザーをそれらのページにリダイレクトすると便利です。Kameleoon は、**Search** > **Search redirect** ページからリダイレクトルールを作成するために使用できる検索リダイレクト機能を提供します。CSV ファイルをアップロードして複数のエントリを追加することもできます。
### 検索結果で商品をランク付けするビジネスロジックの埋め込み
特定のビジネスニーズに従って商品のランキングをカスタマイズします。**Search** > **Settings** > **Common settings** セクションで次のオプションを有効化または変更します。
* **Sales rate:** 人気度に応じて、検索リスティングで商品を最低（0 から 50）から最高（50 から 100）にランク付けします。Kameleoon は、商品をランク付けするためにすべての訪問者の商品との相互作用（主に取引）を考慮します。ランキングで商品の人気度を無視するには、値を 50 に設定します。
**Settings** > **Store Settings** セクションで Kameleoon が使用するタイムフレームを設定します。
* **Price margin pressure:** このオプションは、フィードからの商品 `` タグを使用します。検索リスティングで商品を最低（0 から 50）から最高（50 から 100）にランク付けできます。デフォルト値は 50 に設定されており、フィード内の各商品の `price_margin` 値が考慮されないことを意味します。
* **Availability of stock:** 在庫の少ない商品を自動的に除外します。すべての在庫切れアイテムは検索結果から自動的に削除されます。
